Euphonia v0.4.0 — auto-update, export/backup, CI

Euphonia now updates itself, and you can back up your recordings before deleting them.

What changed

Auto-update — Euphonia now checks GitHub Releases in the background and downloads new versions automatically. When one's ready, a small toast appears with a "restart to update" button — no need to revisit this page for future releases.

Back up your recordings — Settings now has a 💾 export all recordings button that copies your recordings, audio, and analysis to a plain folder of your choosing. Both delete confirmations (single take and delete-all) now point to it.

Behind the scenes — the project now runs its regression tests automatically on every change via GitHub Actions, catching build/logic regressions before they ship.

Getting started

1. Download Euphonia-Setup-0.4.0.exe below.
2. Run it — Windows SmartScreen will warn it's from an unrecognized publisher (it's unsigned; not a sign anything's broken). Click More info → Run anyway.
3. Record a take — you'll get a written insight right away, no key required. From here on, Euphonia updates itself automatically. See the README for the full walkthrough.

Requirements

• Windows only for this release (see README for build-from-source options on other platforms)

Licensing note

This installer bundles GPLv3 components (Praat/parselmouth, ffmpeg). The source in this repo is MIT/public domain, but the packaged installer as a combined work is GPLv3 — see the README's License section and the bundled THIRD-PARTY-LICENSES.md for details.

Full documentation: README.md

Euphonia v0.3.0 — polished window chrome, delete recordings

The app now looks and feels like one cohesive piece of software, and you can clean up your own recording history.

What changed

Window chrome

• Removed the default Electron File/Edit/View/Window/Help menu bar.
• Replaced the native titlebar with a themed one (pink, matching the app) carrying the real Euphonia soundwave logo instead of the default Electron icon.
• The window/taskbar icon is now correct in both the installed app and dev builds.
• Centered the header title.

Themed controls — the record/stop button, the ⚙️ settings button, and the "generate insight" / "upgrade to an AI-written insight" buttons all now match the rest of the app's pink/lavender look instead of being plain default browser controls. The scrollbar is invisible at rest and only appears (in the app's pink) while you're actively scrolling.

Delete recordings

• Every recording card now has a 🗑️ button — delete a single take, with an inline confirm (no OS popup).
• Settings has a new "danger zone" with delete all recordings, for a full reset.
• Both remove the audio file, the analysis file, and any cached insight, not just the entry in the list.

Getting started

1. Download Euphonia Setup 0.3.0.exe below.
2. Run it — Windows SmartScreen will warn it's from an unrecognized publisher (it's unsigned; not a sign anything's broken). Click More info → Run anyway.
3. Record a take — you'll get a written insight right away, no key required. See the README for the full walkthrough, including the optional Gemini upgrade and how to delete recordings.

Requirements

• Windows only for this release (see README for build-from-source options on other platforms)

Licensing note

This installer bundles GPLv3 components (Praat/parselmouth, ffmpeg). The source in this repo is MIT/public domain, but the packaged installer as a combined work is GPLv3 — see the README's License section and the bundled THIRD-PARTY-LICENSES.md for details.

Full documentation: README.md

Euphonia v0.2.0 — zero-setup insights

Every take now gets a written insight instantly, with no API key and no setup at all.

What changed

• Insights are generated locally by a built-in rule-based writer that reuses the app's own metric zones (pitch, resonance, steadiness, vocal weight, phrasing) to pick what's working and the single clearest thing to try next — no network call, no account, nothing to configure.
• A free Gemini API key is now a purely optional upgrade, not a setup step. Add one anytime from the ⚙️ Settings screen, and any take showing the built-in insight will offer a "✨ upgrade to an AI-written insight" button for a richer, more personalized version.
• The first-launch API key prompt is gone — the app is fully usable the moment it's installed.

We also prototyped running a small local LLM (Qwen3, via HuggingFace) as a fully-offline replacement for Gemini, including a zone-aware prompt that explicitly tells the model which direction each metric is good/bad in. It wasn't reliable enough to trust for coaching advice, so we went with the deterministic built-in writer above instead — same zero-setup benefit, no risk of misreading your numbers.

Getting started

1. Download Euphonia Setup 0.2.0.exe below.
2. Run it — Windows SmartScreen will warn it's from an unrecognized publisher (it's unsigned; not a sign anything's broken). Click More info → Run anyway.
3. Record a take. That's it — you'll get a written insight right away, no key required.
4. (Optional) Add a free Gemini API key from the ⚙️ Settings screen any time for richer, AI-written insights. See docs/gemini-api-key.md for how to get one.

Requirements

• Windows only for this release (see README for build-from-source options on other platforms)

Licensing note

This installer bundles GPLv3 components (Praat/parselmouth, ffmpeg). The source in this repo is MIT/public domain, but the packaged installer as a combined work is GPLv3 — see the README's License section and the bundled THIRD-PARTY-LICENSES.md for details.

Full documentation: README.md

Euphonia v0.1.0 — first desktop release

First desktop release of Euphonia — a voice-feminization training tracker, now available as a standalone Windows app (no coding agent, no terminal required).

What it does

• Record a take right in the app
• Runs the same acoustic analysis (pitch, resonance, register, jitter/shimmer, etc.) locally via a bundled analyzer
• Optionally generates a short, personalized, encouraging insight per take using your own free Gemini API key
• Everything stays on your machine — no accounts, no server, nothing sent anywhere except (optionally) Google's Gemini API for the written insight

Getting started

1. Download Euphonia Setup 0.1.0.exe below
2. Run it — Windows SmartScreen will warn it's from an unrecognized publisher (it's unsigned; not a sign anything's broken). Click More info → Run anyway.
3. On first launch, you can optionally add a free Gemini API key for written insights (skippable — everything else works without one). See docs/gemini-api-key.md for how to get one.

Requirements

• Windows only for this release (see README for build-from-source options on other platforms)

Licensing note

This installer bundles GPLv3 components (Praat/parselmouth, ffmpeg). The source in this repo is MIT/public domain, but the packaged installer as a combined work is GPLv3 — see the README's License section and the bundled THIRD-PARTY-LICENSES.md for details.

Full documentation: README.md