# Kyuuon Word Counter

A Python app that counts words spoken from an audio output source (e.g., Twitch stream via VB-Audio Cable) and displays them in a small GUI using DeerPyGui.

## Features
- Real-time word counting from any audio device (e.g., VB-Audio Cable)
- All Vosk and audio settings configurable in the GUI
- OBS-friendly background color for green-screening
- Settings saved to `config.ini`

## Setup

### 1. Clone or copy the project files

### 2. Create and activate a virtual environment (recommended)
```sh
python -m venv venv
# On Windows:
venv\Scripts\activate
# On macOS/Linux:
# source venv/bin/activate
```

### 3. Install dependencies
```sh
pip install -r requirements.txt
```

### 4. Download a Vosk model
- Download an English model from: https://alphacephei.com/vosk/models
- Extract it and set the model path in the app's settings tab (e.g., `./model`)

### 5. Run the app
```sh
python main.py
```

## Usage
- Select your audio device (e.g., VB-Audio Cable) in the settings tab.
- Adjust Vosk and UI settings as needed.
- The word count will update in real time.
- Save your settings to `config.ini` for future runs.

## Troubleshooting
- If you see `ModuleNotFoundError`, ensure your venv is activated and dependencies are installed.
- If you have audio device issues, check your system's sound settings and device indices in the settings tab.

---

**Enjoy your real-time word counter!**