Skip to main content

An extensive music downloader crawling the internet. It gets its metadata from a couple of metadata providers, and it scrapes the audiofiles.

Project description

Music Kraken

Woodpecker CI Status

music kraken logo

If you want to use this a library or contribute, check out the wiki for more information.


Installation

You can find and get this project from either PyPI as a Python-Package, or simply the source code from Gitea. **

NOTES

  • Even though everything SHOULD work cross-platform, I have only tested it on Ubuntu.
  • If you enjoy this project, feel free to give it a star on GitHub.

From source

git clone https://gitea.elara.ws/music-kraken/music-kraken-core.git
python3 -m pip install -e music-kraken-core/

To update the program, if installed like this, go into the music-kraken-core directory and run git pull.

Get it running on other Systems

Here are the collected issues, that are related to running the program on different systems. If you have any issues, feel free to open a new one.

Windows + WSL

Add ~/.local/bin to your $PATH. #2

Quick-Guide

The Genre you define at the start, is the folder my program will download the files into, as well as the value of the ID3 genre field.

When it drops you into the shell 2 main things are important:

  1. You search with s: <query/url>
  2. You choose an option with just the index number of the option
  3. You download with d: <options/url>, where the options are comma separated

Query

The syntax for the query is really simple.

> s: #a <any artist>
searches for the artist <any artist>

> s: #a <any artist> #r <any release>
searches for the release (album) <any release> by the artist <any artist>

> s: #r <any release> Me #t <any track>
searches for the track <any track> from the release <any relaese>

The escape character is as usual \.


Matrix Space

music-kraken logo

I decided against creating a discord server, due to various communities get often banned from discord. A good and free Alternative are Matrix Spaces. I recommend the use of the Client Element. It is completely open source.

Click this invitation (https://matrix.to/#/#music-kraken:matrix.org) to join.

Project details


Release history Release notifications | RSS feed

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

music_kraken-1.15.2.dev100.tar.gz (104.6 kB view details)

Uploaded Source

Built Distribution

music_kraken-1.15.2.dev100-py3-none-any.whl (135.9 kB view details)

Uploaded Python 3

File details

Details for the file music_kraken-1.15.2.dev100.tar.gz.

File metadata

  • Download URL: music_kraken-1.15.2.dev100.tar.gz
  • Upload date:
  • Size: 104.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.0.0 CPython/3.12.3

File hashes

Hashes for music_kraken-1.15.2.dev100.tar.gz
Algorithm Hash digest
SHA256 9bf01d6ea13dcf73547985d318341ddc2143e6fb3e1428a62d4f09ec0ebd647e
MD5 e86cf1b61cff0bf38557750c7ec4b764
BLAKE2b-256 b260c8dfbd2633ccd4c668d3f05df71df4a2a8faeed6b8e2d7522f3600c5a292

See more details on using hashes here.

File details

Details for the file music_kraken-1.15.2.dev100-py3-none-any.whl.

File metadata

File hashes

Hashes for music_kraken-1.15.2.dev100-py3-none-any.whl
Algorithm Hash digest
SHA256 ba537d6eec74df9d8fb111062c97c5701ba717b1d5e70ef2a44c398ec8720d1a
MD5 8cf7650f790f02d3c9cad590745ddc56
BLAKE2b-256 4af13b1e1204a365d35aa4f6e07c6a3ca1e96e510b344ea0a8e9df964a7ae93b

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page