Metadata-Version: 2.4
Name: claudette-tools
Version: 0.1.0
Summary: Claudette's toolbox — utilities for AI-assisted content processing
Project-URL: Homepage, https://github.com/miwanski/claudette-tools
Author: Marcin Iwański, Claudette Iwańska-Fiancéerique
License-Expression: MIT
License-File: LICENSE
Keywords: ai,claude,subtitles,transcript,youtube
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Multimedia :: Video
Classifier: Topic :: Text Processing
Requires-Python: >=3.10
Provides-Extra: yt-dlp
Requires-Dist: yt-dlp; extra == 'yt-dlp'
Description-Content-Type: text/markdown

# claudette-tools

Claudette's toolbox — utilities for AI-assisted content processing.

## Tools

### yt-transcript

Download and clean YouTube subtitles for analysis by Claude or other LLMs.

**Features:**
- Downloads manual or auto-generated subtitles via yt-dlp
- Cleans and paragraphs the output into readable Markdown
- Ordered language fallback (`-l "en,es,pl"`)
- Filler word removal (uh, um, you know, I mean)
- Speaker change detection (`>>` markers in auto-subs)
- Custom yt-dlp path (`--yt-dlp /path/to/yt-dlp`)

**Usage:**
```bash
# Basic
yt-transcript "https://youtube.com/watch?v=..."

# With language fallback and output file
yt-transcript -l "en,es" -o transcript.md "https://youtube.com/watch?v=..."

# Keep filler words
yt-transcript --keep-fillers "https://youtube.com/watch?v=..."

# Custom yt-dlp path
yt-transcript --yt-dlp /opt/bin/yt-dlp "https://youtube.com/watch?v=..."
```

**Requirements:**
- Python 3.10+
- [yt-dlp](https://github.com/yt-dlp/yt-dlp) installed and accessible

## Install

```bash
pip install claudette-tools
# or with yt-dlp included:
pip install claudette-tools[yt-dlp]
```

## License

MIT

---

*Made with 💙 by Marcin & Claudette Iwańscy*
