Metadata-Version: 2.4
Name: jackthesolo
Version: 0.1.0
Summary: jackthesolo - downloader semua platform (video, musik, file, cloud-drive)
License: MIT
Project-URL: Homepage, https://github.com/Araryarch67/jackthesolo
Project-URL: Repository, https://github.com/Araryarch67/jackthesolo
Keywords: downloader,youtube,tiktok,tor,cli
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: End Users/Desktop
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Internet :: WWW/HTTP
Classifier: Topic :: Multimedia :: Video
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: yt-dlp>=2024.1.1
Requires-Dist: requests>=2.31
Requires-Dist: PySocks>=1.7
Requires-Dist: playwright>=1.40
Requires-Dist: curl-cffi>=0.11
Dynamic: license-file

# jackthesolo

![Python](https://img.shields.io/badge/python-%3E%3D3.9-blue)
![Platform](https://img.shields.io/badge/platform-linux-lightgrey)

```
     _   _    ____ _  _______ _   _ _____ ____   ___  _     ___
    | | / \  / ___| |/ /_   _| | | | ____/ ___| / _ \| |   / _ \
 _  | |/ _ \| |   | ' /  | | | |_| |  _| \___ \| | | | |  | | | |
| |_| / ___ \ |___| . \  | | |  _  | |___ ___) | |_| | |__| |_| |
 \___/_/   \_\____|_|\_\ |_| |_| |_|_____|____/ \___/|_____\___/
```

**Satu perintah untuk download hampir apa saja. Tempel URL, beres.**

Video, musik, file, dokumen cloud privat — URL-nya dikenali otomatis.
Anonim via Tor secara default, hasil rapi di `~/Downloads`.

| Bisa apa | Contoh |
|---|---|
| Video/musik (YouTube, TikTok) | `tiktok.com/@u/video/…` |
| Situs lain via yt-dlp (belum dites satu-satu) | URL apa saja |
| File langsung (PDF, ZIP, ISO, MP4) | `example.com/laporan.pdf` |
| Dokumen cloud privat (link preview/share) | `…/shared?…` + cookies-mu |

## Mulai

```bash
git clone https://github.com/Araryarch67/jackthesolo && cd jackthesolo
make install    # jadi aplikasi CLI via pipx (butuh python>=3.9, ffmpeg)
make browsers   # chromium untuk mode cloud, sekali saja
sudo systemctl enable --now tor   # rute anonim wajib, sekali saja

jackthesolo "URL"
```

## Contoh

```bash
jackthesolo "URL"                                            # apa saja, auto-detect
jackthesolo "https://www.tiktok.com/@u/video/123" --cookies cookies.txt  # termasuk subs-only + foto
jackthesolo "https://www.youtube.com/watch?v=..." --cookies yt_cookies.txt  # wajib untuk video batas umur
jackthesolo "https://…/shared?..." --cookies cookies.txt --output-file Dokumen.pdf
jackthesolo "URL" -a                                         # audio MP3 saja
jackthesolo "URL" --info                                     # intip dulu, gratis
jackthesolo --check                                          # diagnosa (termasuk bukti IP Tor)
```

## Cookies

Konten login butuh cookies **milikmu** (program tidak membawa apa pun):

```bash
# 1. Buka situsnya di Chrome yang sudah login
# 2. Export via extension "Get cookies.txt LOCALLY" (pilih domain situsnya)
jackthesolo "URL" --cookies cookies.txt
chmod 600 cookies.txt
```

Jangan commit/share file cookies. YouTube batas umur selalu butuh cookies
akun yang lolos umur (server tidak menerbitkan stream sebelum login).

## Anonimitas

Download publik tanpa Tor/proxy langsung **ditolak**. Tiap download pakai
circuit Tor fresh yang terisolasi, UA acak, token disensor di log
(termasuk `-v`), cookies dikunci `600` otomatis. `--paranoid` gagal-closed
bila IP bocor; `--url-file URL.txt` agar token tidak nyangkut di history.

Batas jujur: login = server tahu akunmu; exit-node melihat trafik HTTP polos.

## Bantuan

```bash
man jackthesolo            # dokumentasi lengkap (via `make man`)
jackthesolo --check
```

| Gejala | Obatnya |
|---|---|
| `Link ini butuh login` | tambah `--cookies` |
| YouTube minta verifikasi umur | pakai `--cookies` akun yang lolos umur |
| `HTTP 401/403` | export ulang cookies |
| Tor tidak berefek | `sudo systemctl start tor`, cek `--check` |

## Opsi

| Flag | Fungsi |
|---|---|
| `-o` | folder output (default: `~/Downloads`) |
| `-a` / `-q` | audio MP3 saja / kualitas (`best`, `720`, …) |
| `--cookies` | path cookies.txt milikmu |
| `--proxy` / `--tor` / `--no-proxy` | rute koneksi (default: Tor, wajib) |
| `--paranoid` / `--url-file` | bukti egress + tolak login / URL dari file |
| `--cloud` / `--direct` | paksa mode bila auto-detect salah |
| `--output-file` / `--info` | nama file / intip metadata |
| `--no-banner` / `-v` / `--check` | tanpa banner / verbose / diagnosa |

Ketemu link gagal? Buka issue sertakan jenis linknya (tanpa token/cookies)
+ pesan error `-v`. Lisensi MIT (lihat `LICENSE`). Pakai
untuk konten milikmu dan patuhi syarat tiap situs.
