Skip to content

VoiceStudio is the open-source, fully-local ElevenLabs alternative — voice cloning, voice design, video dubbing, dictation, transcription & audiobook creation in 646 languages.

fix(brand): stop the waveform filling black in every icon

velixio0a9aacc8bb1d
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 23fb49421..c13f19e93 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -26,6 +26,7 @@ metadata and the backend fallback mirror it.
### Fixed
+- App icon, tray icons and in-app logo no longer show a black band behind the waveform (#PR)
- Bug reports no longer risk freezing the app while looking for your tools: the Node-version folder scan now runs off the main thread (#3180)
- Bug reports no longer freeze the app when the tool search or a drive stalls, and free disk is only borrowed from a parent folder when the install folder doesn't exist yet (#3179)
- Model licence dialog is wider and scrolls as one area with the buttons pinned, and follows macOS, Windows and Linux dialog conventions (#3160)
diff --git a/docs/branding.md b/docs/branding.md
index 7eb09e2b8..2c7439bfd 100644
--- a/docs/branding.md
+++ b/docs/branding.md
@@ -18,8 +18,14 @@ spark identifies creation. The product voice is clear, calm, and direct.
Regenerate every desktop icon from the canonical vector after changing the
mark:
-Export the canonical vector to the required PNG, ICO, and ICNS sizes under
-`electron/build/icons/`, then run the Electron packaging contract.
+```sh
+uv run scripts/render_brand_icons.py
+```
+
+It renders `docs/logo.svg` to the README PNGs and every PNG, ICO and ICNS under
+`electron/build/icons/` (the ICNS only on macOS, which has `iconutil`). Then run
+the Electron packaging contract. Keep `fill="none"` on the waveform path in every
+SVG copy of the mark; without it the curve fills black.
Do not redraw the waveform per screen. Use `VoiceStudioMark` in React and the
canonical SVG elsewhere so the silhouette stays recognizable at 16–512 px.
diff --git a/docs/logo-256.png b/docs/logo-256.png
index 94afdda39..401c6a609 100644
Binary files a/docs/logo-256.png and b/docs/logo-256.png differ
diff --git a/docs/logo.png b/docs/logo.png
index 16a154a67..ff7805d79 100644
Binary files a/docs/logo.png and b/docs/logo.png differ
diff --git a/docs/logo.svg b/docs/logo.svg
index f9aac2a67..9de4f474d 100644
--- a/docs/logo.svg
+++ b/docs/logo.svg
@@ -18,6 +18,6 @@
</defs>
<rect x="2" y="2" width="60" height="60" rx="15" fill="url(#tile)"/>
<rect x="2.5" y="2.5" width="59" height="59" rx="14.5" fill="url(#warmth)" stroke="#FFFFFF" stroke-opacity="0.09"/>
- <path d="M6 34c4 0 5-7 9-7 5 0 4 14 9 14 5 0 4-23 9-23s4 28 9 28 4-21 9-21c4 0 5 9 8 9" stroke="url(#voice)" stroke-width="5.5" stroke-linecap="round" stroke-linejoin="round"/>
+ <path d="M6 34c4 0 5-7 9-7 5 0 4 14 9 14 5 0 4-23 9-23s4 28 9 28 4-21 9-21c4 0 5 9 8 9" fill="none" stroke="url(#voice)" stroke-width="5.5" stroke-linecap="round" stroke-linejoin="round"/>
<path d="M50 9c.7 4.3 3.7 7.3 8 8-4.3.7-7.3 3.7-8 8-.7-4.3-3.7-7.3-8-8 4.3-.7 7.3-3.7 8-8Z" fill="#FFE5B5"/>
</svg>
diff --git a/electron/build/icons/32x32.png b/electron/build/icons/32x32.png
index 584eeb950..d933b944d 100644
Binary files a/electron/build/icons/32x32.png and b/electron/build/icons/32x32.png differ
diff --git a/electron/build/icons/icon.icns b/electron/build/icons/icon.icns
index 98be97e8b..07b45411f 100644
Binary files a/electron/build/icons/icon.icns and b/electron/build/icons/icon.icns differ
diff --git a/electron/build/icons/icon.ico b/electron/build/icons/icon.ico
index b30a638f2..5fb4ef6c0 100644
Binary files a/electron/build/icons/icon.ico and b/electron/build/icons/icon.ico differ
diff --git a/electron/build/icons/icon.png b/electron/build/icons/icon.png
index 16a154a67..ff7805d79 100644
Binary files a/electron/build/icons/icon.png and b/electron/build/icons/icon.png differ
diff --git a/electron/build/icons/tray-recording.png b/electron/build/icons/tray-recording.png
index 47465c365..d42be1fc1 100644
Binary files a/electron/build/icons/tray-recording.png and b/electron/build/icons/tray-recording.png differ
diff --git a/electron/public/favicon.svg b/electron/public/favicon.svg
index 8574dae26..6318aa439 100644
--- a/electron/public/favicon.svg
+++ b/electron/public/favicon.svg
@@ -16,6 +16,6 @@
</defs>
<rect x="2" y="2" width="60" height="60" rx="15" fill="url(#tile)"/>
<rect x="2.5" y="2.5" width="59" height="59" rx="14.5" fill="url(#warmth)" stroke="#FFFFFF" stroke-opacity="0.09"/>
- <path d="M6 34c4 0 5-7 9-7 5 0 4 14 9 14 5 0 4-23 9-23s4 28 9 28 4-21 9-21c4 0 5 9 8 9" stroke="url(#voice)" stroke-width="5.5" stroke-linecap="round" stroke-linejoin="round"/>
+ <path d="M6 34c4 0 5-7 9-7 5 0 4 14 9 14 5 0 4-23 9-23s4 28 9 28 4-21 9-21c4 0 5 9 8 9" fill="none" stroke="url(#voice)" stroke-width="5.5" stroke-linecap="round" stroke-linejoin="round"/>
<path d="M50 9c.7 4.3 3.7 7.3 8 8-4.3.7-7.3 3.7-8 8-.7-4.3-3.7-7.3-8-8 4.3-.7 7.3-3.7 8-8Z" fill="#FFE5B5"/>
</svg>
diff --git a/electron/src/shared/assets/integrations/voicestudio.svg b/electron/src/shared/assets/integrations/voicestudio.svg
index 8574dae26..6318aa439 100644
--- a/electron/src/shared/assets/integrations/voicestudio.svg
+++ b/electron/src/shared/assets/integrations/voicestudio.svg
@@ -16,6 +16,6 @@
</defs>
<rect x="2" y="2" width="60" height="60" rx="15" fill="url(#tile)"/>
<rect x="2.5" y="2.5" width="59" height="59" rx="14.5" fill="url(#warmth)" stroke="#FFFFFF" stroke-opacity="0.09"/>
- <path d="M6 34c4 0 5-7 9-7 5 0 4 14 9 14 5 0 4-23 9-23s4 28 9 28 4-21 9-21c4 0 5 9 8 9" stroke="url(#voice)" stroke-width="5.5" stroke-linecap="round" stroke-linejoin="round"/>
+ <path d="M6 34c4 0 5-7 9-7 5 0 4 14 9 14 5 0 4-23 9-23s4 28 9 28 4-21 9-21c4 0 5 9 8 9" fill="none" stroke="url(#voice)" stroke-width="5.5" stroke-linecap="round" stroke-linejoin="round"/>
<path d="M50 9c.7 4.3 3.7 7.3 8 8-4.3.7-7.3 3.7-8 8-.7-4.3-3.7-7.3-8-8 4.3-.7 7.3-3.7 8-8Z" fill="#FFE5B5"/>
</svg>
diff --git a/scripts/render_brand_icons.py b/scripts/render_brand_icons.py
new file mode 100644
index 000000000..846ba38a1
--- /dev/null
+++ b/scripts/render_brand_icons.py
@@ -0,0 +1,69 @@
+#!/usr/bin/env python3
+# /// script
+# dependencies = ["pillow>=12.1.0", "resvg-py==0.5.0"]
+# ///
+"""Regenerate every raster brand icon from the canonical docs/logo.svg.
+
+Run after changing the mark: uv run scripts/render_brand_icons.py
+resvg rasterizes the SVG on any OS; the macOS ICNS needs iconutil, so it is
+rebuilt only on macOS.
+"""
+import io
+import pathlib
+import shutil
+import subprocess
+import sys
+import tempfile
+
+import resvg_py
+from PIL import Image, ImageDraw
+
+ROOT = pathlib.Path(__file__).resolve().parents[1]
+SOURCE = ROOT / "docs/logo.svg"
+ICONS = ROOT / "electron/build/icons"
+ICO_SIZES = [16, 24, 32, 48, 64, 256]
+RECORDING = (0xEF, 0x44, 0x44, 255)
+
+
+def rasterize(svg):
+ png = resvg_py.svg_to_bytes(svg_string=svg.read_text(), width=1024, height=1024)
+ return Image.open(io.BytesIO(bytes(png))).convert("RGBA")
+
+
+def scaled(master, size):
+ return master.resize((size, size), Image.LANCZOS)
+
+
+def recording(master):
+ # The tray shows capture state with a red dot over the mark's lower right.
+ icon = scaled(master, 128)
+ ImageDraw.Draw(icon).ellipse((40, 40, 124, 124), fill=RECORDING, outline=(255, 255, 255, 255), width=6)
+ return icon.resize((32, 32), Image.LANCZOS)
+
+
+def icns(master, work, target):
+ iconset = work / "icon.iconset"
+ iconset.mkdir()
+ for size in (16, 32, 128, 256, 512):
+ scaled(master, size).save(iconset / f"icon_{size}x{size}.png")
+ scaled(master, size * 2).save(iconset / f"icon_{size}x{size}@2x.png")
+ subprocess.run(["iconutil", "-c", "icns", str(iconset), "-o", str(target)], check=True)
+
+
+def main():
+ master = rasterize(SOURCE)
+ scaled(master, 512).save(ROOT / "docs/logo.png")
+ scaled(master, 256).save(ROOT / "docs/logo-256.png")
+ scaled(master, 512).save(ICONS / "icon.png")
+ scaled(master, 32).save(ICONS / "32x32.png")
+ recording(master).save(ICONS / "tray-recording.png")
+ master.save(ICONS / "icon.ico", sizes=[(size, size) for size in ICO_SIZES])
+ if sys.platform == "darwin" and shutil.which("iconutil"):
+ with tempfile.TemporaryDirectory() as tmp:
+ icns(master, pathlib.Path(tmp), ICONS / "icon.icns")
+ else:
+ print("Skipped icon.icns: rebuild it on macOS (iconutil)")
+
+
+if __name__ == "__main__":
+ main()
diff --git a/tests/test_voicestudio_branding.py b/tests/test_voicestudio_branding.py
index eb5561e61..201cbcbe9 100644
--- a/tests/test_voicestudio_branding.py
+++ b/tests/test_voicestudio_branding.py
@@ -4,6 +4,7 @@ from __future__ import annotations
import json
import re
+import subprocess
from pathlib import Path
from packaging.version import Version
@@ -70,6 +71,28 @@ def test_brand_mark_is_shared_and_fills_the_icon() -> None:
assert 'src="docs/logo.png"' in (ROOT / "README.md").read_text()
+def test_waveform_stroke_is_never_filled() -> None:
+ # An SVG path fills black unless told otherwise; without fill="none" the
+ # waveform's closed curves painted a black band across every icon.
+ signature = "M6 34c4 0 5-7 9-7"
+ tracked = subprocess.run(["git", "ls-files", "*.svg"], cwd=ROOT, capture_output=True, text=True, check=True).stdout.split()
+ svgs = [ROOT / name for name in tracked if signature in (ROOT / name).read_text()]
+ assert len(svgs) >= 3
+ for svg in svgs:
+ stroke = re.search(rf'<path d="{re.escape(signature)}[^>]*>', svg.read_text())
+ assert stroke and 'fill="none"' in stroke.group(0), svg
+
+
+def test_raster_icons_have_no_black_band() -> None:
+ from PIL import Image
+
+ # Regenerated from docs/logo.svg by scripts/render_brand_icons.py.
+ for name in ("docs/logo.png", "docs/logo-256.png", "electron/build/icons/icon.png", "electron/build/icons/32x32.png"):
+ icon = Image.open(ROOT / name).convert("RGBA")
+ width, height = icon.size
+ assert icon.getpixel((width // 2, int(height * 0.53)))[:3] != (0, 0, 0), name
+
+
def test_python_package_metadata_points_to_voicestudio() -> None:
pyproject = (ROOT / "pyproject.toml").read_text()
assert 'Homepage = "https://github.com/debpalash/VoiceStudio"' in pyproject