b1a7ddc374
A Linux AppImage user asked which folders to delete to remove OmniVoice and whether an uninstaller exists (#1089) — they had to guess. They shouldn't have to: the app is fully local, so uninstalling IS just deleting the folders it wrote, and we never documented them. - scripts/uninstall.sh (macOS/Linux) + scripts/uninstall.ps1 (Windows): find every OmniVoice folder — app data, the multi-GB managed Python env, config, logs — plus, listed SEPARATELY because it is a shared cache, the Hugging Face model cache. Print each with its size as a DRY RUN and stop; delete only on --yes (--models / -Models to include the shared cache). They honor the same env overrides the app reads (OMNIVOICE_DATA_DIR, OMNIVOICE_CACHE_DIR, HF_HOME, HF_HUB_CACHE), and never touch the app binary or anything outside the paths they list. - docs/install/uninstall.md: the complete per-platform path table (what each folder holds and how big it is), the shared-HF-cache caveat, custom/portable locations, per-platform steps to remove the app itself, and what to keep if you plan to reinstall. - Linked from the README FAQ, SUPPORT.md, and install troubleshooting. Paths mirror backend/core/config.py + frontend/src-tauri/src/setup.rs. Verified on macOS: dry-run lists the real dirs; sandboxed HOME runs confirm --yes removes app folders while KEEPING the shared cache, --models removes it, and the env overrides retarget correctly. Closes #1089 Co-authored-by: mergetest <nizam4103@gmail.com> Co-authored-by: Claude Fable 5 <noreply@anthropic.com>
2.1 KiB
Support
Where to get help
| Channel | Best for |
|---|---|
Discord — #help |
Setup problems, quick questions, sharing results |
| GitHub Issues | Bugs and feature requests — use the templates; attach the diagnostic bundle (Settings → About → "Save diagnostic bundle") |
| GitHub Discussions | Design questions, ideas, show & tell |
| Security issues | Never a public issue — see SECURITY.md for private reporting |
Uninstalling / removing all data
OmniVoice is fully local — there's nothing to deactivate, just folders to
delete. scripts/uninstall.sh (macOS/Linux) or scripts\uninstall.ps1
(Windows) lists every OmniVoice folder with its size (dry-run first) and
removes them on --yes. The complete per-platform path list is in
docs/install/uninstall.md.
Model sources we support
OmniVoice is built on the idea that everything it runs is open and available to everyone: free, public models with verifiable sources and licenses (Hugging Face repos, official project releases), so the whole community can use, test, and debug the same thing.
We do not support privately sold, paywalled, or gated model files. A model delivered privately can't be verified, reproduced, or shared — it doesn't fit the project's goals, and issues involving such models will be politely closed. As a general safety rule, never run executables bundled inside any model archive.
Before filing a bug
- Update to the latest release (or
mainif you follow previews) — fixes ship continuously. - Run the in-app self-check: Settings → About → Run self-check.
- Search existing issues; add a 👍 + your details to an existing one rather than opening a duplicate.
Response expectations
This is an open-source project maintained with the help of an automated triage bot: issues are typically triaged within hours and every report gets a human- approved response. Reproducible reports with a diagnostic bundle get fixed fastest.