Files
wiki/Catalogue-Self-Hosted/apps/app-beatbump.md
T
2026-06-09 18:40:21 +02:00

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

Pages Liées