- Go 99.8%
- Shell 0.2%
| cmd/kanade | ||
| docs | ||
| internal | ||
| scripts | ||
| ui | ||
| .gitignore | ||
| config.toml.example | ||
| go.mod | ||
| go.sum | ||
| kanade.go | ||
| README.md | ||
Kanade 奏
Un lecteur de musique en terminal qui réunit tous tes serveurs dans une seule bibliothèque. Jellyfin, Emby, Navidrome, Plex, Ampache, tes dossiers, YouTube, SoundCloud et Bandcamp : tout au même endroit, au clavier ou à la souris.
Ce qu'il fait
- Toutes tes sources ensemble : chaque titre porte le badge de son serveur (
[JF],[ND],[YT]…, ou sa pastille colorée avec[ui] icons = true), et une recherche les interroge toutes à la fois. - Radios web et directs : LISTEN.moe et d'autres radios J-pop / anime, avec la chanson et la pochette en cours, et les directs YouTube.
- Last.fm et MPRIS : scrobbling, ♥ synchronisés, statistiques ; touches média,
playerctlet widget Plasma. - Pochettes et spectre dans le terminal (kitty, sixel, iTerm2, ou demi-blocs partout, ssh compris).
- Transferts et hors ligne : envoie un album vers ton NAS en un
T, garde-le sur ton disque en uno. - Playlists dynamiques et radio :
bpm:120..130 genre:house likeddevient une playlist qui se tient à jour ; le radio enchaîne des titres proches. - Tags suivis et corrigés : BPM, tonalité et genres trouvés en ligne, et des corrections proposées à partir de MusicBrainz, que tu valides.
- En français, en anglais ou en japonais, selon ton système.
- La musique continue quand tu fermes l'interface : un démon joue, le TUI s'y raccroche.
En images
![]() |
![]() |
| Un album en lecture, et le panneau « en cours » | L'onglet Tags : suivi et corrections |
![]() |
![]() |
Les réglages (c) |
L'interface en japonais |
![]() |
![]() |
| La bibliothèque et sa barre de filtres | L'aide (?) |
Installer
Avec Go 1.27 :
go install ./cmd/kanade # depuis le dépôt ; le binaire arrive dans ~/go/bin
Ou télécharge le binaire d'une release.
Kanade a besoin de mpv (lecture), et profite de yt-dlp (YouTube), ffmpeg et ffprobe
(transferts, tags), PipeWire (spectre), d'un trousseau Secret Service et du D-Bus de session
(MPRIS). Sur Arch :
sudo pacman -S mpv yt-dlp ffmpeg pipewire
Le détail : installation.
Démarrer
kanade
Au premier lancement, un assistant t'aide à ajouter tes sources (avec un test de
connexion), Last.fm et la langue. Ensuite, c ouvre les réglages à tout moment.
Quelques commandes utiles :
kanade ctl state # ce qui joue, sans ouvrir le TUI
kanade ctl search bashung # cherche dans toutes les sources
kanade config check # vérifie la config et les outils
kanade ctl quit # arrête le démon et la musique
Les touches essentielles (vim par défaut, toutes remappables) :
| Touche | Action |
|---|---|
j k / h l |
se déplacer / revenir, ouvrir |
Tab |
onglet suivant |
/ |
rechercher, ou filtrer la liste |
Espace |
lecture / pause |
n / p |
titre suivant / précédent |
a / A |
ajouter à la file / jouer ensuite |
f |
favori |
c |
réglages |
? |
aide, avec toutes les touches |
q / Q |
fermer le TUI (la musique continue) / tout arrêter |
Toutes les touches : raccourcis.
Sources
| Source | Badge | Bloc de config |
|---|---|---|
| Jellyfin | [JF] |
[[jellyfin]] |
| Emby | [EM] |
[[emby]] |
| Navidrome / Subsonic | [ND] |
[[subsonic]] |
| Plex | [PX] |
[[plex]] |
| Ampache | [AM] |
[[ampache]] |
| Dossier de musique | [DIR] |
[[folder]] |
| YouTube | [YT] |
[youtube] |
| SoundCloud | [SC] |
[soundcloud] |
| Bandcamp | [BC] |
[bandcamp] |
| Hors ligne | [↓] |
[offline] |
Aucun mot de passe dans config.toml : ils vont dans le trousseau. Ce que chaque source
sait faire, et où trouver son jeton : docs/sources.
Documentation
- Le guide : configuration, interface, raccourcis, ligne de commande, Last.fm, transferts, playlists dynamiques, tags.
- Les sources : une fiche par serveur, et comment en ajouter un.
- Les langues : traduire Kanade.
- config.toml.example : la configuration complète, commentée.
- Toute la documentation, y compris le plan du projet.
Crédits
BPM et tonalité fournis par GetSongBPM.






