Skip to content

AVP-Dev/nyx-vox

Repository files navigation

Welcome to NYX Vox! This is our very first project built with Rust and our first steps into its ecosystem. It is a personal tool designed for daily use, and because it is a learning journey, we are actively looking for feedback, code reviews, and architectural recommendations to improve the implementation!

🌟 Vision

NYX Vox brings fast, offline-capable and cloud-accelerated voice transcription directly to your desktop. Built with modern, high-performance tools, it's designed to be functional, aesthetically pleasing, and remarkably stable. The interface leverages smooth Glassmorphism UI elements to keep things clean and engaging.

🎙 AI Transcription Engines

  1. CLOUD (Groq) — [Recommended]: Our primary recommendation. Runs Whisper Large-v3-Turbo on blazing-fast LPU™ hardware.

    How to get free Groq API Key 1. Go to Groq Cloud Console.
    2. Login (Google/Email).
    3. Click "Create API Key", name it "NYX-Vox" and copy it.
  2. CLOUD (Deepgram): Commercial-grade model. High stability and excellent noise filtering.

    How to get Deepgram API Key 1. Go to Deepgram Console.
    2. Create an account.
    3. Go to "API Keys" section and generate a new key.
  3. OFFLINE (whisper-rs): Runs locally on your Mac using ggml-small.bin. Ultimate privacy, no internet required.

📦 Installation & Setup

  1. Download: Get the latest .dmg file from the Releases page.
  2. Install: Open the .dmg and drag NYX Vox to your Applications folder.
  3. Launch: Open the app from your Applications folder.

🛠 Troubleshooting: "App is damaged" error

If you see a message saying the app is damaged or cannot be opened, it’s because it lacks an Apple Developer signature. Follow these steps:

  1. Open Terminal.
  2. Run the following command:
    xattr -cr /Applications/NYX\ Vox.app
  3. Open the app again.

🔐 Permissions & Access

NYX Vox requires Accessibility (for auto-pasting text) and Microphone permissions. We have implemented a native Rust bridge to provide real-time status monitoring directly in the Settings panel.

  • Automatic Mode: The app detects permission changes instantly. If a status turns red, it means macOS has revoked access.
  • Why "Reset Permissions"?: Sometimes macOS permissions "freeze" or stop responding correctly after an app update or hardware change. Use the Reset button in Settings to clear the system cache for NYX Vox and trigger a fresh request.

Important

Because the app is distributed without a paid developer signature, macOS may revoke "Accessibility" rights during every manual update. If auto-paste stops working, simply use the Reset button or manually remove NYX Vox from System Settings -> Privacy & Security -> Accessibility and restart the app.

🚀 Roadmap

  • Basic Speech-to-Text Pipeline (Whisper/Groq/Deepgram)
  • Glassmorphism UI & Dynamic Windows
  • Native HID Auto-Paste (MacOS)
  • Custom Global Shortcuts
  • Local Transcription History & Search
  • Intelligent AI Formatting: LLM models (Gemini, Qwen, DeepSeek) for grammar, punctuation, and style refinement.
  • Voice Commands & App Control (Planned)
  • Multi-Language Translation (Planned)

Tip

API Transparency & Accessibility: NYX Vox utilizes modern, free, or freemium API models. We specifically choose engines like Groq and Deepgram because they provide high-tier performance while remaining accessible for individual developers and power users without high entry costs.

Note

This is a passionate first foray into Rust for system-level audio and API integration. Please share any thoughts or constructive feedback on the repository!


🤝 Support & Contribution

NYX Vox is an open-heart project. If you'd like to support the project, suggest a feature, recommend a fix, or report a bug — please don't hesitate to reach out! Your feedback is what helps this first Rust experiment grow into a professional tool.

Simply Open an Issue or contact me directly via the links below.


Alexios Odos  |  Aliaksei Patskevich
Software Engineer • Code, Design & AI
GitHubTelegram


About

Minimalist voice-to-text tool for macOS. Speak, transcribe (Offine & Cloud AI), and auto-paste anywhere.

Topics

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages