Why StarDown?

Stars are bookmarks. Bookmarks rot. Repos get deleted, renamed, DMCA'd, or force-pushed into oblivion. StarDown turns your star list into a local archive — snapshots or full git clones, pulled down in parallel with a gorgeous live dashboard.

• ⚡ Async engine — one shared HTTP session, bounded concurrency, 128 KiB streaming chunks, atomic writes, auto-resume
• 📊 Rich live progress — per-repo bars with speed + ETA, plus a global counter (plain fallback in pipes/CI)
• 🎯 Two download modes — tar snapshots (fast, tiny) or git clones (full history)
• 🔎 Filter before you pull — by language, topic, search text, forks, archived
• 🔑 Auth-aware — token support for private stars + 30x the rate limit
• 🪶 Zero friction — one command install, double-click launchers included

Install

pip install -e .

That's it. You now own the stardown command everywhere.

No install? No problem — use the zero-setup launchers (they fetch deps on first run):

.\run.bat download --user octocat

./run.sh download --user octocat

Quickstart

# Peek at your stars in a pretty table
stardown list --user octocat

# Archive them all — fast snapshots, 16 at a time
stardown download --user octocat --out stars

# Just your Python CLI obsessions, as JSON
stardown list --user octocat --language python --topic cli --format json --out stars.json

# Your own stars via token (also unlocks private repos)
export GH_TOKEN=ghp_...
stardown download --me --out stars

Usage

stardown list --user NAME [--me] [--language LANG] [--topic TOPIC]
              [--search TEXT] [--no-forks] [--no-archived] [--limit N]
              [--format table|json|csv] [--out FILE]

stardown download --user NAME [--out DIR] [--method tar|git]
                  [--workers 16] [--keep-tar] [--no-extract] [--force]
                  [--ssh] [--full] [--no-progress] [filters...]

Auth: you probably don't need to think about it. StarDown takes --token if you hand it one, else $GH_TOKEN, else it quietly checks your gh login and git's own credential store — and tells you when it finds something. No login anywhere? It goes anonymous (60 API calls/hr instead of 5,000). --no-auto-auth skips the snooping.

Under the hood

• Single httpx.AsyncClient with keepalive reuse (fewer handshakes, fewer FDs)
• Semaphore-bounded concurrency — fast without tripping EMFILE
• Crash-safe writes: stream to .part, resume with Range, atomic os.replace on completion
• Blocking tar extraction offloaded to a thread so the event loop never stalls
• uvloop auto-engaged on Linux when installed (pip install -e .[linux])
• Sync git path kept in clone.py as the simple fallback

Dev

pip install -e .[test]
python -m pytest tests/ -q

src/stardown/      api.py · async_download.py · clone.py · cli.py · ui.py
tests/             offline unit tests (no network)
run.bat · run.sh   zero-install launchers

Credits

Built by wydyippee ★ — for folk who star first and read later.

License

MIT — see LICENSE. StarDown save your sources? Smash that star. 🌟