jackthesolo 0.1.0__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2026 jackthesolo contributors
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
@@ -0,0 +1,127 @@
1
+ Metadata-Version: 2.4
2
+ Name: jackthesolo
3
+ Version: 0.1.0
4
+ Summary: jackthesolo - downloader semua platform (video, musik, file, cloud-drive)
5
+ License: MIT
6
+ Project-URL: Homepage, https://github.com/Araryarch67/jackthesolo
7
+ Project-URL: Repository, https://github.com/Araryarch67/jackthesolo
8
+ Keywords: downloader,youtube,tiktok,tor,cli
9
+ Classifier: Development Status :: 4 - Beta
10
+ Classifier: Environment :: Console
11
+ Classifier: Intended Audience :: End Users/Desktop
12
+ Classifier: License :: OSI Approved :: MIT License
13
+ Classifier: Operating System :: POSIX :: Linux
14
+ Classifier: Programming Language :: Python :: 3
15
+ Classifier: Topic :: Internet :: WWW/HTTP
16
+ Classifier: Topic :: Multimedia :: Video
17
+ Requires-Python: >=3.9
18
+ Description-Content-Type: text/markdown
19
+ License-File: LICENSE
20
+ Requires-Dist: yt-dlp>=2024.1.1
21
+ Requires-Dist: requests>=2.31
22
+ Requires-Dist: PySocks>=1.7
23
+ Requires-Dist: playwright>=1.40
24
+ Requires-Dist: curl-cffi>=0.11
25
+ Dynamic: license-file
26
+
27
+ # jackthesolo
28
+
29
+ ![Python](https://img.shields.io/badge/python-%3E%3D3.9-blue)
30
+ ![Platform](https://img.shields.io/badge/platform-linux-lightgrey)
31
+
32
+ ```
33
+ _ _ ____ _ _______ _ _ _____ ____ ___ _ ___
34
+ | | / \ / ___| |/ /_ _| | | | ____/ ___| / _ \| | / _ \
35
+ _ | |/ _ \| | | ' / | | | |_| | _| \___ \| | | | | | | | |
36
+ | |_| / ___ \ |___| . \ | | | _ | |___ ___) | |_| | |__| |_| |
37
+ \___/_/ \_\____|_|\_\ |_| |_| |_|_____|____/ \___/|_____\___/
38
+ ```
39
+
40
+ **Satu perintah untuk download hampir apa saja. Tempel URL, beres.**
41
+
42
+ Video, musik, file, dokumen cloud privat — URL-nya dikenali otomatis.
43
+ Anonim via Tor secara default, hasil rapi di `~/Downloads`.
44
+
45
+ | Bisa apa | Contoh |
46
+ |---|---|
47
+ | Video/musik (YouTube, TikTok) | `tiktok.com/@u/video/…` |
48
+ | Situs lain via yt-dlp (belum dites satu-satu) | URL apa saja |
49
+ | File langsung (PDF, ZIP, ISO, MP4) | `example.com/laporan.pdf` |
50
+ | Dokumen cloud privat (link preview/share) | `…/shared?…` + cookies-mu |
51
+
52
+ ## Mulai
53
+
54
+ ```bash
55
+ git clone https://github.com/Araryarch67/jackthesolo && cd jackthesolo
56
+ make install # jadi aplikasi CLI via pipx (butuh python>=3.9, ffmpeg)
57
+ make browsers # chromium untuk mode cloud, sekali saja
58
+ sudo systemctl enable --now tor # rute anonim wajib, sekali saja
59
+
60
+ jackthesolo "URL"
61
+ ```
62
+
63
+ ## Contoh
64
+
65
+ ```bash
66
+ jackthesolo "URL" # apa saja, auto-detect
67
+ jackthesolo "https://www.tiktok.com/@u/video/123" --cookies cookies.txt # termasuk subs-only + foto
68
+ jackthesolo "https://www.youtube.com/watch?v=..." --cookies yt_cookies.txt # wajib untuk video batas umur
69
+ jackthesolo "https://…/shared?..." --cookies cookies.txt --output-file Dokumen.pdf
70
+ jackthesolo "URL" -a # audio MP3 saja
71
+ jackthesolo "URL" --info # intip dulu, gratis
72
+ jackthesolo --check # diagnosa (termasuk bukti IP Tor)
73
+ ```
74
+
75
+ ## Cookies
76
+
77
+ Konten login butuh cookies **milikmu** (program tidak membawa apa pun):
78
+
79
+ ```bash
80
+ # 1. Buka situsnya di Chrome yang sudah login
81
+ # 2. Export via extension "Get cookies.txt LOCALLY" (pilih domain situsnya)
82
+ jackthesolo "URL" --cookies cookies.txt
83
+ chmod 600 cookies.txt
84
+ ```
85
+
86
+ Jangan commit/share file cookies. YouTube batas umur selalu butuh cookies
87
+ akun yang lolos umur (server tidak menerbitkan stream sebelum login).
88
+
89
+ ## Anonimitas
90
+
91
+ Download publik tanpa Tor/proxy langsung **ditolak**. Tiap download pakai
92
+ circuit Tor fresh yang terisolasi, UA acak, token disensor di log
93
+ (termasuk `-v`), cookies dikunci `600` otomatis. `--paranoid` gagal-closed
94
+ bila IP bocor; `--url-file URL.txt` agar token tidak nyangkut di history.
95
+
96
+ Batas jujur: login = server tahu akunmu; exit-node melihat trafik HTTP polos.
97
+
98
+ ## Bantuan
99
+
100
+ ```bash
101
+ man jackthesolo # dokumentasi lengkap (via `make man`)
102
+ jackthesolo --check
103
+ ```
104
+
105
+ | Gejala | Obatnya |
106
+ |---|---|
107
+ | `Link ini butuh login` | tambah `--cookies` |
108
+ | YouTube minta verifikasi umur | pakai `--cookies` akun yang lolos umur |
109
+ | `HTTP 401/403` | export ulang cookies |
110
+ | Tor tidak berefek | `sudo systemctl start tor`, cek `--check` |
111
+
112
+ ## Opsi
113
+
114
+ | Flag | Fungsi |
115
+ |---|---|
116
+ | `-o` | folder output (default: `~/Downloads`) |
117
+ | `-a` / `-q` | audio MP3 saja / kualitas (`best`, `720`, …) |
118
+ | `--cookies` | path cookies.txt milikmu |
119
+ | `--proxy` / `--tor` / `--no-proxy` | rute koneksi (default: Tor, wajib) |
120
+ | `--paranoid` / `--url-file` | bukti egress + tolak login / URL dari file |
121
+ | `--cloud` / `--direct` | paksa mode bila auto-detect salah |
122
+ | `--output-file` / `--info` | nama file / intip metadata |
123
+ | `--no-banner` / `-v` / `--check` | tanpa banner / verbose / diagnosa |
124
+
125
+ Ketemu link gagal? Buka issue sertakan jenis linknya (tanpa token/cookies)
126
+ + pesan error `-v`. Lisensi MIT (lihat `LICENSE`). Pakai
127
+ untuk konten milikmu dan patuhi syarat tiap situs.
@@ -0,0 +1,101 @@
1
+ # jackthesolo
2
+
3
+ ![Python](https://img.shields.io/badge/python-%3E%3D3.9-blue)
4
+ ![Platform](https://img.shields.io/badge/platform-linux-lightgrey)
5
+
6
+ ```
7
+ _ _ ____ _ _______ _ _ _____ ____ ___ _ ___
8
+ | | / \ / ___| |/ /_ _| | | | ____/ ___| / _ \| | / _ \
9
+ _ | |/ _ \| | | ' / | | | |_| | _| \___ \| | | | | | | | |
10
+ | |_| / ___ \ |___| . \ | | | _ | |___ ___) | |_| | |__| |_| |
11
+ \___/_/ \_\____|_|\_\ |_| |_| |_|_____|____/ \___/|_____\___/
12
+ ```
13
+
14
+ **Satu perintah untuk download hampir apa saja. Tempel URL, beres.**
15
+
16
+ Video, musik, file, dokumen cloud privat — URL-nya dikenali otomatis.
17
+ Anonim via Tor secara default, hasil rapi di `~/Downloads`.
18
+
19
+ | Bisa apa | Contoh |
20
+ |---|---|
21
+ | Video/musik (YouTube, TikTok) | `tiktok.com/@u/video/…` |
22
+ | Situs lain via yt-dlp (belum dites satu-satu) | URL apa saja |
23
+ | File langsung (PDF, ZIP, ISO, MP4) | `example.com/laporan.pdf` |
24
+ | Dokumen cloud privat (link preview/share) | `…/shared?…` + cookies-mu |
25
+
26
+ ## Mulai
27
+
28
+ ```bash
29
+ git clone https://github.com/Araryarch67/jackthesolo && cd jackthesolo
30
+ make install # jadi aplikasi CLI via pipx (butuh python>=3.9, ffmpeg)
31
+ make browsers # chromium untuk mode cloud, sekali saja
32
+ sudo systemctl enable --now tor # rute anonim wajib, sekali saja
33
+
34
+ jackthesolo "URL"
35
+ ```
36
+
37
+ ## Contoh
38
+
39
+ ```bash
40
+ jackthesolo "URL" # apa saja, auto-detect
41
+ jackthesolo "https://www.tiktok.com/@u/video/123" --cookies cookies.txt # termasuk subs-only + foto
42
+ jackthesolo "https://www.youtube.com/watch?v=..." --cookies yt_cookies.txt # wajib untuk video batas umur
43
+ jackthesolo "https://…/shared?..." --cookies cookies.txt --output-file Dokumen.pdf
44
+ jackthesolo "URL" -a # audio MP3 saja
45
+ jackthesolo "URL" --info # intip dulu, gratis
46
+ jackthesolo --check # diagnosa (termasuk bukti IP Tor)
47
+ ```
48
+
49
+ ## Cookies
50
+
51
+ Konten login butuh cookies **milikmu** (program tidak membawa apa pun):
52
+
53
+ ```bash
54
+ # 1. Buka situsnya di Chrome yang sudah login
55
+ # 2. Export via extension "Get cookies.txt LOCALLY" (pilih domain situsnya)
56
+ jackthesolo "URL" --cookies cookies.txt
57
+ chmod 600 cookies.txt
58
+ ```
59
+
60
+ Jangan commit/share file cookies. YouTube batas umur selalu butuh cookies
61
+ akun yang lolos umur (server tidak menerbitkan stream sebelum login).
62
+
63
+ ## Anonimitas
64
+
65
+ Download publik tanpa Tor/proxy langsung **ditolak**. Tiap download pakai
66
+ circuit Tor fresh yang terisolasi, UA acak, token disensor di log
67
+ (termasuk `-v`), cookies dikunci `600` otomatis. `--paranoid` gagal-closed
68
+ bila IP bocor; `--url-file URL.txt` agar token tidak nyangkut di history.
69
+
70
+ Batas jujur: login = server tahu akunmu; exit-node melihat trafik HTTP polos.
71
+
72
+ ## Bantuan
73
+
74
+ ```bash
75
+ man jackthesolo # dokumentasi lengkap (via `make man`)
76
+ jackthesolo --check
77
+ ```
78
+
79
+ | Gejala | Obatnya |
80
+ |---|---|
81
+ | `Link ini butuh login` | tambah `--cookies` |
82
+ | YouTube minta verifikasi umur | pakai `--cookies` akun yang lolos umur |
83
+ | `HTTP 401/403` | export ulang cookies |
84
+ | Tor tidak berefek | `sudo systemctl start tor`, cek `--check` |
85
+
86
+ ## Opsi
87
+
88
+ | Flag | Fungsi |
89
+ |---|---|
90
+ | `-o` | folder output (default: `~/Downloads`) |
91
+ | `-a` / `-q` | audio MP3 saja / kualitas (`best`, `720`, …) |
92
+ | `--cookies` | path cookies.txt milikmu |
93
+ | `--proxy` / `--tor` / `--no-proxy` | rute koneksi (default: Tor, wajib) |
94
+ | `--paranoid` / `--url-file` | bukti egress + tolak login / URL dari file |
95
+ | `--cloud` / `--direct` | paksa mode bila auto-detect salah |
96
+ | `--output-file` / `--info` | nama file / intip metadata |
97
+ | `--no-banner` / `-v` / `--check` | tanpa banner / verbose / diagnosa |
98
+
99
+ Ketemu link gagal? Buka issue sertakan jenis linknya (tanpa token/cookies)
100
+ + pesan error `-v`. Lisensi MIT (lihat `LICENSE`). Pakai
101
+ untuk konten milikmu dan patuhi syarat tiap situs.
@@ -0,0 +1,6 @@
1
+ """jackthesolo - multi-platform downloader (YouTube, TikTok, IG, X, dll)."""
2
+
3
+ __version__ = "0.1.0"
4
+ __all__ = ["JackDownloader"]
5
+
6
+ from .downloader import JackDownloader
@@ -0,0 +1,4 @@
1
+ from .cli import main
2
+
3
+ if __name__ == "__main__":
4
+ raise SystemExit(main())