# PodX - Offline Podcast + Docs Unified Search (Docker)

## Quick start
```bash
unzip homelab-podx.zip && cd homelab-podx
docker compose up -d --build
# Open the UI:
#   http://<your-host>:8088
```

Paste links to podcasts/video (YouTube, Rumble, direct MP3). Worker downloads with yt-dlp, transcribes locally with faster-whisper large-v3, stores media under library/, subtitles and transcripts under transcripts/, and indexes everything (plus your PDFs/EPUBs/Kiwix) in a single Meilisearch index: library.

### Ingest PDFs
```bash
MEILI_URL=http://localhost:7700 MEILI_KEY=devkey ./ingest/ingest_pdfs.sh /path/to/*.pdf
```

### Ingest EPUBs
```bash
pip install ebooklib beautifulsoup4 lxml requests
MEILI_URL=http://localhost:7700 MEILI_KEY=devkey ./ingest/ingest_epub.py /path/to/*.epub
```

### Ingest Kiwix ZIM
Install zim-tools: apt-get install zim-tools or brew install zimtools
```bash
MEILI_URL=http://localhost:7700 MEILI_KEY=devkey ./ingest/ingest_kiwix.sh /path/to/wikipedia_en.zim
```

### Optional: set Meilisearch settings
```bash
curl -X PATCH "http://localhost:7700/indexes/library/settings"  -H "Authorization: Bearer devkey" -H "Content-Type: application/json"  -d '{"searchableAttributes":["title","text","meta.book_author","meta.uploader","meta.chapter"],
      "displayedAttributes":["type","title","source","date","_formatted","meta"],
      "sortableAttributes":["date","type"],
      "filterableAttributes":["type"]}'
```

### Plex
Point Plex libraries at library/. Video podcasts will show .srt/.vtt subtitles automatically if basenames match.

### Notes
- Accuracy-first: model large-v3 (English + Czech). Change via WHISPER_MODEL env var in docker-compose.yml if desired.
- Everything runs offline; no cloud calls.