Releases: BrainBehaviorAnalyticsLab/voxkit-desktop
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