Video, audio, direct files, and private cloud documents. The URL source is auto-detected, so you never pick a mode yourself. Anonymous over Tor by default, results land in ~/Downloads.

Quick start

pip install jackthesolo

jackthesolo "URL"

Or from source (for development):

git clone https://github.com/Araryarch67/jackthesolo && cd jackthesolo
make install    # via pipx (needs python>=3.9, ffmpeg)
make browsers   # chromium for cloud mode, one time only
sudo systemctl enable --now tor   # mandatory anonymity route, one time only

jackthesolo "URL"

Examples

jackthesolo "URL"                                            # anything, auto-detected
jackthesolo "https://www.tiktok.com/@u/video/123" --cookies cookies.txt  # incl. subs-only + photos
jackthesolo "https://www.youtube.com/watch?v=..." --cookies yt_cookies.txt  # required for age-restricted videos
jackthesolo "https://www.scribd.com/document/123/Title"          # to PDF, no login
jackthesolo "https://…/shared?..." --cookies cookies.txt --output-file Document.pdf
jackthesolo "URL" -a                                         # audio MP3 only
jackthesolo "URL" --info                                     # inspect first, free
jackthesolo --check                                          # diagnostics (incl. Tor egress proof)

Cookies

Login-gated content needs your own cookies (the program ships none):

# 1. Open the site in Chrome, logged in
# 2. Export with the "Get cookies.txt LOCALLY" extension (pick the site domain)
jackthesolo "URL" --cookies cookies.txt
chmod 600 cookies.txt

Never commit or share cookie files. Age-restricted YouTube always needs cookies from an age-verified account (the server issues no stream URLs before login, verified across web, android, ios, TV, and embed clients).

Anonymity

Public downloads without Tor/proxy are refused. Every download uses a fresh isolated Tor circuit, a randomized user agent, redacted tokens in logs (including -v), and cookie files auto-locked to 600. --paranoid fails closed on IP leaks; --url-file URL.txt keeps tokens out of shell history.

Honest limits: logging in identifies your account to the server; exit nodes see plaintext HTTP traffic.

Help

man jackthesolo            # full docs (via `make man`)
jackthesolo --check

Options

Found a link that fails? Open an issue with the link type (no tokens/cookies) plus the -v error output. MIT licensed (see LICENSE). Use it for content you own or are entitled to access, and respect each site's terms.

Credits

Techniques in this tool build on other people's work:

• Scribd engine (embed + per-page print + pypdf merge) adapted from themrsami/scribd-downloader (MIT licensed).
• Media mode uses yt-dlp (Unlicense).