https://github.com/moehmeni/mp3cloud
Search and download any music from FreeMp3Cloud.com
https://github.com/moehmeni/mp3cloud
downloader mp3-downloader music music-downloader spotify
Last synced: 7 months ago
JSON representation
Search and download any music from FreeMp3Cloud.com
- Host: GitHub
- URL: https://github.com/moehmeni/mp3cloud
- Owner: moehmeni
- License: mit
- Created: 2022-04-27T09:29:23.000Z (over 3 years ago)
- Default Branch: master
- Last Pushed: 2023-01-20T21:19:37.000Z (almost 3 years ago)
- Last Synced: 2025-04-09T23:46:18.350Z (7 months ago)
- Topics: downloader, mp3-downloader, music, music-downloader, spotify
- Language: Python
- Homepage:
- Size: 39.1 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# FreeMp3Cloud Downloader
[](https://pepy.tech/project/mp3cloud)
A lightweight wrapper around [FreeMp3Cloud.com](https://freemp3cloud.com) to download songs by the given query.
## Installation
```
pip install mp3cloud
```
**Note `cURL` should be installed**
## Usage
### CLI
Downloading a song:
```
python -m mp3cloud "[TRACK_NAME] [ARTIST_NAME]"
```
Getting all the URLs provided for the query gathered in a `.txt` file:
```
python -m mp3cloud "[TRACK_NAME] [ARTIST_NAME]" --save-urls --no-download
```
### Python programs
Seeing the results of the query:
```py
from mp3cloud import search
songs = search("[TRACK_NAME] [ARTIST_NAME]")
for song in songs:
print(song.name, song.artist, song.url, song.duration, song.is_high_quality)
```
To download a song:
```py
from mp3cloud.utils import download_song
download_song(songs[0])
```
## Todo
- [ ] Setting metadata for the downloaded song
- [ ] Filter by quality
- [ ] Checking the availablity of cURL
- [ ] Add docs for the functions