🚀 Getting Started with Velox AI Input

The easiest way to get Velox is through the Mac App Store. This ensures you get automatic updates and the most secure version of the app.

1. Open the Mac App Store on your Mac
2. Search for "Velox AI Input"
3. Click "Get" or the download button
4. Enter your Apple ID password or use Touch ID if prompted
5. Wait for the download and installation to complete

If you prefer to download the app directly, you can get the DMG file from our website.

1. Visit d.ai-voice-input.com/packages/Velox.dmg
2. Download the Velox.dmg file
3. Open the downloaded DMG file
4. Drag Velox.app to your Applications folder
5. Eject the DMG and delete it

After installation, you'll need to launch Velox and grant it the necessary permissions to work properly.

1. Open your Applications folder
2. Find and double-click Velox AI Input
3. The app will appear in your menu bar (top-right corner) with the Velox icon
4. You'll see a welcome screen with onboarding instructions

Velox needs access to your microphone to record your voice. This is the first permission you'll be asked for.

1. When prompted, click "OK" or "Allow" on the microphone permission dialog
2. If you accidentally denied it, you can enable it manually:
   • Open System Settings (or System Preferences)
   • Go to Privacy & Security → Microphone
   • Find Velox AI Input and toggle it ON

Velox needs Accessibility permission to automatically paste transcribed text into your active app. This is a critical permission for the app to work properly.

1. Velox will prompt you to grant Accessibility permission
2. Click "Open System Settings" in the prompt
3. In System Settings, go to Privacy & Security → Accessibility
4. Click the lock icon at the bottom and enter your password
5. Find Velox AI Input in the list and toggle it ON
6. Close System Settings and return to Velox

Velox will guide you through a brief onboarding process to explain the key features.

1. Read through the onboarding screens
2. Learn about the Option (⌥) hotkey
3. Understand the floating panel interface
4. Click "Get Started" or "Continue" to finish

Velox uses external speech-to-text (STT) services to convert your voice to text. You need to configure at least one provider before you can use the app.

We recommend starting with Groq:

• ✅ Completely free – 14,400 requests per day (no credit card required)
• ✅ 10x faster – Ultra-fast inference with Whisper
• ✅ Easy setup – Takes about 5 minutes

Other options:

• OpenAI: Requires paid API key, but very reliable
• Custom: Use any Whisper-compatible service (DeepSeek, Moonshot, local server, etc.)

Follow these steps to get a free Groq API key. This takes about 5 minutes.

1. Visit console.groq.com/keys
2. Sign up with your email, Google, or GitHub account (no credit card required)
3. Once logged in, click "Create API Key"
4. Give your key a name (e.g., "Velox")
5. Copy the API key (starts with gsk_...)
6. Save it somewhere safe – you won't be able to see it again!

Now let's add your Groq API key to Velox so you can start using voice input.

1. Click the Velox icon in your menu bar
2. Select "Settings" from the dropdown menu
3. Go to the "Speech to Text" tab
4. In the "Provider" dropdown, select "Groq"
5. Paste your API key in the "API Key" field
6. The Base URL and Model are pre-configured:
   • Base URL: https://api.groq.com/openai/v1
   • Model: whisper-large-v3
7. Click "Test Connection" to verify everything works
8. If successful, you'll see a green checkmark ✅

Velox can use a Large Language Model (LLM) to improve your transcriptions by fixing grammar, adding punctuation, and making the text more natural. This step is optional but highly recommended.

1. In Settings, go to the "Refinement" tab
2. Select your preferred LLM provider:
   • OpenAI: GPT-4o Mini (recommended), GPT-4, or GPT-3.5
   • Groq: Fast and free (use the same API key as STT)
   • Custom: Any OpenAI-compatible service
3. Enter your API key
4. Choose a model:
   • gpt-4o-mini for OpenAI (recommended - fast and cost-effective)
   • llama-3.1-70b-versatile for Groq (free)
5. Click "Test Connection"

Before trying your first voice input, let's set up a simple test environment.

1. Open a text editor (e.g., Notes, TextEdit, or any app)
2. Create a new document or note
3. Click inside the text area to make sure it's focused
4. Make sure your microphone is working (check the input level in System Settings)

Now let's try your first voice input using the Option (⌥) key.

1. Press and hold the Option (⌥) key on your keyboard
   • On most Mac keyboards, this is next to the Command (⌘) key
   • Some keyboards label it as "Alt"
2. The Velox floating panel will appear near the bottom of your screen
3. You'll see a red pulsing indicator showing that recording has started
4. The panel will show "Listening..." with a timer

While holding the Option key, speak your message clearly into the microphone.

Try this sample text for your first test:

"This is my first voice input with Velox. I'm testing the speech to text feature and it's working great!"

Tips for better results:

• Speak at a normal pace (not too fast or too slow)
• Use your natural voice – no need to over-enunciate
• Speak in complete sentences when possible
• Pause briefly between sentences
• Keep background noise to a minimum

When you're done speaking, release the Option key to stop recording and start processing.

1. Release the Option (⌥) key
2. The panel will change to show "Processing..."
3. Velox will:
   • Convert your speech to text (using Groq Whisper)
   • Clean up the transcription (remove filler words, fix obvious errors)
   • Apply light grammar and punctuation corrections (if LLM is configured)
4. This typically takes 1-3 seconds depending on your provider and audio length

Once processing is complete, Velox will automatically paste the transcribed text into your active app.

What happens next:

1. The transcribed text appears in the panel for a moment
2. If the app focus hasn't changed, Velox automatically:
   • Saves your current clipboard (so you don't lose what you copied)
   • Pastes the transcribed text using ⌘V
   • Restores your original clipboard after pasting
3. The panel shows a brief success message and fades out

• Option (⌥) – Hold to record, release to process
• ESC – Cancel current recording or processing

• Speak naturally: Use your normal speaking voice and pace
• Pause between thoughts: Brief pauses help with sentence detection
• Avoid filler words: "Um," "uh," "like" – Velox will try to remove these
• Spell out special characters: Say "comma," "period," "question mark"
• Use context: The LLM works better with complete sentences

Velox offers different writing styles to match your context. You can change this in Settings → Text Processing.

• Casual: Natural, conversational tone (default)
• Professional: More formal language for business communication
• Technical: Preserves technical terms and code-like syntax
• Minimal: Light corrections only, preserves your exact words

Velox uses a powerful dual-track language system that separates interface language from AI output language. This gives you maximum flexibility for multilingual workflows.

Interface Language (UI Language):

• Controls menus, buttons, and settings text
• Supports 7 languages: English, 简体中文, 繁體中文, 日本語, 한국어, Deutsch, Español
• Go to Settings → General → Interface Language
• Requires app restart to take effect

AI Output Language:

• Controls the language of transcription and AI refinement results
• Supports Simplified Chinese and Traditional Chinese as separate options
• Go to Settings → Text Processing → AI Output Language
• Takes effect immediately on next recording

Customize how Velox looks with independent appearance mode settings, separate from your system preferences.

• ☀️ Light Mode: Always use light appearance
• ◐ Follow System: Automatically match your macOS setting (default)
• 🌙 Dark Mode: Always use dark appearance

Go to Settings → General → Appearance to change this setting. The change takes effect immediately.

Velox provides a Dashboard with useful statistics to track your voice input journey.

Dashboard Statistics:

• Total Recordings: How many transcriptions you've completed
• AI Refined: How many times you used AI refinement
• Characters Transcribed: Total characters transcribed (displayed as 12.5K, 1.2M, etc.)
• Days with Velox: How many days since you first started using Velox

Open the main Velox window (click menu bar icon → Open Velox) to see your Dashboard.

Velox keeps a local history of your recent transcriptions for easy access.

1. Click the Velox menu bar icon
2. Select "Open Velox" to open the main window
3. Navigate to the "History" tab in the sidebar
4. Browse your recent transcriptions
5. Click any item to copy it to your clipboard
6. Use the search box to find specific transcriptions

Velox offers a 15-day free trial so you can fully test all features before purchasing.

• Trial Period: 15 days from first launch
• Full Features: All features are available during the trial
• One-Time Purchase: $4.99 USD for lifetime access
• No Subscription: Pay once, use forever
• Trial Status: Check remaining days in the menu bar or Settings