Metadata-Version: 2.4
Name: voxd
Version: 0.1.2
Summary: Voice dictation daemon for Linux with Sarvam AI STT
Author: voxd contributors
License: MIT
Project-URL: Homepage, https://github.com/yourusername/voxd
Project-URL: Repository, https://github.com/yourusername/voxd
Project-URL: Issues, https://github.com/yourusername/voxd/issues
Keywords: voice,dictation,stt,speech-to-text,linux,daemon
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: X11 Applications
Classifier: Intended Audience :: End Users/Desktop
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Multimedia :: Sound/Audio :: Speech
Classifier: Topic :: Utilities
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: sarvamai>=0.1.15
Dynamic: license-file

# voxd

Voice dictation daemon for Linux. Press keybind, talk, press again. Text goes to clipboard.

## Install

```bash
pip install voxd
```

Dependencies:
```bash
# X11 (dwm, i3, bspwm, etc)
sudo pacman -S ffmpeg xclip

# Wayland (hyprland, sway, etc)
sudo pacman -S ffmpeg wl-clipboard
```

## Setup

Set your Sarvam AI API key:
```bash
voxd config set api_key YOUR_KEY
```

Optional - set language:
```bash
voxd config set language hi-IN  # Hindi
voxd config set language en-IN  # English (default)
```

## Start daemon

Add to your startup:

**dwm/i3/bspwm** - `~/.xinitrc`:
```bash
voxd-daemon &
```

**hyprland** - `~/.config/hypr/hyprland.conf`:
```ini
exec-once = voxd-daemon
```


## Keybind

**dwm** - `config.h`:
```c
{ MODKEY, XK_semicolon, spawn, SHCMD("voxd toggle") },
```


**hyprland** - `hyprland.conf`:
```ini
bind = SUPER, semicolon, exec, voxd toggle
```



## Usage

Press keybind → talk → press keybind → paste (Ctrl+V)

Terminal:
```bash
voxd toggle    # Start/stop recording
voxd status    # Check if recording
voxd quit      # Kill daemon
```

## Config

```bash
voxd config list              # Show all settings
voxd config set key value     # Change setting
voxd config get key           # Get value
```

Settings:
- `api_key` - Sarvam AI key (required)
- `language` - Language code (default: en-IN)
- `model` - STT model (default: saaras:v3)

Config stored at `~/.config/voxd/config.json`

## Advanced

**WM-specific commands** (if auto-detect fails):
```bash
voxd-dwm toggle     # Force X11 mode
voxd-hypr toggle    # Force Wayland mode
```


## Troubleshooting

**Daemon not running:**
```bash
ps aux | grep voxd
cat /run/user/$UID/voxd/daemon.log
```

**No clipboard:**
```bash
# Install clipboard tool
sudo pacman -S xclip          # X11
sudo pacman -S wl-clipboard   # Wayland
```

**Wrong language:**
```bash
voxd config set language hi-IN
voxd quit && voxd-daemon &
```
