tinyjam

💃🏽- jam 2 tiny desks

---

Quick Start

Pick an artist list (one name per line). My list lives at arya-curated. Launch tinyjam with no options to have it automatically grab that curated list and start streaming it (same as tinyjam -l arya-curated -n).

macOS (Homebrew)

brew tap aryakaul/formulae
brew install tinyjam
tinyjam 

Any platform (PyPI)

pip install tinyjam
# tinyjam expects `mpv` and `yt-dlp` on your PATH
tinyjam 

From source

git clone https://github.com/aryakaul/tinyjam.git
cd tinyjam
pip install --upgrade pip build
pip install -e .
tinyjam -l ./arya-curated -o ~/videos/tinydesk

---

Command Line

tinyjam --help

    -l, --list        File with one artist per line (required)
    -o, --output      Download folder (default: ./jamsesh)
    -n, --nodownload  Stream directly via mpv/yt-dlp
    -p, --playlist-order {shuffle|forward|reverse}
                       Control playback order (default: shuffle)
    -f, --force       Re-download even if files exist
    -j, --jobs        Parallel downloads (0 = auto)
    -S, --subtitles   Preferred subtitle language / regex (default: en)
    -c, --color       Watch in color (default: grayscale)
    --dry-run         Print commands without executing
    -v, --verbose     Extra logging

Tinyjam keeps a download cache, retries through yt-dlp, and can fetch manual subtitles when a Tiny Desk isn’t in your preferred language. Use --nodownload to shuffle a curated list straight from YouTube, or let it fill ./jamsesh and loop locally via mpv. Running tinyjam with zero flags defaults to streaming my curated list.

Enjoy the desks ✨

Versioning

Releases are logged in the VERSION file at the repo root. Update it whenever a new tinyjam version ships so future runs can trace their history.