Releases: BrainBehaviorAnalyticsLab/voxkit-desktop
v0.4.1
Note
The Linux AppImage exceeds GitHub's free-tier size limit, so it isn't available for download yet. Linux users will need to wait for a future release; stay tuned.
Note
To leverage MFA tools like alignment in VoxKit, Montreal Forced Aligner must be installed separately on your system using Conda as the package manager. VoxKit will detect it automatically if it's available on your PATH.
Installation
macOS
- Download VoxKit-macOS.dmg
- Drag the application bundle to your Applications folder
- Open a terminal:
# Run the following
xattr -cr ../VoxKit.app
# This disables macOS quarantine mode (for apps downloaded from the internet)- You're all set to open the application, the startup script will download some assets like models and initialize the local storage on the first open (be patient please)
# FYI deleting local storage will trigger a fresh startup the next time the app is opened
rm -rf ~/.voxkitWindows
- Download VoxKit-setup.exe
- Run the installer and follow the prompts
- Launch VoxKit from the Start menu; the startup script will download some assets like models and initialize the local storage on the first open (be patient please)
# FYI deleting local storage will trigger a fresh startup the next time the app is opened
Remove-Item -Recurse -Force $env:USERPROFILE\.voxkitSystem Requirements
- macOS 26 or later (Apple Silicon, arm64)
- Windows 10/11 (x64)
- Montreal Forced Aligner (installed via Conda); required for MFA engine tools
Changes
Improvements
- Windows installer packaging via Inno Setup (#132)
- Linux AppImage packaging with a new
linux-buildinvoke task (#132) - MFA Postgres server now auto-starts on Windows to avoid a SQLite race (#132)
- Cross-platform CI: tests now run on macOS, Ubuntu, and Windows (#132)
- MFA failures now propagate stderr in error messages for easier debugging (#132)
- W2TG engine error paths now use
logger.exceptionfor full stack traces (#132)
Fixes
- Hardened
main.pyfor windowed PyInstaller builds on Windows so launches no longer fail silently (#132) - Fixed CI uv install on Windows and Ubuntu (PATH pointed at the wrong directory) (#132)
- Installed Qt system dependencies and ran tests under xvfb on Ubuntu CI (#132)
Full Changelog: v0.4.0-macos-VoxKit...v0.4.1
v0.4.0-macos-VoxKit
Note
To leverage MFA tools like alignment in VoxKit, Montreal Forced Aligner must be installed separately on your system using Conda as the package manager. VoxKit will detect it automatically if it's available on your PATH.
Installation
- Download VoxKit-macOS.dmg
- Drag the application bundle to your Applications folder
- Open a terminal:
# Run the following
xattr -cr ../VoxKit.app
# This disables macOS quarantine mode (for apps downloaded from the internet)- You're all set to open the application, the startup script will download some assets like models and initialize the local storage on the first open (be patient please)
# FYI deleting local storage will trigger a fresh startup the next time the app is opened
rm -rf ~/.voxkitSystem Requirements
- macOS 26 or later
- Works on Apple Silicon Macs (arm64)
- Montreal Forced Aligner (installed via Conda); required for MFA engine tools
Changes
- Enhance dataset registration with optional hand alignment by @BeckettFrey in #129
Full Changelog: v0.3.2-macos-VoxKit...v0.4.0-macos-VoxKit
v0.3.2-macos-VoxKit
Note
To leverage MFA tools like alignment in VoxKit, Montreal Forced Aligner must be installed separately on your system using Conda as the package manager. VoxKit will detect it automatically if it's available on your PATH.
Installation
- Download VoxKit-macOS.dmg
- Drag the application bundle to your Applications folder
- Open a terminal:
# Run the following
xattr -cr ../VoxKit.app
# This disables macOS quarantine mode (for apps downloaded from the internet)- You're all set to open the application, the startup script will download some assets like models and initialize the local storage on the first open (be patient please)
# FYI deleting local storage will trigger a fresh startup the next time the app is opened
rm -rf ~/.voxkitSystem Requirements
- macOS 26 or later
- Works on Apple Silicon Macs (arm64)
- Montreal Forced Aligner (installed via Conda); required for MFA engine tools
Changes
Fixes
- Help links now point to the production URL instead of localhost (#92)
- Dataset panel empty state stays responsive when the splitter is resized (#94)
- First-launch flag no longer marked complete if the startup script errors, so setup retries properly (#99)
- Readable names now display correctly for prefixed IDs (#101)
- Datasets with linked alignments now import correctly (#107)
- Deleting a model with an empty ID no longer wipes the engine models directory (#100)
- Dataset validation now verifies audio and label files are properly paired by stem name (#102)
- "View" button width fixed (#105)
Improvements
- Logging added across the app for easier troubleshooting (#95)
- Configuration refactor and updated release workflow (#96)
- ShredGuard configured with blocking regex patterns for safer input handling (#98)
Full Changelog: v0.3.1-macos-VoxKit...v0.3.2-macos-VoxKit
v0.3.1-macos-VoxKit
Note
To leverage MFA tools like alignment in VoxKit, Montreal Forced Aligner must be installed separately on your system using Conda as the package manager. VoxKit will detect it automatically if it's available on your PATH.
Installation
- Download VoxKit-macOS.dmg
- Drag the application bundle to your Applications folder
- Open a terminal:
# Run the following
xattr -cr ../VoxKit.app
# This disables macOS quarantine mode (for apps downloaded from the internet)- You're all set to open the application, the startup script will download some assets like models and initialize the local storage on the first open (be patient please)
# FYI deleting local storage will trigger a fresh startup the next time the app is opened
rm -rf ~/.voxkitSystem Requirements
- macOS 26 or later
- Works on Apple Silicon Macs (arm64)
- Montreal Forced Aligner (installed via Conda); required for MFA engine tools
Changes
- Fix alignment button rendering, metadata updates, and dataset state by @BeckettFrey in #84
Full Changelog: v0.3.0-macos-VoxKit...v0.3.1-macos-VoxKit
v0.3.0-macos-VoxKit
Note
To leverage MFA tools like alignment in VoxKit, Montreal Forced Aligner must be installed separately on your system using Conda as the package manager. VoxKit will detect it automatically if it's available on your PATH.
Installation
- Download VoxKit-macOS.dmg
- Drag the application bundle to your Applications folder
- Open a terminal:
# Run the following
xattr -cr ../VoxKit.app
# This disables macOS quarantine mode (for apps downloaded from the internet)- You're all set to open the application, the startup script will download some assets like models and initialize the local storage on the first open (be patient please)
# FYI deleting local storage will trigger a fresh startup the next time the app is opened
rm -rf ~/.voxkitSystem Requirements
- macOS 26 or later
- Works on Apple Silicon Macs (arm64)
- Montreal Forced Aligner (installed via Conda); required for MFA engine tools
Changes
- New: Alignment Viewer (Ⓓ View Alignments) — browse completed alignments file-by-file; select a dataset and alignment run, then navigate by speaker and audio file to view transcript (.lab), TextGrid tier intervals (phones/words), and play back the original audio side-by-side
- New: Alignment Comparison (Ⓔ Compare Alignments) — select two alignment runs from the same dataset and generate four phoneme-level plots: phoneme counts, mean IoU overlap, overlap rate, and substitution scatter; any subset of plots can be exported as PNGs
- New dependency: alignment-comparison-plots — sourced from WISCLab/alignment-comparison-plots; powers the phoneme-level comparison visualizations
- Built from commit: b999b7f
v0.2.0-macos-VoxKit
Note
To leverage MFA tools like alignment in VoxKit, Montreal Forced Aligner must be installed separately on your system using Conda as the package manager. VoxKit will detect it automatically if it's available on your PATH.
Installation
- Download VoxKit-macOS.dmg
- Drag the application bundle to your Applications folder
- Open a terminal:
# Run the following
xattr -cr ../VoxKit.app
# This disables macOS quarantine mode (for apps downloaded from the internet)- You're all set to open the application, the startup script will download some assets like models and initialize the local storage on the first open (be patient please)
# FYI deleting local storage will trigger a fresh startup the next time the app is opened
rm -rf ~/.voxkitSystem Requirements
- macOS 26 or later
- Works on Apple Silicon Macs (arm64)
- Montreal Forced Aligner (installed via Conda); required for MFA engine tools
Changes
- Profile system: Post-build configuration via config/profile.txt; ships
with default and explanatory profiles - W2TGEngine: Reintroduced engine support
- Resizable panels: New grip splitter component on datasets page for
flexible layout - PLLR: Replaces GOP following team decision
- Alignments panel: Now filters to show only engines with align capability
- Models page: Filters out non-conforming engines
- UI: Clearer dataset registration option labels
- Built from commit: 2fd64ae
v0.1.1-macos-VoxKit
Note
To leverage MFA tools like alignment in VoxKit, Montreal Forced Aligner must be installed separately on your system using Conda as the package manager. VoxKit will detect it automatically if it's available on your PATH.
Installation
- Download VoxKit-macOS.dmg
- Drag the application bundle to your Applications folder
- Open a terminal:
# Run the following
xattr -cr ../VoxKit.app
# This disables macOS quarantine mode (for apps downloaded from the internet)- You're all set to open the application, the startup script will download some assets like models and initialize the local storage on the first open (be patient please)
# FYI deleting local storage will trigger a fresh startup the next time the app is opened
rm -rf ~/.voxkitSystem Requirements
- macOS 26 or later
- Works on Apple Silicon Macs (arm64)
- Montreal Forced Aligner (installed via Conda); required for MFA engine tools
Changes
- Fix build script to properly import frozen patching; reducing manual setup
- Correct default HELP_URL for user reference
- Built from commit: d74b556
v0.1.0-macos-VoxKit
Note
To leverage MFA tools like alignment in VoxKit, Montreal Forced Aligner must be installed separately on your system using Conda as the package manager. VoxKit will detect it automatically if it's available on your PATH.
Installation
- Download VoxKit-macOS.dmg
- Drag the application bundle to your Applications folder
- Open a terminal:
# Run the following
xattr -cr ../VoxKit.app
# This disables macOS quarantine mode (for apps downloaded from the internet)- Using the version linked to the build, trigger environment setup, the application seems inconsistent in triggering this due to a bug in main which failed to import the frozen patch.
# This will setup the local storage in a way that then allows you to execute the bundled app
make dev- Lastly, you'll have to download the nltk perceptron tagger for GOP extraction
import nltk
nltk.download('averaged_perceptron_tagger_eng')- You're all set to open the application, the startup script will download some assets like models and initialize the local storage on the first open
# FYI deleting local storage will trigger a fresh startup the next time the app is opened
rm -rf ~/.voxkitSystem Requirements
- macOS 26 or later
- Works on Apple Silicon Macs (arm64)
- Montreal Forced Aligner (installed via Conda); required for MFA engine tools
Changes
- This is the first dev release, it's rough so be mindful
- Built from commit: 421d496