3.6 KiB
title: Beatbump created: 2026-06-07 updated: 2026-06-07 type: app tags: [catalogue, front-end, youtube-music, music, svelte] confidence: high contested: false sources: [https://selfh.st/apps/?q=beatbump]
Beatbump
Front-end libre et auto-hébergeable pour YouTube Music, sans publicité et sans compte Google.
| Métadonnée | Valeur |
|---|---|
| Site web | https://beatbump.music |
| GitHub | https://github.com/snuffyDev/Beatbump |
| License | AGPL-3.0 |
| Langage principal | SvelteKit (TypeScript) |
| Étoiles GitHub | 92 |
| Dernière MAJ | 2026 |
| Catégorie | cat-front-end |
Description
Beatbump est un front-end open source pour YouTube Music, développé en SvelteKit. Il permet d'écouter l'intégralité du catalogue YouTube Music (plus de 100 millions de titres) via une interface moderne, sans publicité, sans compte requis et sans appel aux serveurs de Google depuis le navigateur client.
L'interface propose la recherche, l'écoute d'albums, d'artistes et de playlists, la gestion de favoris locaux, la lecture aléatoire et en boucle, la file d'attente persistante, et un mode "Discover" basé sur des recommandations communautaires (et non l'algorithme de YouTube). Le lecteur supporte le streaming audio de haute qualité (jusqu'à 256kbps Opus) via les serveurs proxifiés de YouTube.
Beatbump est particulièrement adapté aux appareils low-spec grâce à sa faible empreinte JavaScript (Svelte compile en pur DOM) et son mode PWA qui permet l'installation en mode natif sur Android/iOS. C'est l'équivalent musical de app-invidious et app-piped pour l'audio.
Installation
Via Docker (recommandé)
services:
beatbump:
image: ghcr.io/snuffydev/beatbump:latest
container_name: beatbump
restart: unless-stopped
ports:
- "3000:3000"
environment:
VITE_API: https://yt-api.music.moe/api/v1
VITE_PROXY_URL: https://piped-instances.kavin.rocks
ORIGIN: https://beatbump.example.com
Installation manuelle
Cloner le dépôt, puis pnpm install et pnpm build. Lancer le serveur Node avec node build ou utiliser un serveur statique (Caddy, Nginx) pointant vers build/. Le projet nécessite Node 18+ et pnpm 8+.
Configuration
Les options sont passées en variables d'environnement au build. Les principales : VITE_API (URL de l'API YouTube Music, par défaut yt-api.music.moe), VITE_PROXY_URL (instance de streaming, ex. Piped), et ORIGIN (URL publique utilisée pour le CORS et le PWA).
Alternatives
Open source
- app-invidious — Front-end YouTube généraliste (vidéo)
- app-piped — Front-end YouTube avec support YouTube Music
- app-materialious — Front-end YouTube avec UI Material
- app-ymd — Client YouTube Music Android alternatif
Propriétaires
- YouTube Music — Plateforme officielle avec compte Google obligatoire
- Spotify — Concurrent payant, catalogue différent
- Apple Music — Concurrent propriétaire d'Apple
Sécurité
- Mettre en place un rate-limiter sur les routes de proxy audio
- Activer HTTPS strict avec HSTS
- Héberger derrière un reverse proxy (app-caddy) pour cacher les assets statiques
- Ne pas stocker de tokens d'API YouTube dans le dépôt
- Surveiller l'usage CPU/RAM : le proxy audio peut être gourmand
Ressources
- Site officiel : https://beatbump.music
- Code source : https://github.com/snuffyDev/Beatbump
- Documentation : https://github.com/snuffyDev/Beatbump#readme
- API compatible : https://yt-api.music.moe