Skip to content

fix: cross-platform compatibility and improved setup experience - #21

Open
pocikode wants to merge 1 commit into
dot-Justin:mainfrom
pocikode:fix/cross-platform-compatibility
Open

fix: cross-platform compatibility and improved setup experience#21
pocikode wants to merge 1 commit into
dot-Justin:mainfrom
pocikode:fix/cross-platform-compatibility

Conversation

@pocikode

@pocikode pocikode commented Jul 12, 2026

Copy link
Copy Markdown

Fixes #7

The main issue: this project does not work on macOS/Linux out of the box.

What I changed:

helpers/mic.py — The config path was hardcoded with Windows backslashes. Swapped to os.path.join so it works everywhere.

main.py — Same deal with the VOSK model path. Also added a check so you get a clear error message if the model is not downloaded yet, instead of a random traceback.

.env.example — Added one in the project root. The existing one was buried in helpers/ but load_dotenv() looks in the working directory. Now users can just cp .env.example .env and edit.

README — Rewrote the setup section with actual step-by-step instructions. The original was missing the VOSK download step entirely, which is probably why #7 was opened.

- Fix Windows-only backslash path separator in helpers/mic.py (use os.path.join)
- Add .env.example to project root for easier discovery
- Add VOSK model existence check with helpful error message
- Improve README with step-by-step setup instructions including VOSK download
- Use os.path.join for all file paths in main.py

Fixes dot-Justin#7
@pocikode

Copy link
Copy Markdown
Author

/claim #7

@opirebot

opirebot Bot commented Jul 12, 2026

Copy link
Copy Markdown

🤝 You already claimed this issue, you don't have to do it again!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

I am confused (help) I did everthing ready but this feels like a flipped slide

1 participant