Search and download music from YouTube Music with lyrics
Project description
Kikusan
Search and download music from YouTube Music with lyrics.
Features
- Search YouTube Music
- Download audio in OPUS/MP3/FLAC format
- Playlist support (download entire playlists)
- Quick download (search and download first match)
- Automatic lyrics fetching from lrclib.net (LRC format)
- CLI and web interface
- Docker support
Installation
uv sync
Usage
CLI
# Search for music
kikusan search "Bohemian Rhapsody"
# Download by video ID
kikusan download bSnlKl_PoQU
# Download by URL
kikusan download --url "https://music.youtube.com/watch?v=bSnlKl_PoQU"
# Search and download first match
kikusan download --query "Bohemian Rhapsody Queen"
# Download entire playlist
kikusan download --url "https://music.youtube.com/playlist?list=..."
# Custom filename format
kikusan download bSnlKl_PoQU --filename "%(title)s"
# Options
kikusan download bSnlKl_PoQU --output ~/Music --format mp3
Web Interface
kikusan web
# Open http://localhost:8000
Docker
docker compose up -d
# Open http://localhost:8000
Configuration
Environment variables:
| Variable | Default | Description |
|---|---|---|
KIKUSAN_DOWNLOAD_DIR |
./downloads |
Download directory |
KIKUSAN_AUDIO_FORMAT |
opus |
Audio format (opus, mp3, flac) |
KIKUSAN_FILENAME_TEMPLATE |
%(artist,uploader)s - %(title)s |
Filename template (yt-dlp format) |
KIKUSAN_WEB_PORT |
8000 |
Web server port |
KIKUSAN_WEB_PLAYLIST |
None |
M3U playlist name for web downloads (optional) |
Requirements
- Python 3.12+
- ffmpeg (for audio processing)
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
kikusan-0.4.0.tar.gz
(90.5 kB
view details)
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
kikusan-0.4.0-py3-none-any.whl
(37.7 kB
view details)
File details
Details for the file kikusan-0.4.0.tar.gz.
File metadata
- Download URL: kikusan-0.4.0.tar.gz
- Upload date:
- Size: 90.5 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.7
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
d37bd6885747064ba5aba7a5a76b0c151fbc98ad895601b6ceb2cdce363ef8d7
|
|
| MD5 |
820343a8b390729bc22e14dbbd6d9f49
|
|
| BLAKE2b-256 |
66945ae8c9e0a0c2de2260968d6d788111486090c43d4245e9289ea812d41729
|
Provenance
The following attestation bundles were made for kikusan-0.4.0.tar.gz:
Publisher:
publish.yml on dadav/kikusan
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
kikusan-0.4.0.tar.gz -
Subject digest:
d37bd6885747064ba5aba7a5a76b0c151fbc98ad895601b6ceb2cdce363ef8d7 - Sigstore transparency entry: 834649697
- Sigstore integration time:
-
Permalink:
dadav/kikusan@331213e3f37a34ed61db2f4253de8fadd5493ef7 -
Branch / Tag:
refs/tags/v0.4.0 - Owner: https://github.com/dadav
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@331213e3f37a34ed61db2f4253de8fadd5493ef7 -
Trigger Event:
push
-
Statement type:
File details
Details for the file kikusan-0.4.0-py3-none-any.whl.
File metadata
- Download URL: kikusan-0.4.0-py3-none-any.whl
- Upload date:
- Size: 37.7 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.7
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
47ead4a7cca629062158b2b74d5dc97fc619a740608377df0cfb2b05f3554f05
|
|
| MD5 |
691a6bd1bb53450f1ff9fa97a596cce1
|
|
| BLAKE2b-256 |
ea72dbd78f431f43c6430b07e5f9873bf8ac5e03b0a30e20cb86c223e3548562
|
Provenance
The following attestation bundles were made for kikusan-0.4.0-py3-none-any.whl:
Publisher:
publish.yml on dadav/kikusan
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
kikusan-0.4.0-py3-none-any.whl -
Subject digest:
47ead4a7cca629062158b2b74d5dc97fc619a740608377df0cfb2b05f3554f05 - Sigstore transparency entry: 834649715
- Sigstore integration time:
-
Permalink:
dadav/kikusan@331213e3f37a34ed61db2f4253de8fadd5493ef7 -
Branch / Tag:
refs/tags/v0.4.0 - Owner: https://github.com/dadav
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@331213e3f37a34ed61db2f4253de8fadd5493ef7 -
Trigger Event:
push
-
Statement type:
