Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/derhnyel/getmusic
A music aggregator engine for downloading/streaming free music albums and popular youtube / spotify playlists from the terminal.
https://github.com/derhnyel/getmusic
afrobeats aggregator deezer music music-bot music-player python search songs-download spotify terminal tui youtube youtube-downloader
Last synced: 2 days ago
JSON representation
A music aggregator engine for downloading/streaming free music albums and popular youtube / spotify playlists from the terminal.
- Host: GitHub
- URL: https://github.com/derhnyel/getmusic
- Owner: derhnyel
- License: mit
- Created: 2022-02-19T08:28:33.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2024-02-25T12:56:48.000Z (7 months ago)
- Last Synced: 2024-04-17T09:25:09.302Z (6 months ago)
- Topics: afrobeats, aggregator, deezer, music, music-bot, music-player, python, search, songs-download, spotify, terminal, tui, youtube, youtube-downloader
- Language: Python
- Homepage: https://getmusic.live
- Size: 251 KB
- Stars: 11
- Watchers: 3
- Forks: 4
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# GETMUSIC
> *Why must i pay for what makes me Happy ? Why can't i `GETMUSIC` for free ? Let us set music Free.*
Getmusic is a package that gives you access to a variety of music from your favourite artists. It lets you query popular music download sites and scrape for artists, songs and albums titles, download links to albums and tracks and albums/tracks details.
## Supported Engines
Supported music engines include:
- SongsLover
- Mp3Juices
- NaijaMusic
- AceMusic
- JustNaija
View all supported engines [here](https://github.com/derhnyel/getmusic/blob/build-engine/docs/supported_engines.md?raw=true)
## Development
#### Clone the respository
- Clone this repo `git clone [email protected]:derhnyel/getmusic.git`
## Usage
#### Search
- Engines can be searched with query string.
```python
import pprint
from engine.songslover import SongsLover
from engine.justnaija import JustNaija
from engine.naijamusic import NaijaMusic
from engine.mp3juices import Mp3Juices
from engine.ace import Ace
search_args = ('Donda 2',1)
jn = JustNaija()
mj = Mp3Juices()
ace = Ace()
sl = SongsLover()
nm = NaijaMusic()
slresults = sl.search(*search_args)
jnresults = jn.search(*search_args)
aceresults = ace.search(*search_args)
mjresults = mj.search(*search_args)
nmresults = nm.search(*search_args)
results = dict(
Songslover=slresults,
JustNaija=jnresults,
AceMusic=aceresults,
NaijaMusic=nmresults,
Mp3Juices=mjresults,
)
# pretty print the result from each engine
for k, v in results.items():
print(f"-------------{k}------------")
for result in v:
pprint.pprint(result)
```
#### Fetch
- Latest Items can be fetched from engines based on categories eg. latest albums, tracks, gospel etc. Each engine allowed category is defined.
```python
import pprint
from engine.songslover import SongsLover
from engine.justnaija import JustNaija
from engine.naijamusic import NaijaMusic
jn = JustNaija()
sl = SongsLover()
nm = NaijaMusic()
# check the allowed category method to see the categories allowed for each engine
slresults = sl.fetch(category='albums',page=1)
jnresults = jn.fetch(category='album' ,page=1)
nmresults = nm.fetch(category='albums-eps',page=1)
results = dict(
Songslover=slresults,
JustNaija=jnresults,
NaijaMusic=nmresults,
)
# pretty print the result from each engine
for k, v in results.items():
print(f"-------------{k}------------")
for result in v:
pprint.pprint(result)
```
## TODO's
- TODO: Creates Enum for some objects and results items.
- TODO: Create a Caching Mechanism for results.
- TODO: Handle Engine Errors and Exceptions.
- TODO: Make Request Handling Asynchronous.
- TODO: Seperate Engine's parse single object method from search method.
- TODO: Add more Music Engines.
- TODO: Scrape some existing Engines for more track details. eg. Songslover,NaijaMUsic,JustNaija for track duration and genre.
- TODO: Put A Summary for every Engine.
- TODO: Add a deezer/spotify/youtube search and download via url engine.
- TODO: Proper Results clean up. Removing unnecesary characters appended to titles and proper formating of other results parameters.
## Contributing
Want to contribute to Getmusic? Awesome! Check out the [contributing guidelines](docs/CONTRIBUTE.md) to get involved.