This program will first get the metadata of various songs from metadata providers like musicbrainz, and then search for download links on pages like bandcamp. Then it will download the song and edit the metadata accordingly.
Go to file
Lars Noack 3951394ede
All checks were successful
ci/woodpecker/push/woodpecker Pipeline was successful
feat: improved data structure docs
2024-05-07 09:10:04 +02:00
.idea feat: hooked into ytdl to sign the function 2024-01-31 15:07:49 +01:00
.vscode feat: updated installing instructions 2024-05-07 08:53:41 +02:00
assets fix: if request fails in a connection without host it raised an exception 2024-04-25 22:29:43 +02:00
development feat: allowed to append none to source collection 2024-05-06 18:40:21 +02:00
documentation feat: highlight downloadebel options 2024-01-16 10:08:08 +01:00
music_kraken fix: removing the possibility or file names containing / 2024-05-06 18:48:13 +02:00
tests feat: added tests 2024-04-29 15:31:32 +02:00
.env.example feat: auto disable debug on deploy 2024-04-10 12:18:32 +02:00
.gitignore ci: add _version.py to gitignore 2024-04-15 12:42:57 -07:00
.woodpecker.yml ci: force tags to be fetched 2024-04-16 11:07:27 -07:00
build ci: add pipeline 2024-04-15 11:44:19 -07:00
contribute.md updated documentation 2023-06-23 13:35:53 +02:00
LICENSE Initial commit 2022-10-14 13:02:01 +02:00
notes.md fixed tests, they pass now 2023-03-24 10:30:40 +01:00
pyproject.toml feat: embedded own sponsorblock in youtube 2024-04-25 20:35:36 +02:00
README.md feat: improved data structure docs 2024-05-07 09:10:04 +02:00
requirements-dev.txt feat: build script 2024-04-09 11:48:32 +02:00

Music Kraken

Woodpecker CI Status

music kraken logo

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 \.


Contribute

I am happy about every pull request. To contribute look here.

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.


Programming Interface / Use as Library

This application is 100\% centered around Data. Thus, the most important thing for working with musik kraken is, to understand how I structured the data.

Quick Overview

---
title: Quick Overview (outdated)
---
sequenceDiagram

participant pg as Page (eg. YouTube, MB, Musify, ...)
participant obj as DataObjects (eg. Song, Artist, ...)
participant db as DataBase

obj ->> db: write
db ->> obj: read

pg -> obj: find a source for any page, for object.
obj -> pg: add more detailed data from according page.
obj -> pg: if available download audio to target.

Data Model

Music metadata can be easily abstracted to a few main Entities with some relations between them. This enables the easy scraping and aggregation of the correct metadata for each Song. Those Entities are Song, Album, Artist and Label.

This is convenient because then I can just use for example one Artist, which adds its metadata shared and consistently to each of its song. This exactly was the reason why piracy was such a mess in the past. Metadata has a lot of redundancy, but the relational databases of streaming services don't. THIS is the main reason for this program, and in my opinion also the reason for the widespread adoption of streaming services.
---
title: music kraken - data model
---
erDiagram

Song {}
Album {}
Artist {}
Label {}

Song ||--o{ Album : album_collection
Song ||--o{ Artist : main_artist_collection
Song ||--o{ Artist : feature_artist_collection

Album ||--o{ Song : song_collection
Album ||--o{ Artist : artist_collection
Album ||--o{ Label : label_collection

Artist ||--o{ Song : feature_song_collection
Artist ||--o{ Album : main_album_collection
Artist ||--o{ Label : label_collection

Label ||--o{ Album : album_collection
Label ||--o{ Artist : current_artist_collection