---
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é)
```yaml
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

## Pages Liées
- [[cat-front-end]]
- [[recettes-docker-compose]]
