gold-dl 0.0.1__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.
Files changed (26) hide show
  1. gold_dl-0.0.1/LICENSE +21 -0
  2. gold_dl-0.0.1/MANIFEST.in +2 -0
  3. gold_dl-0.0.1/PKG-INFO +193 -0
  4. gold_dl-0.0.1/README.md +139 -0
  5. gold_dl-0.0.1/gold_dl.egg-info/PKG-INFO +193 -0
  6. gold_dl-0.0.1/gold_dl.egg-info/SOURCES.txt +24 -0
  7. gold_dl-0.0.1/gold_dl.egg-info/dependency_links.txt +1 -0
  8. gold_dl-0.0.1/gold_dl.egg-info/entry_points.txt +2 -0
  9. gold_dl-0.0.1/gold_dl.egg-info/requires.txt +8 -0
  10. gold_dl-0.0.1/gold_dl.egg-info/top_level.txt +1 -0
  11. gold_dl-0.0.1/pyutube/__init__.py +18 -0
  12. gold_dl-0.0.1/pyutube/__main__.py +12 -0
  13. gold_dl-0.0.1/pyutube/cli.py +188 -0
  14. gold_dl-0.0.1/pyutube/handlers/PlaylistHandler.py +143 -0
  15. gold_dl-0.0.1/pyutube/handlers/URLHandler.py +121 -0
  16. gold_dl-0.0.1/pyutube/handlers/__init__.py +4 -0
  17. gold_dl-0.0.1/pyutube/services/AudioService.py +27 -0
  18. gold_dl-0.0.1/pyutube/services/DownloadService.py +157 -0
  19. gold_dl-0.0.1/pyutube/services/FileService.py +93 -0
  20. gold_dl-0.0.1/pyutube/services/VideoService.py +110 -0
  21. gold_dl-0.0.1/pyutube/services/__init__.py +7 -0
  22. gold_dl-0.0.1/pyutube/tests/__init__.py +1 -0
  23. gold_dl-0.0.1/pyutube/tests/test_utils.py +103 -0
  24. gold_dl-0.0.1/pyutube/utils.py +334 -0
  25. gold_dl-0.0.1/setup.cfg +4 -0
  26. gold_dl-0.0.1/setup.py +112 -0
gold_dl-0.0.1/LICENSE ADDED
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) [2024] [Ebraheem Alhetari]
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.
gold_dl-0.0.1/MANIFEST.in ADDED
@@ -0,0 +1,2 @@
1
+ include LICENSE
2
+ include README.md
gold_dl-0.0.1/PKG-INFO ADDED
@@ -0,0 +1,193 @@
1
+ Metadata-Version: 2.4
2
+ Name: gold-dl
3
+ Version: 0.0.1
4
+ Summary: High performance CLI YouTube downloader (video / audio / shorts / playlists) with smart caching and auto quality handling
5
+ Author: VOLT5775
6
+ Author-email: VOLT5775@users.noreply.github.com
7
+ License: MIT
8
+ Project-URL: Homepage, https://github.com/VOLT5775/VoLTGoLD-YT
9
+ Project-URL: Source Code, https://github.com/VOLT5775/VoLTGoLD-YT
10
+ Project-URL: Bug Tracker, https://github.com/VOLT5775/VoLTGoLD-YT/issues
11
+ Project-URL: Documentation, https://github.com/VOLT5775/VoLTGoLD-YT
12
+ Project-URL: Author, https://github.com/VOLT5775
13
+ Keywords: youtube,download,cli,pyutube,voltgold,yt-downloader,pytubefix,pytube,youtube-dl
14
+ Platform: Linux
15
+ Platform: Windows
16
+ Platform: MacOS
17
+ Classifier: License :: OSI Approved :: MIT License
18
+ Classifier: Operating System :: OS Independent
19
+ Classifier: Programming Language :: Python :: 3
20
+ Classifier: Programming Language :: Python :: 3.6
21
+ Classifier: Programming Language :: Python :: 3.7
22
+ Classifier: Programming Language :: Python :: 3.8
23
+ Classifier: Programming Language :: Python :: 3.9
24
+ Classifier: Programming Language :: Python :: 3.10
25
+ Classifier: Programming Language :: Python :: 3.11
26
+ Classifier: Programming Language :: Python :: 3.12
27
+ Classifier: Programming Language :: Python :: 3.13
28
+ Classifier: Topic :: Multimedia :: Video
29
+ Classifier: Topic :: Utilities
30
+ Requires-Python: >=3.6
31
+ Description-Content-Type: text/markdown
32
+ License-File: LICENSE
33
+ Requires-Dist: pytubefix>=0.4.0
34
+ Requires-Dist: inquirer>=3.0.0
35
+ Requires-Dist: yaspin>=3.0.0
36
+ Requires-Dist: typer>=0.9.0
37
+ Requires-Dist: requests>=2.28.0
38
+ Requires-Dist: rich>=13.0.0
39
+ Requires-Dist: termcolor>=2.0.0
40
+ Requires-Dist: moviepy>=1.0.0
41
+ Dynamic: author
42
+ Dynamic: author-email
43
+ Dynamic: classifier
44
+ Dynamic: description
45
+ Dynamic: description-content-type
46
+ Dynamic: keywords
47
+ Dynamic: license
48
+ Dynamic: license-file
49
+ Dynamic: platform
50
+ Dynamic: project-url
51
+ Dynamic: requires-dist
52
+ Dynamic: requires-python
53
+ Dynamic: summary
54
+
55
+ # 📹 gold-dl - The Simplest YouTube Downloader CLI
56
+ # Telegram User Dev ~ @CB6BB
57
+
58
+ ### Enjoying my project? Please show your appreciation by starring it on GitHub! ⭐
59
+
60
+
61
+
62
+ <br />
63
+ <br />
64
+
65
+ > [!NOTE] > `gold-dl` is built on top of `pytubefix`, make sure to have the latest version of `pytubefix` by running:
66
+ >
67
+ > ```bash
68
+ > pip install --upgrade pytubefix
69
+ > ```
70
+
71
+ <a href="https://ibb.co/Q3yRhBsg">
72
+ <img src="https://i.ibb.co/Hf5sRvmS/IMG-20251120-013217-680.jpg"
73
+ alt="Pyutube"
74
+ style="width: 100%;"
75
+ border="0">
76
+ </a>
77
+
78
+ > [!NOTE]
79
+ > Have **a new feature**? Please don't hesitate to [tell me](https://github.com/VOLT5775/VoLTGoLD-YT)!
80
+
81
+ ## 🤔 why `gold-dl`?
82
+
83
+ This command-line wizard lets you download YouTube videos or playlists straight from your `Terminal`, powered by [Pytubefix](https://pytubefix.readthedocs.io/). It works like a charm on Windows, Mac, and Linux, so you can rock it on any platform.
84
+
85
+ While other tools make you wade through a swamp of settings and configs, `gold-dl` keeps it simple. Just drop in your URL, and voilà! It’ll take you on a smooth ride to your favorite videos, no complex options needed—just fun downloading! 🔥
86
+
87
+ ## 🛠️ Installation
88
+
89
+ Getting `gold-dl` up and running is a breeze! First, ensure you have [Python](https://www.python.org) installed. Just pop open your terminal and type:
90
+
91
+ ```bash
92
+ python --version
93
+ ```
94
+
95
+ If you see something like `Python 3.x`, you’re all set! If not, head over to [Python's downloads page](https://www.python.org/downloads/) to grab it.
96
+
97
+ Once you’re good to go, install `gold-dl` with a single command:
98
+
99
+ ```bash
100
+ pip install gold-dl --break-system-packages
101
+ ```
102
+
103
+ And just like that, you’re ready to download some awesome videos! 🎉
104
+
105
+ ## 📈 Upgrade
106
+
107
+ Stay in the loop with the latest features on [GitHub](https://github.com/VOLT5775/VoLTGoLD-YT)! To upgrade your `gold-dl` tool, simply run:
108
+
109
+ ```bash
110
+ pip install --upgrade gold-dl --break-system-packages
111
+ ```
112
+
113
+ Then you’re all set to keep downloading from your `Terminal`! 🥳
114
+
115
+ ## 🦸 Quick Start
116
+
117
+ Getting started with `gold-dl` is a piece of cake! Just use the following command style:
118
+
119
+ ```bash
120
+ gold-dlp "YOUTUBE_LINK" [PATH]
121
+ ```
122
+
123
+ > [!NOTE]
124
+ > The `[URL]` is <span style="color:red">[Required]</span> and it should be between `""`<br/>
125
+ > The `[PATH]` is optional—if you don’t specify one, it’ll save to your current terminal directory. Easy-peasy!
126
+
127
+ ## 👨‍💻 Usage
128
+
129
+ #### Arguments
130
+
131
+ | Arguments | Description |
132
+ | --------- | -------------------------------------------------------------------------------------------------------------------- |
133
+ | `URL` | The `URL` of the YouTube video. This argument is <span style="color:red">[Required]</span>. |
134
+ | `PATH` | The `path` to save the video. Defaults to the current working directory. <span style="color:green">[Optional]</span> |
135
+
136
+ ### Options
137
+
138
+ | Option | Description |
139
+ | --------------------------------------------------- | -------------------------------------- |
140
+ | `-v` <span style="color:cyan">or</span> `--version` | Displays the current version number. |
141
+ | `-a` <span style="color:cyan">or</span> `--audio` | Download audio only, skipping prompts. |
142
+ | `-f` <span style="color:cyan">or</span> `--footage` | Download video only, skipping prompts. |
143
+
144
+ ## 🕵️‍♂️ Examples
145
+
146
+ For lots of examples, check them out [here](https://github.com/VOLT5775/VoLTGoLD-YT/blob/main/EXAMPLES.md)! Take a deep dive and discover all the ways to use gold-dl. 🚀
147
+
148
+ ## 🥰 Contributing
149
+
150
+ Pull requests are welcome. For major changes, please open an issue first to discuss what you want to change.
151
+ please follow the [contributing guidelines](https://github.com/VOLT5775/VoLTGoLD-YT/blob/main/CONTRIBUTING.md)
152
+
153
+ ## 📎 License
154
+
155
+ This project is licensed under the [MIT License](https://github.com/VOLT5775/VoLTGoLD-YT/blob/main/LICENSE).
156
+
157
+ ## 📸 Screenshots
158
+
159
+ <!-- for pypi only -->
160
+ <div style="text-align: center;">
161
+ <p>Download video with specify the save location</p>
162
+ <a href="https://ibb.co/Q3yRhBsg">
163
+ <img src="https://i.ibb.co/Hf5sRvmS/IMG-20251120-013217-680.jpg" alt="Download video with specify the save location">
164
+ </a>
165
+ <p>Chose what type you want to download</p>
166
+ <a href="https://ibb.co/Kb6qjmg">
167
+ <img src="https://ibb.co/Kb6qjmg" alt="Chose what type you want to download">
168
+ </a>
169
+ <p>Chose what what resolution you want to download(if the type is video)</p>
170
+ <a href="https://ibb.co/7ymCS79">
171
+ <img src="https://ibb.co/Kb6qjmg" alt="Chose what resolution you want to download">
172
+ </a>
173
+ <p>If you download a playlist, you can choose what video you want to download, or even all of them</p>
174
+ <a href="https://ibb.co/0qwkQNm">
175
+ <img src="https://i.ibb.co/1ZS3bV7/Screenshot-from-2024-04-11-16-42-29.png" alt="If you download a playlist, you can choose what video you want to download, or even all of them"/>
176
+ </a>
177
+ <br /><br />
178
+ <p>Do not know how to use it? just type <code>gold-dlp --help</code></p>
179
+ <a href="https://ibb.co/Q3yRhBsg">
180
+ <img src="https://ibb.co/Kb6qjmg" alt="image5">
181
+ </a>
182
+ </div>
183
+
184
+ ## ⏳ Todo List
185
+
186
+ - [x] **Notification System**
187
+ - [x] **Auto Update package if new version available**
188
+ - [x] **Support Optional Numbering for Downloaded Playlist Videos**
189
+ - [ ] **Improve code health**
190
+ - [ ] **Support downloading sounds (mp3 format not a audio/mp4)**
191
+ - [ ] **Support Subtitles Download**
192
+ - [ ] **Support setting for downloading folder**
193
+ - [ ] **Download Thumbnails with Videos and Audio**
gold_dl-0.0.1/README.md ADDED
@@ -0,0 +1,139 @@
1
+ # 📹 gold-dl - The Simplest YouTube Downloader CLI
2
+ # Telegram User Dev ~ @CB6BB
3
+
4
+ ### Enjoying my project? Please show your appreciation by starring it on GitHub! ⭐
5
+
6
+
7
+
8
+ <br />
9
+ <br />
10
+
11
+ > [!NOTE] > `gold-dl` is built on top of `pytubefix`, make sure to have the latest version of `pytubefix` by running:
12
+ >
13
+ > ```bash
14
+ > pip install --upgrade pytubefix
15
+ > ```
16
+
17
+ <a href="https://ibb.co/Q3yRhBsg">
18
+ <img src="https://i.ibb.co/Hf5sRvmS/IMG-20251120-013217-680.jpg"
19
+ alt="Pyutube"
20
+ style="width: 100%;"
21
+ border="0">
22
+ </a>
23
+
24
+ > [!NOTE]
25
+ > Have **a new feature**? Please don't hesitate to [tell me](https://github.com/VOLT5775/VoLTGoLD-YT)!
26
+
27
+ ## 🤔 why `gold-dl`?
28
+
29
+ This command-line wizard lets you download YouTube videos or playlists straight from your `Terminal`, powered by [Pytubefix](https://pytubefix.readthedocs.io/). It works like a charm on Windows, Mac, and Linux, so you can rock it on any platform.
30
+
31
+ While other tools make you wade through a swamp of settings and configs, `gold-dl` keeps it simple. Just drop in your URL, and voilà! It’ll take you on a smooth ride to your favorite videos, no complex options needed—just fun downloading! 🔥
32
+
33
+ ## 🛠️ Installation
34
+
35
+ Getting `gold-dl` up and running is a breeze! First, ensure you have [Python](https://www.python.org) installed. Just pop open your terminal and type:
36
+
37
+ ```bash
38
+ python --version
39
+ ```
40
+
41
+ If you see something like `Python 3.x`, you’re all set! If not, head over to [Python's downloads page](https://www.python.org/downloads/) to grab it.
42
+
43
+ Once you’re good to go, install `gold-dl` with a single command:
44
+
45
+ ```bash
46
+ pip install gold-dl --break-system-packages
47
+ ```
48
+
49
+ And just like that, you’re ready to download some awesome videos! 🎉
50
+
51
+ ## 📈 Upgrade
52
+
53
+ Stay in the loop with the latest features on [GitHub](https://github.com/VOLT5775/VoLTGoLD-YT)! To upgrade your `gold-dl` tool, simply run:
54
+
55
+ ```bash
56
+ pip install --upgrade gold-dl --break-system-packages
57
+ ```
58
+
59
+ Then you’re all set to keep downloading from your `Terminal`! 🥳
60
+
61
+ ## 🦸 Quick Start
62
+
63
+ Getting started with `gold-dl` is a piece of cake! Just use the following command style:
64
+
65
+ ```bash
66
+ gold-dlp "YOUTUBE_LINK" [PATH]
67
+ ```
68
+
69
+ > [!NOTE]
70
+ > The `[URL]` is <span style="color:red">[Required]</span> and it should be between `""`<br/>
71
+ > The `[PATH]` is optional—if you don’t specify one, it’ll save to your current terminal directory. Easy-peasy!
72
+
73
+ ## 👨‍💻 Usage
74
+
75
+ #### Arguments
76
+
77
+ | Arguments | Description |
78
+ | --------- | -------------------------------------------------------------------------------------------------------------------- |
79
+ | `URL` | The `URL` of the YouTube video. This argument is <span style="color:red">[Required]</span>. |
80
+ | `PATH` | The `path` to save the video. Defaults to the current working directory. <span style="color:green">[Optional]</span> |
81
+
82
+ ### Options
83
+
84
+ | Option | Description |
85
+ | --------------------------------------------------- | -------------------------------------- |
86
+ | `-v` <span style="color:cyan">or</span> `--version` | Displays the current version number. |
87
+ | `-a` <span style="color:cyan">or</span> `--audio` | Download audio only, skipping prompts. |
88
+ | `-f` <span style="color:cyan">or</span> `--footage` | Download video only, skipping prompts. |
89
+
90
+ ## 🕵️‍♂️ Examples
91
+
92
+ For lots of examples, check them out [here](https://github.com/VOLT5775/VoLTGoLD-YT/blob/main/EXAMPLES.md)! Take a deep dive and discover all the ways to use gold-dl. 🚀
93
+
94
+ ## 🥰 Contributing
95
+
96
+ Pull requests are welcome. For major changes, please open an issue first to discuss what you want to change.
97
+ please follow the [contributing guidelines](https://github.com/VOLT5775/VoLTGoLD-YT/blob/main/CONTRIBUTING.md)
98
+
99
+ ## 📎 License
100
+
101
+ This project is licensed under the [MIT License](https://github.com/VOLT5775/VoLTGoLD-YT/blob/main/LICENSE).
102
+
103
+ ## 📸 Screenshots
104
+
105
+ <!-- for pypi only -->
106
+ <div style="text-align: center;">
107
+ <p>Download video with specify the save location</p>
108
+ <a href="https://ibb.co/Q3yRhBsg">
109
+ <img src="https://i.ibb.co/Hf5sRvmS/IMG-20251120-013217-680.jpg" alt="Download video with specify the save location">
110
+ </a>
111
+ <p>Chose what type you want to download</p>
112
+ <a href="https://ibb.co/Kb6qjmg">
113
+ <img src="https://ibb.co/Kb6qjmg" alt="Chose what type you want to download">
114
+ </a>
115
+ <p>Chose what what resolution you want to download(if the type is video)</p>
116
+ <a href="https://ibb.co/7ymCS79">
117
+ <img src="https://ibb.co/Kb6qjmg" alt="Chose what resolution you want to download">
118
+ </a>
119
+ <p>If you download a playlist, you can choose what video you want to download, or even all of them</p>
120
+ <a href="https://ibb.co/0qwkQNm">
121
+ <img src="https://i.ibb.co/1ZS3bV7/Screenshot-from-2024-04-11-16-42-29.png" alt="If you download a playlist, you can choose what video you want to download, or even all of them"/>
122
+ </a>
123
+ <br /><br />
124
+ <p>Do not know how to use it? just type <code>gold-dlp --help</code></p>
125
+ <a href="https://ibb.co/Q3yRhBsg">
126
+ <img src="https://ibb.co/Kb6qjmg" alt="image5">
127
+ </a>
128
+ </div>
129
+
130
+ ## ⏳ Todo List
131
+
132
+ - [x] **Notification System**
133
+ - [x] **Auto Update package if new version available**
134
+ - [x] **Support Optional Numbering for Downloaded Playlist Videos**
135
+ - [ ] **Improve code health**
136
+ - [ ] **Support downloading sounds (mp3 format not a audio/mp4)**
137
+ - [ ] **Support Subtitles Download**
138
+ - [ ] **Support setting for downloading folder**
139
+ - [ ] **Download Thumbnails with Videos and Audio**
gold_dl-0.0.1/gold_dl.egg-info/PKG-INFO ADDED
@@ -0,0 +1,193 @@
1
+ Metadata-Version: 2.4
2
+ Name: gold-dl
3
+ Version: 0.0.1
4
+ Summary: High performance CLI YouTube downloader (video / audio / shorts / playlists) with smart caching and auto quality handling
5
+ Author: VOLT5775
6
+ Author-email: VOLT5775@users.noreply.github.com
7
+ License: MIT
8
+ Project-URL: Homepage, https://github.com/VOLT5775/VoLTGoLD-YT
9
+ Project-URL: Source Code, https://github.com/VOLT5775/VoLTGoLD-YT
10
+ Project-URL: Bug Tracker, https://github.com/VOLT5775/VoLTGoLD-YT/issues
11
+ Project-URL: Documentation, https://github.com/VOLT5775/VoLTGoLD-YT
12
+ Project-URL: Author, https://github.com/VOLT5775
13
+ Keywords: youtube,download,cli,pyutube,voltgold,yt-downloader,pytubefix,pytube,youtube-dl
14
+ Platform: Linux
15
+ Platform: Windows
16
+ Platform: MacOS
17
+ Classifier: License :: OSI Approved :: MIT License
18
+ Classifier: Operating System :: OS Independent
19
+ Classifier: Programming Language :: Python :: 3
20
+ Classifier: Programming Language :: Python :: 3.6
21
+ Classifier: Programming Language :: Python :: 3.7
22
+ Classifier: Programming Language :: Python :: 3.8
23
+ Classifier: Programming Language :: Python :: 3.9
24
+ Classifier: Programming Language :: Python :: 3.10
25
+ Classifier: Programming Language :: Python :: 3.11
26
+ Classifier: Programming Language :: Python :: 3.12
27
+ Classifier: Programming Language :: Python :: 3.13
28
+ Classifier: Topic :: Multimedia :: Video
29
+ Classifier: Topic :: Utilities
30
+ Requires-Python: >=3.6
31
+ Description-Content-Type: text/markdown
32
+ License-File: LICENSE
33
+ Requires-Dist: pytubefix>=0.4.0
34
+ Requires-Dist: inquirer>=3.0.0
35
+ Requires-Dist: yaspin>=3.0.0
36
+ Requires-Dist: typer>=0.9.0
37
+ Requires-Dist: requests>=2.28.0
38
+ Requires-Dist: rich>=13.0.0
39
+ Requires-Dist: termcolor>=2.0.0
40
+ Requires-Dist: moviepy>=1.0.0
41
+ Dynamic: author
42
+ Dynamic: author-email
43
+ Dynamic: classifier
44
+ Dynamic: description
45
+ Dynamic: description-content-type
46
+ Dynamic: keywords
47
+ Dynamic: license
48
+ Dynamic: license-file
49
+ Dynamic: platform
50
+ Dynamic: project-url
51
+ Dynamic: requires-dist
52
+ Dynamic: requires-python
53
+ Dynamic: summary
54
+
55
+ # 📹 gold-dl - The Simplest YouTube Downloader CLI
56
+ # Telegram User Dev ~ @CB6BB
57
+
58
+ ### Enjoying my project? Please show your appreciation by starring it on GitHub! ⭐
59
+
60
+
61
+
62
+ <br />
63
+ <br />
64
+
65
+ > [!NOTE] > `gold-dl` is built on top of `pytubefix`, make sure to have the latest version of `pytubefix` by running:
66
+ >
67
+ > ```bash
68
+ > pip install --upgrade pytubefix
69
+ > ```
70
+
71
+ <a href="https://ibb.co/Q3yRhBsg">
72
+ <img src="https://i.ibb.co/Hf5sRvmS/IMG-20251120-013217-680.jpg"
73
+ alt="Pyutube"
74
+ style="width: 100%;"
75
+ border="0">
76
+ </a>
77
+
78
+ > [!NOTE]
79
+ > Have **a new feature**? Please don't hesitate to [tell me](https://github.com/VOLT5775/VoLTGoLD-YT)!
80
+
81
+ ## 🤔 why `gold-dl`?
82
+
83
+ This command-line wizard lets you download YouTube videos or playlists straight from your `Terminal`, powered by [Pytubefix](https://pytubefix.readthedocs.io/). It works like a charm on Windows, Mac, and Linux, so you can rock it on any platform.
84
+
85
+ While other tools make you wade through a swamp of settings and configs, `gold-dl` keeps it simple. Just drop in your URL, and voilà! It’ll take you on a smooth ride to your favorite videos, no complex options needed—just fun downloading! 🔥
86
+
87
+ ## 🛠️ Installation
88
+
89
+ Getting `gold-dl` up and running is a breeze! First, ensure you have [Python](https://www.python.org) installed. Just pop open your terminal and type:
90
+
91
+ ```bash
92
+ python --version
93
+ ```
94
+
95
+ If you see something like `Python 3.x`, you’re all set! If not, head over to [Python's downloads page](https://www.python.org/downloads/) to grab it.
96
+
97
+ Once you’re good to go, install `gold-dl` with a single command:
98
+
99
+ ```bash
100
+ pip install gold-dl --break-system-packages
101
+ ```
102
+
103
+ And just like that, you’re ready to download some awesome videos! 🎉
104
+
105
+ ## 📈 Upgrade
106
+
107
+ Stay in the loop with the latest features on [GitHub](https://github.com/VOLT5775/VoLTGoLD-YT)! To upgrade your `gold-dl` tool, simply run:
108
+
109
+ ```bash
110
+ pip install --upgrade gold-dl --break-system-packages
111
+ ```
112
+
113
+ Then you’re all set to keep downloading from your `Terminal`! 🥳
114
+
115
+ ## 🦸 Quick Start
116
+
117
+ Getting started with `gold-dl` is a piece of cake! Just use the following command style:
118
+
119
+ ```bash
120
+ gold-dlp "YOUTUBE_LINK" [PATH]
121
+ ```
122
+
123
+ > [!NOTE]
124
+ > The `[URL]` is <span style="color:red">[Required]</span> and it should be between `""`<br/>
125
+ > The `[PATH]` is optional—if you don’t specify one, it’ll save to your current terminal directory. Easy-peasy!
126
+
127
+ ## 👨‍💻 Usage
128
+
129
+ #### Arguments
130
+
131
+ | Arguments | Description |
132
+ | --------- | -------------------------------------------------------------------------------------------------------------------- |
133
+ | `URL` | The `URL` of the YouTube video. This argument is <span style="color:red">[Required]</span>. |
134
+ | `PATH` | The `path` to save the video. Defaults to the current working directory. <span style="color:green">[Optional]</span> |
135
+
136
+ ### Options
137
+
138
+ | Option | Description |
139
+ | --------------------------------------------------- | -------------------------------------- |
140
+ | `-v` <span style="color:cyan">or</span> `--version` | Displays the current version number. |
141
+ | `-a` <span style="color:cyan">or</span> `--audio` | Download audio only, skipping prompts. |
142
+ | `-f` <span style="color:cyan">or</span> `--footage` | Download video only, skipping prompts. |
143
+
144
+ ## 🕵️‍♂️ Examples
145
+
146
+ For lots of examples, check them out [here](https://github.com/VOLT5775/VoLTGoLD-YT/blob/main/EXAMPLES.md)! Take a deep dive and discover all the ways to use gold-dl. 🚀
147
+
148
+ ## 🥰 Contributing
149
+
150
+ Pull requests are welcome. For major changes, please open an issue first to discuss what you want to change.
151
+ please follow the [contributing guidelines](https://github.com/VOLT5775/VoLTGoLD-YT/blob/main/CONTRIBUTING.md)
152
+
153
+ ## 📎 License
154
+
155
+ This project is licensed under the [MIT License](https://github.com/VOLT5775/VoLTGoLD-YT/blob/main/LICENSE).
156
+
157
+ ## 📸 Screenshots
158
+
159
+ <!-- for pypi only -->
160
+ <div style="text-align: center;">
161
+ <p>Download video with specify the save location</p>
162
+ <a href="https://ibb.co/Q3yRhBsg">
163
+ <img src="https://i.ibb.co/Hf5sRvmS/IMG-20251120-013217-680.jpg" alt="Download video with specify the save location">
164
+ </a>
165
+ <p>Chose what type you want to download</p>
166
+ <a href="https://ibb.co/Kb6qjmg">
167
+ <img src="https://ibb.co/Kb6qjmg" alt="Chose what type you want to download">
168
+ </a>
169
+ <p>Chose what what resolution you want to download(if the type is video)</p>
170
+ <a href="https://ibb.co/7ymCS79">
171
+ <img src="https://ibb.co/Kb6qjmg" alt="Chose what resolution you want to download">
172
+ </a>
173
+ <p>If you download a playlist, you can choose what video you want to download, or even all of them</p>
174
+ <a href="https://ibb.co/0qwkQNm">
175
+ <img src="https://i.ibb.co/1ZS3bV7/Screenshot-from-2024-04-11-16-42-29.png" alt="If you download a playlist, you can choose what video you want to download, or even all of them"/>
176
+ </a>
177
+ <br /><br />
178
+ <p>Do not know how to use it? just type <code>gold-dlp --help</code></p>
179
+ <a href="https://ibb.co/Q3yRhBsg">
180
+ <img src="https://ibb.co/Kb6qjmg" alt="image5">
181
+ </a>
182
+ </div>
183
+
184
+ ## ⏳ Todo List
185
+
186
+ - [x] **Notification System**
187
+ - [x] **Auto Update package if new version available**
188
+ - [x] **Support Optional Numbering for Downloaded Playlist Videos**
189
+ - [ ] **Improve code health**
190
+ - [ ] **Support downloading sounds (mp3 format not a audio/mp4)**
191
+ - [ ] **Support Subtitles Download**
192
+ - [ ] **Support setting for downloading folder**
193
+ - [ ] **Download Thumbnails with Videos and Audio**
gold_dl-0.0.1/gold_dl.egg-info/SOURCES.txt ADDED
@@ -0,0 +1,24 @@
1
+ LICENSE
2
+ MANIFEST.in
3
+ README.md
4
+ setup.py
5
+ gold_dl.egg-info/PKG-INFO
6
+ gold_dl.egg-info/SOURCES.txt
7
+ gold_dl.egg-info/dependency_links.txt
8
+ gold_dl.egg-info/entry_points.txt
9
+ gold_dl.egg-info/requires.txt
10
+ gold_dl.egg-info/top_level.txt
11
+ pyutube/__init__.py
12
+ pyutube/__main__.py
13
+ pyutube/cli.py
14
+ pyutube/utils.py
15
+ pyutube/handlers/PlaylistHandler.py
16
+ pyutube/handlers/URLHandler.py
17
+ pyutube/handlers/__init__.py
18
+ pyutube/services/AudioService.py
19
+ pyutube/services/DownloadService.py
20
+ pyutube/services/FileService.py
21
+ pyutube/services/VideoService.py
22
+ pyutube/services/__init__.py
23
+ pyutube/tests/__init__.py
24
+ pyutube/tests/test_utils.py
gold_dl-0.0.1/gold_dl.egg-info/entry_points.txt ADDED
@@ -0,0 +1,2 @@
1
+ [console_scripts]
2
+ gold-dl = pyutube:cli.app
gold_dl-0.0.1/gold_dl.egg-info/requires.txt ADDED
@@ -0,0 +1,8 @@
1
+ pytubefix>=0.4.0
2
+ inquirer>=3.0.0
3
+ yaspin>=3.0.0
4
+ typer>=0.9.0
5
+ requests>=2.28.0
6
+ rich>=13.0.0
7
+ termcolor>=2.0.0
8
+ moviepy>=1.0.0
gold_dl-0.0.1/gold_dl.egg-info/top_level.txt ADDED
@@ -0,0 +1 @@
1
+ pyutube
gold_dl-0.0.1/pyutube/__init__.py ADDED
@@ -0,0 +1,18 @@
1
+ """This is the initialization module for the pyutube package.
2
+
3
+ It provides the main entry point for the package by importing the `app`
4
+ object from the `cli` submodule.
5
+
6
+ Example:
7
+ To use this package, you can import the `app` object directly:
8
+
9
+ >>> from pyutube import app
10
+ >>> app.run()
11
+
12
+ """
13
+
14
+
15
+ # List the symbols you want to export from this module
16
+ # __all__ = ['app']
17
+ __app__ = "pyutube"
18
+ __version__ = "1.5.1"
gold_dl-0.0.1/pyutube/__main__.py ADDED
@@ -0,0 +1,12 @@
1
+ """Entry point for the pyutube package."""
2
+
3
+ from pyutube.cli import app
4
+
5
+
6
+ def main():
7
+ """Main function to run the application."""
8
+ app()
9
+
10
+
11
+ if __name__ == "__main__":
12
+ main()