SpotDown 0.0.1__py3-none-any.whl → 0.0.8__py3-none-any.whl

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 (21) hide show
  1. SpotDown/__init__.py +0 -0
  2. SpotDown/downloader/__init__.py +0 -0
  3. SpotDown/downloader/youtube_downloader.py +131 -0
  4. SpotDown/extractor/__init__.py +6 -0
  5. SpotDown/extractor/spotify_extractor.py +331 -0
  6. SpotDown/extractor/youtube_extractor.py +271 -0
  7. SpotDown/main.py +139 -0
  8. SpotDown/utils/__init__.py +6 -0
  9. SpotDown/utils/config_json.py +223 -0
  10. SpotDown/utils/console_utils.py +188 -0
  11. SpotDown/utils/file_utils.py +129 -0
  12. SpotDown/utils/headers.py +18 -0
  13. {spotdown-0.0.1.dist-info → spotdown-0.0.8.dist-info}/METADATA +180 -182
  14. spotdown-0.0.8.dist-info/RECORD +18 -0
  15. spotdown-0.0.8.dist-info/entry_points.txt +2 -0
  16. {spotdown-0.0.1.dist-info → spotdown-0.0.8.dist-info}/licenses/LICENSE +674 -674
  17. spotdown-0.0.8.dist-info/top_level.txt +1 -0
  18. spotdown-0.0.1.dist-info/RECORD +0 -6
  19. spotdown-0.0.1.dist-info/entry_points.txt +0 -2
  20. spotdown-0.0.1.dist-info/top_level.txt +0 -1
  21. {spotdown-0.0.1.dist-info → spotdown-0.0.8.dist-info}/WHEEL +0 -0
{spotdown-0.0.1.dist-info → spotdown-0.0.8.dist-info}/METADATA RENAMED
@@ -1,182 +1,180 @@
1
- Metadata-Version: 2.4
2
- Name: SpotDown
3
- Version: 0.0.1
4
- Home-page: https://github.com/Arrowar/SpotDown
5
- Author: Arrowar
6
- Project-URL: Bug Reports, https://github.com/Arrowar/SpotDown/issues
7
- Project-URL: Source, https://github.com/Arrowar/SpotDown
8
- Keywords: streaming community
9
- Requires-Python: >=3.8
10
- Description-Content-Type: text/markdown
11
- License-File: LICENSE
12
- Requires-Dist: rich
13
- Requires-Dist: httpx
14
- Requires-Dist: playwright
15
- Requires-Dist: unidecode
16
- Requires-Dist: ua-generator
17
- Requires-Dist: unidecode
18
- Requires-Dist: yt-dlp
19
- Requires-Dist: Pillow
20
- Dynamic: author
21
- Dynamic: description
22
- Dynamic: description-content-type
23
- Dynamic: home-page
24
- Dynamic: keywords
25
- Dynamic: license-file
26
- Dynamic: project-url
27
- Dynamic: requires-dist
28
- Dynamic: requires-python
29
-
30
- # SpotDown 🎵
31
-
32
- <div align="center">
33
-
34
- ## 📊 Project Status & Info
35
- [![PyPI Version](https://img.shields.io/pypi/v/spotdown?logo=pypi&logoColor=white&labelColor=2d3748&color=3182ce&style=for-the-badge)](https://pypi.org/project/spotdown)
36
- [![Last Commit](https://img.shields.io/github/last-commit/Arrowar/spotdown?logo=git&logoColor=white&labelColor=2d3748&color=805ad5&style=for-the-badge)](https://github.com/Arrowar/spotdown/commits)
37
- [![Issues](https://img.shields.io/github/issues/Arrowar/spotdown?logo=github&logoColor=white&labelColor=2d3748&color=ed8936&style=for-the-badge)](https://github.com/Arrowar/spotdown/issues)
38
- [![License](https://img.shields.io/github/license/Arrowar/spotdown?logo=gnu&logoColor=white&labelColor=2d3748&color=e53e3e&style=for-the-badge)](https://github.com/Arrowar/spotdown/blob/main/LICENSE)
39
-
40
- ## 💝 Support the Project
41
-
42
- [![Donate PayPal](https://img.shields.io/badge/💳_Donate-PayPal-00457C?style=for-the-badge&logo=paypal&logoColor=white&labelColor=2d3748)](https://www.paypal.com/donate/?hosted_button_id=UXTWMT8P6HE2C)
43
- ## 🚀 Download & Install
44
-
45
- [![Windows](https://img.shields.io/badge/🪟_Windows-0078D4?style=for-the-badge&logo=windows&logoColor=white&labelColor=2d3748)](https://github.com/Arrowar/spotdown/releases/latest/download/spotdown_win.exe)
46
- [![macOS](https://img.shields.io/badge/🍎_macOS-000000?style=for-the-badge&logo=apple&logoColor=white&labelColor=2d3748)](https://github.com/Arrowar/spotdown/releases/latest/download/spotdown_mac)
47
- [![Linux latest](https://img.shields.io/badge/🐧_Linux_latest-FCC624?style=for-the-badge&logo=linux&logoColor=black&labelColor=2d3748)](https://github.com/Arrowar/spotdown/releases/latest/download/spotdown_linux_latest)
48
- [![Linux 22.04](https://img.shields.io/badge/🐧_Linux_22.04-FCC624?style=for-the-badge&logo=linux&logoColor=black&labelColor=2d3748)](https://github.com/Arrowar/spotdown/releases/latest/download/spotdown_linux_previous)
49
-
50
- ---
51
-
52
- *⚡ **Quick Start:** `pip install spotdown` or download the executable for your platform above*
53
-
54
- </div>
55
-
56
- ## 📋 Table of Contents
57
-
58
- - [✨ Features](#features)
59
- - [🛠️ Installation](#installation)
60
- - [⚙️ Configuration](#configuration)
61
- - [💻 Usage](#usage)
62
- - [📁 Project Structure](#project-structure)
63
- - [🔧 Dependencies](#dependencies)
64
- - [⚠️ Disclaimer](#disclaimer)
65
-
66
- ## ✨ Features
67
-
68
- - 🎵 **Download individual songs** from Spotify
69
- - 📋 **Download entire playlists** with ease
70
- - 🔍 **No authentication required** - uses web scraping
71
- - 🎨 **Automatic cover art embedding** (JPEG format)
72
-
73
- ## 🛠️ Installation
74
-
75
- ### Prerequisites
76
-
77
- - **Python 3.8+**
78
- - **FFmpeg** (for audio processing)
79
- - **yt-dlp** (for downloading)
80
-
81
- ### 1. Install Python Dependencies
82
-
83
- ```bash
84
- pip install -r requirements.txt
85
- ```
86
-
87
- ### 2. Install Playwright Chromium
88
-
89
- ```bash
90
- playwright install chromium
91
- ```
92
-
93
- ### 3. Quick Start
94
-
95
- Create a simple launcher script:
96
-
97
- ```python
98
- from SpotDown.run import main
99
-
100
- if __name__ == "__main__":
101
- main()
102
- ```
103
-
104
- ## ⚙️ Configuration
105
-
106
- SpotDown uses a JSON configuration file with the following structure:
107
-
108
- ```json
109
- {
110
- "DEFAULT": {
111
- "clean_console": true,
112
- "show_message": true
113
- },
114
- "DOWNLOAD": {
115
- "auto_first": false,
116
- "quality": "320K"
117
- },
118
- "BROWSER": {
119
- "headless": true,
120
- "timeout": 6
121
- }
122
- }
123
- ```
124
-
125
- ### Configuration Options
126
-
127
- #### DEFAULT Settings
128
- - **`clean_console`**: Clear console output for cleaner interface
129
- - **`show_message`**: Display informational messages during execution
130
-
131
- #### DOWNLOAD Settings
132
- - **`auto_first`**: Automatically select first search result
133
- - **`quality`**: Audio quality (320K recommended for best quality)
134
-
135
- #### BROWSER Settings
136
- - **`headless`**: Run browser in background (recommended: true)
137
- - **`timeout`**: Browser timeout in seconds
138
-
139
- ## 💻 Usage
140
-
141
- ### Basic Usage
142
-
143
- ```bash
144
- python spotdown.py
145
- ```
146
-
147
- ### Download Individual Songs
148
-
149
- 1. Run the script
150
- 2. Paste the Spotify song URL when prompted
151
- 3. The script will automatically:
152
- - Extract song information
153
- - Search for the best quality version
154
- - Download as MP3 with embedded cover art
155
-
156
- ### Download Playlists
157
-
158
- 1. Run the script
159
- 2. Paste the Spotify playlist URL when prompted
160
- 3. All songs in the playlist will be downloaded automatically
161
-
162
- ## 📝 To Do
163
-
164
- - [ ] Implement batch download queue
165
- - [ ] Add GUI interface option
166
- - [ ] Support for additional music platforms
167
-
168
- ## ⚠️ Disclaimer
169
-
170
- This software is provided "as is", without warranty of any kind, express or implied, including but not limited to the warranties of merchantability, fitness for a particular purpose, and noninfringement.
171
-
172
- **Important**: This tool is intended for educational purposes and personal use only. Users are responsible for ensuring they comply with applicable laws and platform terms of service. The developers do not encourage or condone piracy or copyright infringement.
173
-
174
- ---
175
-
176
- <div align="center">
177
-
178
- **Made with ❤️ for music lovers**
179
-
180
- *If you find this project useful, consider starring it! ⭐*
181
-
182
- </div>
1
+ Metadata-Version: 2.4
2
+ Name: SpotDown
3
+ Version: 0.0.8
4
+ Home-page: https://github.com/Arrowar/SpotDown
5
+ Author: Arrowar
6
+ Project-URL: Bug Reports, https://github.com/Arrowar/SpotDown/issues
7
+ Project-URL: Source, https://github.com/Arrowar/SpotDown
8
+ Keywords: streaming community
9
+ Requires-Python: >=3.8
10
+ Description-Content-Type: text/markdown
11
+ License-File: LICENSE
12
+ Requires-Dist: rich
13
+ Requires-Dist: httpx
14
+ Requires-Dist: playwright
15
+ Requires-Dist: unidecode
16
+ Requires-Dist: ua-generator
17
+ Requires-Dist: unidecode
18
+ Requires-Dist: yt-dlp
19
+ Requires-Dist: Pillow
20
+ Dynamic: author
21
+ Dynamic: description
22
+ Dynamic: description-content-type
23
+ Dynamic: home-page
24
+ Dynamic: keywords
25
+ Dynamic: license-file
26
+ Dynamic: project-url
27
+ Dynamic: requires-dist
28
+ Dynamic: requires-python
29
+
30
+ <div align="center">
31
+
32
+ ## 📊 Project Status & Info
33
+ [![PyPI Version](https://img.shields.io/pypi/v/spotdown?logo=pypi&logoColor=white&labelColor=2d3748&color=3182ce&style=for-the-badge)](https://pypi.org/project/spotdown)
34
+ [![Last Commit](https://img.shields.io/github/last-commit/Arrowar/spotdown?logo=git&logoColor=white&labelColor=2d3748&color=805ad5&style=for-the-badge)](https://github.com/Arrowar/spotdown/commits)
35
+ [![Issues](https://img.shields.io/github/issues/Arrowar/spotdown?logo=github&logoColor=white&labelColor=2d3748&color=ed8936&style=for-the-badge)](https://github.com/Arrowar/spotdown/issues)
36
+ [![License](https://img.shields.io/github/license/Arrowar/spotdown?logo=gnu&logoColor=white&labelColor=2d3748&color=e53e3e&style=for-the-badge)](https://github.com/Arrowar/spotdown/blob/main/LICENSE)
37
+
38
+ ## 💝 Support the Project
39
+
40
+ [![Donate PayPal](https://img.shields.io/badge/💳_Donate-PayPal-00457C?style=for-the-badge&logo=paypal&logoColor=white&labelColor=2d3748)](https://www.paypal.com/donate/?hosted_button_id=UXTWMT8P6HE2C)
41
+ ## 🚀 Download & Install
42
+
43
+ [![Windows](https://img.shields.io/badge/🪟_Windows-0078D4?style=for-the-badge&logo=windows&logoColor=white&labelColor=2d3748)](https://github.com/Arrowar/spotdown/releases/latest/download/spotdown_win.exe)
44
+ [![macOS](https://img.shields.io/badge/🍎_macOS-000000?style=for-the-badge&logo=apple&logoColor=white&labelColor=2d3748)](https://github.com/Arrowar/spotdown/releases/latest/download/spotdown_mac)
45
+ [![Linux latest](https://img.shields.io/badge/🐧_Linux_latest-FCC624?style=for-the-badge&logo=linux&logoColor=black&labelColor=2d3748)](https://github.com/Arrowar/spotdown/releases/latest/download/spotdown_linux_latest)
46
+ [![Linux 22.04](https://img.shields.io/badge/🐧_Linux_22.04-FCC624?style=for-the-badge&logo=linux&logoColor=black&labelColor=2d3748)](https://github.com/Arrowar/spotdown/releases/latest/download/spotdown_linux_previous)
47
+
48
+ ---
49
+
50
+ *⚡ **Quick Start:** `pip install spotdown` or download the executable for your platform above*
51
+
52
+ </div>
53
+
54
+ ## 📋 Table of Contents
55
+
56
+ - [✨ Features](#features)
57
+ - [🛠️ Installation](#installation)
58
+ - [⚙️ Configuration](#configuration)
59
+ - [💻 Usage](#usage)
60
+ - [📁 Project Structure](#project-structure)
61
+ - [🔧 Dependencies](#dependencies)
62
+ - [⚠️ Disclaimer](#disclaimer)
63
+
64
+ ## ✨ Features
65
+
66
+ - 🎵 **Download individual songs** from Spotify
67
+ - 📋 **Download entire playlists** with ease
68
+ - 🔍 **No authentication required** - uses web scraping
69
+ - 🎨 **Automatic cover art embedding** (JPEG format)
70
+
71
+ ## 🛠️ Installation
72
+
73
+ ### Prerequisites
74
+
75
+ - **Python 3.8+**
76
+ - **FFmpeg** (for audio processing)
77
+ - **yt-dlp** (for downloading)
78
+
79
+ ### 1. Install Python Dependencies
80
+
81
+ ```bash
82
+ pip install -r requirements.txt
83
+ ```
84
+
85
+ ### 2. Install Playwright Chromium
86
+
87
+ ```bash
88
+ playwright install chromium
89
+ ```
90
+
91
+ ### 3. Quick Start
92
+
93
+ Create a simple launcher script:
94
+
95
+ ```python
96
+ from spotdown.run import main
97
+
98
+ if __name__ == "__main__":
99
+ main()
100
+ ```
101
+
102
+ ## ⚙️ Configuration
103
+
104
+ SpotDown uses a JSON configuration file with the following structure:
105
+
106
+ ```json
107
+ {
108
+ "DEFAULT": {
109
+ "clean_console": true,
110
+ "show_message": true
111
+ },
112
+ "DOWNLOAD": {
113
+ "auto_first": false,
114
+ "quality": "320K"
115
+ },
116
+ "BROWSER": {
117
+ "headless": true,
118
+ "timeout": 6
119
+ }
120
+ }
121
+ ```
122
+
123
+ ### Configuration Options
124
+
125
+ #### DEFAULT Settings
126
+ - **`clean_console`**: Clear console output for cleaner interface
127
+ - **`show_message`**: Display informational messages during execution
128
+
129
+ #### DOWNLOAD Settings
130
+ - **`auto_first`**: Automatically select first search result
131
+ - **`quality`**: Audio quality (320K recommended for best quality)
132
+
133
+ #### BROWSER Settings
134
+ - **`headless`**: Run browser in background (recommended: true)
135
+ - **`timeout`**: Browser timeout in seconds
136
+
137
+ ## 💻 Usage
138
+
139
+ ### Basic Usage
140
+
141
+ ```bash
142
+ python run.py
143
+ ```
144
+
145
+ ### Download Individual Songs
146
+
147
+ 1. Run the script
148
+ 2. Paste the Spotify song URL when prompted
149
+ 3. The script will automatically:
150
+ - Extract song information
151
+ - Search for the best quality version
152
+ - Download as MP3 with embedded cover art
153
+
154
+ ### Download Playlists
155
+
156
+ 1. Run the script
157
+ 2. Paste the Spotify playlist URL when prompted
158
+ 3. All songs in the playlist will be downloaded automatically
159
+
160
+ ## 📝 To Do
161
+
162
+ - [ ] Implement batch download queue
163
+ - [ ] Add GUI interface option
164
+ - [ ] Support for additional music platforms
165
+
166
+ ## ⚠️ Disclaimer
167
+
168
+ This software is provided "as is", without warranty of any kind, express or implied, including but not limited to the warranties of merchantability, fitness for a particular purpose, and noninfringement.
169
+
170
+ **Important**: This tool is intended for educational purposes and personal use only. Users are responsible for ensuring they comply with applicable laws and platform terms of service. The developers do not encourage or condone piracy or copyright infringement.
171
+
172
+ ---
173
+
174
+ <div align="center">
175
+
176
+ **Made with ❤️ for music lovers**
177
+
178
+ *If you find this project useful, consider starring it! ⭐*
179
+
180
+ </div>
spotdown-0.0.8.dist-info/RECORD ADDED
@@ -0,0 +1,18 @@
1
+ SpotDown/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
2
+ SpotDown/main.py,sha256=TjxUMIe0ee8IMbnYhXekO2MoLRiY6pJ5CCPgz7pOpHg,5042
3
+ SpotDown/downloader/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
4
+ SpotDown/downloader/youtube_downloader.py,sha256=zHl98F2Ax72wTg3n8pohmkBZgBIPff0NrD9QKhG-TBM,4589
5
+ SpotDown/extractor/__init__.py,sha256=pQtkjMzB4D8AVEFQ3pnp_UQI-KbYaQhZbKuDnMImN0o,161
6
+ SpotDown/extractor/spotify_extractor.py,sha256=abE48E4M8s3xf95a28IYD8L4K2-QFDaYoZC5V0Jqu-4,13486
7
+ SpotDown/extractor/youtube_extractor.py,sha256=XIPNWEBb5oUkGP1DrQ4h4XTJvHlBlbVIkAFNdpFE-Rc,9586
8
+ SpotDown/utils/__init__.py,sha256=ZhJJhNQkUd4XG6vkoVQSC3qvSlaArhsRjscn4bfC9WA,128
9
+ SpotDown/utils/config_json.py,sha256=Z_fuM2mYQVPc51sQ_-LXrX-ArTPL-lRDcQ3lLM_hmck,7435
10
+ SpotDown/utils/console_utils.py,sha256=A1zNRyB9yG7BqWzlQgfVZ25cWUjMmYQooRKyeqVlcDw,6823
11
+ SpotDown/utils/file_utils.py,sha256=Lgq_Nu1r-bVIH37H7Mx73WgotN_nrgMUAT2STDyEYoY,3495
12
+ SpotDown/utils/headers.py,sha256=nSF2rEQEl7g2tIJMjz9c5mAQfLiugfWwdlJBhtMfBSo,312
13
+ spotdown-0.0.8.dist-info/licenses/LICENSE,sha256=OXLcl0T2SZ8Pmy2_dmlvKuetivmyPd5m1q-Gyd-zaYY,35149
14
+ spotdown-0.0.8.dist-info/METADATA,sha256=qQm7cchc8He-a6aq2biqDlAUpSpVYmmvLUhbzsgaXOc,5742
15
+ spotdown-0.0.8.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
16
+ spotdown-0.0.8.dist-info/entry_points.txt,sha256=RATQdiKFml4JJdFUPSWQdf6b53WKgJNE7SD5IVhv2_c,48
17
+ spotdown-0.0.8.dist-info/top_level.txt,sha256=1E-ZZ8rsrXmBPAsseY_kEfHfNo9w9PtSCaS6pM63-tw,9
18
+ spotdown-0.0.8.dist-info/RECORD,,
spotdown-0.0.8.dist-info/entry_points.txt ADDED
@@ -0,0 +1,2 @@
1
+ [console_scripts]
2
+ spotdown = SpotDown.main:main