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(release): tag a version that main already has instead of crashing

velixiof3677437adf0
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 3a95029d9..bacc0549c 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -88,209 +88,6 @@ metadata and the backend fallback mirror it.
- Gallery preview fallback smoke no longer flakes when a slower runner reads the playing clip in several byte ranges (#3018)
-## [0.5.7-beta.3] — 2026-10-23
-
-**Highlights**
-
-- Preview iOS and Android companion apps for your own VoiceStudio
-- Opt-in Beta update channel: get fixes early from Settings → Updates, and roll onto the next stable release automatically
-
-### Changed
-
-- Phone apps now use the app ID `sh.voicestudio.mobile`; a preview build installed before installs alongside as a new app, so pair it again and remove the old one (#3194)
-
-### Added
-
-- Beta update channel: choose Stable or Beta under Settings → Updates; betas are `-beta.N` prereleases that never reach Stable users, and Docker gets matching `:beta` tags ([guide](docs/update-channels.md)) (#3175)
-
-- Preview iOS and Android companion apps: drive your own VoiceStudio from your phone (speak, voices and cloning, dubbing, dictation) after pairing by QR code; build from source for now ([guide](docs/mobile.md)) (#2965)
-- Smart Fit speed limits: set the fastest and slowest speed dubbing may apply to a line, from the Timing section (#3026) — thanks @MoonDragon-MD!
-
-### Fixed
-
-- 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)
-- Bug reports now include your OS, memory, free disk and whether the Python runtime exists, even when the backend never started, plus flags for risky install paths such as OneDrive or non-ASCII folders (#3156)
-- Bug reports no longer hang on a stalled drive, and report free disk and the uv tool correctly on first run and in source checkouts (#3170)
-- Older synthesized takes play again with accurate play/pause controls after a newer generation (#3102)
-- Generation-complete notifications appear above the workspace instead of covering synthesis controls (#3102)
-- Generated speech no longer starts and ends with silence, and `[pause]` markers give exactly the pause you asked for (Raw preset and explicit durations untouched) (#3080)
-- Engine sidecars no longer load PyTorch just to answer the Test Engine ping, and a failed test logs its reason locally (#3026) — thanks @tekay-de!
-
-### Fixed
-
-- Windows runtime refresh no longer fails with `EPERM` on a locked backend folder (OneDrive, antivirus): it updates the files in place; the missing-Python-environment message now names the exact folder and tells non-checkout installs to use the installer (#3023) — thanks @afraniohugo, @javalovelinux-cmd and @eduardpp00!
-
-### Fixed
-
-- The install location chosen in first-run setup now also holds your data, model cache and temp files instead of quietly filling `C:`, and the setup screen shows each path (#2971, #3035)
-- Supertonic-3's preset voices can be picked in the voice controls and are used for generation (#2938, #3035)
-
-- `OMNIVOICE_ENGINES_DIR` moves engine venvs and the audio.cpp runtime to another drive; the default location is unchanged (#3024)
-
-### Fixed
-
-- The installed app now rebuilds a Python environment that antivirus or disk cleanup removed, once per launch with the usual setup progress, instead of stopping at a setup error; your voices and projects are untouched (#3032) — thanks @afraniohugo and @javalovelinux-cmd!
-
-### Docs
-
-- `SPONSORS.md` now states what each sponsorship tier gives, when recognition starts, and what sponsorship does not buy, and the README and inquiry form point to it (#3172)
-- OmniVoice GGUF docs state that the installers do not ship its native binary yet (#3026) — thanks @DestinyQJY!
-- Contributor guides and the pull request template explain how to sign the CLA before opening a first pull request (#2676)
-
-### Fixed
-
-- macOS builds without a Developer ID are now signed ad hoc so the bundle signature is valid, and the shell installer clears quarantine, repairs an invalid signature of older releases, names an unreadable disk image, and tells Intel Mac users the backend needs Apple Silicon (#3033, #2763, #2829, #2681)
-- A "Generation failed" log line now says where it was raised and which error caused it, and the out-of-memory advice mentions picking another GPU, so these reports can be told apart (#2895, #2684, #2666, #2626, #2622, #2580, #3034)
-
-### CI
-
-- Interactive release helper: pick stable or beta, draft or publish, and confirm by typing the tag (`scripts/release.py`) (#3187)
-- Release helper choices are arrow-key menus (#3190)
-- Desktop request-guard self-tests stay deterministic when app requests arrive during cleanup (#2676)
-
-- New `mobile` workflow builds and tests both phone apps; a contract test fails when their theme or API description drifts from the desktop app (#2965)
-
-- iOS TestFlight workflow: maintainers can upload a signed iPhone build for internal testers from `main` ([guide](docs/mobile.md#testflight-maintainers)) (#3188)
-- Android Play internal testing workflow: the matching signed Android upload from `main`, and beta versions no longer break the Android build ([guide](docs/mobile.md#play-internal-testing-maintainers)) (#3189)
-
-- Gallery preview fallback smoke no longer flakes when a slower runner reads the playing clip in several byte ranges (#3018)
-
-## [0.5.7-beta.2] — 2026-10-23
-
-**Highlights**
-
-- Preview iOS and Android companion apps for your own VoiceStudio
-- Opt-in Beta update channel: get fixes early from Settings → Updates, and roll onto the next stable release automatically
-
-### Changed
-
-- Phone apps now use the app ID `sh.voicestudio.mobile`; a preview build installed before installs alongside as a new app, so pair it again and remove the old one (#3194)
-
-### Added
-
-- Beta update channel: choose Stable or Beta under Settings → Updates; betas are `-beta.N` prereleases that never reach Stable users, and Docker gets matching `:beta` tags ([guide](docs/update-channels.md)) (#3175)
-
-- Preview iOS and Android companion apps: drive your own VoiceStudio from your phone (speak, voices and cloning, dubbing, dictation) after pairing by QR code; build from source for now ([guide](docs/mobile.md)) (#2965)
-- Smart Fit speed limits: set the fastest and slowest speed dubbing may apply to a line, from the Timing section (#3026) — thanks @MoonDragon-MD!
-
-### Fixed
-
-- 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)
-- Bug reports now include your OS, memory, free disk and whether the Python runtime exists, even when the backend never started, plus flags for risky install paths such as OneDrive or non-ASCII folders (#3156)
-- Bug reports no longer hang on a stalled drive, and report free disk and the uv tool correctly on first run and in source checkouts (#3170)
-- Older synthesized takes play again with accurate play/pause controls after a newer generation (#3102)
-- Generation-complete notifications appear above the workspace instead of covering synthesis controls (#3102)
-- Generated speech no longer starts and ends with silence, and `[pause]` markers give exactly the pause you asked for (Raw preset and explicit durations untouched) (#3080)
-- Engine sidecars no longer load PyTorch just to answer the Test Engine ping, and a failed test logs its reason locally (#3026) — thanks @tekay-de!
-
-### Fixed
-
-- Windows runtime refresh no longer fails with `EPERM` on a locked backend folder (OneDrive, antivirus): it updates the files in place; the missing-Python-environment message now names the exact folder and tells non-checkout installs to use the installer (#3023) — thanks @afraniohugo, @javalovelinux-cmd and @eduardpp00!
-
-### Fixed
-
-- The install location chosen in first-run setup now also holds your data, model cache and temp files instead of quietly filling `C:`, and the setup screen shows each path (#2971, #3035)
-- Supertonic-3's preset voices can be picked in the voice controls and are used for generation (#2938, #3035)
-
-- `OMNIVOICE_ENGINES_DIR` moves engine venvs and the audio.cpp runtime to another drive; the default location is unchanged (#3024)
-
-### Fixed
-
-- The installed app now rebuilds a Python environment that antivirus or disk cleanup removed, once per launch with the usual setup progress, instead of stopping at a setup error; your voices and projects are untouched (#3032) — thanks @afraniohugo and @javalovelinux-cmd!
-
-### Docs
-
-- `SPONSORS.md` now states what each sponsorship tier gives, when recognition starts, and what sponsorship does not buy, and the README and inquiry form point to it (#3172)
-- OmniVoice GGUF docs state that the installers do not ship its native binary yet (#3026) — thanks @DestinyQJY!
-- Contributor guides and the pull request template explain how to sign the CLA before opening a first pull request (#2676)
-
-### Fixed
-
-- macOS builds without a Developer ID are now signed ad hoc so the bundle signature is valid, and the shell installer clears quarantine, repairs an invalid signature of older releases, names an unreadable disk image, and tells Intel Mac users the backend needs Apple Silicon (#3033, #2763, #2829, #2681)
-- A "Generation failed" log line now says where it was raised and which error caused it, and the out-of-memory advice mentions picking another GPU, so these reports can be told apart (#2895, #2684, #2666, #2626, #2622, #2580, #3034)
-
-### CI
-
-- Interactive release helper: pick stable or beta, draft or publish, and confirm by typing the tag (`scripts/release.py`) (#3187)
-- Release helper choices are arrow-key menus (#3190)
-- Desktop request-guard self-tests stay deterministic when app requests arrive during cleanup (#2676)
-
-- New `mobile` workflow builds and tests both phone apps; a contract test fails when their theme or API description drifts from the desktop app (#2965)
-
-- iOS TestFlight workflow: maintainers can upload a signed iPhone build for internal testers from `main` ([guide](docs/mobile.md#testflight-maintainers)) (#3188)
-- Android Play internal testing workflow: the matching signed Android upload from `main`, and beta versions no longer break the Android build ([guide](docs/mobile.md#play-internal-testing-maintainers)) (#3189)
-
-- Gallery preview fallback smoke no longer flakes when a slower runner reads the playing clip in several byte ranges (#3018)
-
-## [0.5.7-beta.1] — 2026-10-23
-
-**Highlights**
-
-- Preview iOS and Android companion apps for your own VoiceStudio
-- Opt-in Beta update channel: get fixes early from Settings → Updates, and roll onto the next stable release automatically
-
-### Added
-
-- Beta update channel: choose Stable or Beta under Settings → Updates; betas are `-beta.N` prereleases that never reach Stable users, and Docker gets matching `:beta` tags ([guide](docs/update-channels.md)) (#3175)
-
-- Preview iOS and Android companion apps: drive your own VoiceStudio from your phone (speak, voices and cloning, dubbing, dictation) after pairing by QR code; build from source for now ([guide](docs/mobile.md)) (#2965)
-- Smart Fit speed limits: set the fastest and slowest speed dubbing may apply to a line, from the Timing section (#3026) — thanks @MoonDragon-MD!
-
-### Fixed
-
-- 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)
-- Bug reports now include your OS, memory, free disk and whether the Python runtime exists, even when the backend never started, plus flags for risky install paths such as OneDrive or non-ASCII folders (#3156)
-- Bug reports no longer hang on a stalled drive, and report free disk and the uv tool correctly on first run and in source checkouts (#3170)
-- Older synthesized takes play again with accurate play/pause controls after a newer generation (#3102)
-- Generation-complete notifications appear above the workspace instead of covering synthesis controls (#3102)
-- Generated speech no longer starts and ends with silence, and `[pause]` markers give exactly the pause you asked for (Raw preset and explicit durations untouched) (#3080)
-- Engine sidecars no longer load PyTorch just to answer the Test Engine ping, and a failed test logs its reason locally (#3026) — thanks @tekay-de!
-
-### Fixed
-
-- Windows runtime refresh no longer fails with `EPERM` on a locked backend folder (OneDrive, antivirus): it updates the files in place; the missing-Python-environment message now names the exact folder and tells non-checkout installs to use the installer (#3023) — thanks @afraniohugo, @javalovelinux-cmd and @eduardpp00!
-
-### Fixed
-
-- The install location chosen in first-run setup now also holds your data, model cache and temp files instead of quietly filling `C:`, and the setup screen shows each path (#2971, #3035)
-- Supertonic-3's preset voices can be picked in the voice controls and are used for generation (#2938, #3035)
-
-- `OMNIVOICE_ENGINES_DIR` moves engine venvs and the audio.cpp runtime to another drive; the default location is unchanged (#3024)
-
-### Fixed
-
-- The installed app now rebuilds a Python environment that antivirus or disk cleanup removed, once per launch with the usual setup progress, instead of stopping at a setup error; your voices and projects are untouched (#3032) — thanks @afraniohugo and @javalovelinux-cmd!
-
-### Docs
-
-- `SPONSORS.md` now states what each sponsorship tier gives, when recognition starts, and what sponsorship does not buy, and the README and inquiry form point to it (#3172)
-- OmniVoice GGUF docs state that the installers do not ship its native binary yet (#3026) — thanks @DestinyQJY!
-- Contributor guides and the pull request template explain how to sign the CLA before opening a first pull request (#2676)
-
-### Fixed
-
-- macOS builds without a Developer ID are now signed ad hoc so the bundle signature is valid, and the shell installer clears quarantine, repairs an invalid signature of older releases, names an unreadable disk image, and tells Intel Mac users the backend needs Apple Silicon (#3033, #2763, #2829, #2681)
-- A "Generation failed" log line now says where it was raised and which error caused it, and the out-of-memory advice mentions picking another GPU, so these reports can be told apart (#2895, #2684, #2666, #2626, #2622, #2580, #3034)
-
-### CI
-
-- Interactive release helper: pick stable or beta, draft or publish, and confirm by typing the tag (`scripts/release.py`) (#3187)
-- Release helper choices are arrow-key menus (#3190)
-- Desktop request-guard self-tests stay deterministic when app requests arrive during cleanup (#2676)
-
-- New `mobile` workflow builds and tests both phone apps; a contract test fails when their theme or API description drifts from the desktop app (#2965)
-
-- iOS TestFlight workflow: maintainers can upload a signed iPhone build for internal testers from `main` ([guide](docs/mobile.md#testflight-maintainers)) (#3188)
-- Android Play internal testing workflow: the matching signed Android upload from `main`, and beta versions no longer break the Android build ([guide](docs/mobile.md#play-internal-testing-maintainers)) (#3189)
-
-- Gallery preview fallback smoke no longer flakes when a slower runner reads the playing clip in several byte ranges (#3018)
-
## [0.5.7] — 2026-10-17
**VoiceStudio now runs on PCs without a GPU and recovers instead of giving up.** Voice cloning uses the speech-to-text model you installed from Model Catalogue, GPU-less computers get the small CPU PyTorch build, and slow or busy backends are no longer reported as failed.
diff --git a/scripts/release.py b/scripts/release.py
index 130f4d442..42f848d3c 100644
--- a/scripts/release.py
+++ b/scripts/release.py
@@ -364,8 +364,14 @@ Release plan
"The version files, uv.lock and CHANGELOG.md were restored; nothing was pushed."
)
sh("git", "add", *RELEASE_FILES)
- sh("git", "commit", "-m", f"chore(release): {tag}")
- sh("git", "push", "origin", "main")
+ # Version-bump commits stay on main when a tag is deleted or a build fails, so
+ # main may already hold this version; then there is nothing to commit and the
+ # release only needs the tag.
+ if sh("git", "status", "--porcelain", "--untracked-files=no", capture=True):
+ sh("git", "commit", "-m", f"chore(release): {tag}")
+ sh("git", "push", "origin", "main")
+ else:
+ print(f"main already has {version} and its changelog; tagging it as is.")
sh("git", "tag", tag)
sh("git", "push", "origin", tag)
if mode == "publish":
diff --git a/tests/test_release_script.py b/tests/test_release_script.py
index 94a0a1ffe..ba7d399ee 100644
--- a/tests/test_release_script.py
+++ b/tests/test_release_script.py
@@ -114,7 +114,7 @@ def test_generated_changelog_passes_the_release_notes_extraction(release, versio
assert section and section[1].strip()
-def _drive(release, monkeypatch, answers, *, dry_run, secrets_missing=(), branch="main", fail_on=None, calls=None, guessed=False):
+def _drive(release, monkeypatch, answers, *, dry_run, secrets_missing=(), branch="main", fail_on=None, calls=None, guessed=False, clean=False):
"""Run release() with scripted prompts and every side effect recorded, not run."""
import argparse
@@ -130,6 +130,8 @@ def _drive(release, monkeypatch, answers, *, dry_run, secrets_missing=(), branch
return branch
if cmd[:2] == ("git", "rev-list"):
return "34"
+ if cmd[:2] == ("git", "status"):
+ return "" if clean else " M package.json"
calls.append(cmd)
if fail_on and fail_on in cmd:
import subprocess
@@ -318,3 +320,21 @@ def test_signing_names_match_what_the_release_workflow_reads(release):
for names in release.SIGNING_ENV_NAMES.values():
for name in names:
assert f"secrets.{name}" in workflow, f"{name} is not used by electron-release.yml"
+
+
+def test_a_version_already_on_main_is_tagged_without_an_empty_commit(release, monkeypatch, capsys):
+ """main keeps the bump commits of deleted tags, so the bump can change nothing;
+ `git commit` then exits 1 ("nothing to commit") and used to crash the release."""
+ tag = "v0.5.7-beta.1"
+ calls = _drive(release, monkeypatch, ["beta", "", "draft", tag], dry_run=False, clean=True)
+ assert not any(c[:2] == ("git", "commit") for c in calls)
+ assert ("git", "push", "origin", "main") not in calls
+ assert ("git", "tag", tag) in calls and ("git", "push", "origin", tag) in calls
+ assert "already has 0.5.7-beta.1" in capsys.readouterr().out
+
+
+def test_a_changed_tree_is_still_committed_and_pushed(release, monkeypatch):
+ tag = "v0.5.7-beta.1"
+ calls = _drive(release, monkeypatch, ["beta", "", "draft", tag], dry_run=False)
+ assert ("git", "commit", "-m", f"chore(release): {tag}") in calls
+ assert calls.index(("git", "push", "origin", "main")) < calls.index(("git", "tag", tag))