Metadata-Version: 2.4
Name: ttrans
Version: 0.1.0
Summary: macOS meeting transcription assistant with TUI
Project-URL: Homepage, https://github.com/adnichols/ttrans
Project-URL: Repository, https://github.com/adnichols/ttrans
Project-URL: Bug Tracker, https://github.com/adnichols/ttrans/issues
Author-email: Aaron Nichols <adnichols@users.noreply.github.com>
License-Expression: MIT
License-File: LICENSE
Keywords: audio,macos,meeting,transcription,tui,whisper
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: End Users/Desktop
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: MacOS :: MacOS X
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Multimedia :: Sound/Audio :: Capture/Recording
Classifier: Topic :: Multimedia :: Sound/Audio :: Speech
Requires-Python: >=3.11
Requires-Dist: mlx-whisper>=0.4.0
Requires-Dist: numpy>=2.3.5
Requires-Dist: openai>=2.8.1
Requires-Dist: pyobjc>=12.1
Requires-Dist: scipy>=1.11.0
Requires-Dist: sounddevice>=0.5.3
Requires-Dist: textual>=6.7.1
Requires-Dist: tomli-w>=1.2.0
Description-Content-Type: text/markdown

# ttrans

A macOS meeting transcription assistant with a Terminal User Interface (TUI). Captures audio from microphone and/or system audio, transcribes speech using local ML models (Whisper via MLX), and generates AI-powered meeting summaries.

## Requirements

- macOS 12.3+ (Monterey or later)
- Apple Silicon (M1, M2, M3, etc.)
- Python 3.11+

## Installation

### From Homebrew (recommended)
```bash
brew tap adnichols/ttrans
brew install ttrans
```

### From Source
```bash
git clone https://github.com/adnichols/ttrans
cd ttrans
uv sync
uv run ttrans
```

## Usage

```bash
# Launch the TUI
ttrans

# Show version
ttrans --version

# Pre-download a specific model
ttrans --download-model small
```

## Permissions

ttrans requires the following macOS permissions:

1. **Screen Recording** - Add your terminal app (Terminal.app, iTerm2, etc.) in System Settings > Privacy & Security > Screen Recording
2. **Microphone** - Add your terminal app in System Settings > Privacy & Security > Microphone

## First Run

On first run, ttrans will download the default Whisper model (base, ~150MB). This is stored in `~/.cache/huggingface/`.

### Available Models

- `tiny`: ~75MB (fastest, less accurate)
- `base`: ~150MB (default, balanced)
- `small`: ~500MB
- `medium`: ~1.5GB
- `large`: ~3GB (slowest, most accurate)
- `turbo`: ~150MB

To pre-download a specific model:
```bash
ttrans --download-model small
```

## Configuration

- Configuration file: `~/.ttrans` (TOML format)
- Transcripts directory: `~/Documents/Transcripts/`

## Key Bindings

- `r` - Start recording
- `space` - Stop recording
- `s` - Settings
- `a` - Audio sources
- `t` - Transcript browser
- `d` - Focus device selector
- `j/k` - Scroll transcript
- `q` - Quit

## License

MIT License - see LICENSE file for details
