Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/snuffyDev/Beatbump

Alternative YouTube Music frontend built with Svelte/SvelteKit 🎧
https://github.com/snuffyDev/Beatbump

alternative-frontends cloudflare-workers docker-compose frontend javascript music privacy pwa self-hosted svelte sveltekit webapp youtube youtube-music youtube-music-api

Last synced: about 2 months ago
JSON representation

Alternative YouTube Music frontend built with Svelte/SvelteKit 🎧

Host: GitHub
URL: https://github.com/snuffyDev/Beatbump
Owner: snuffyDev
License: agpl-3.0
Created: 2021-06-17T18:37:49.000Z (over 3 years ago)
Default Branch: master
Last Pushed: 2024-05-29T22:42:13.000Z (7 months ago)
Last Synced: 2024-10-25T04:08:37.901Z (about 2 months ago)
Topics: alternative-frontends, cloudflare-workers, docker-compose, frontend, javascript, music, privacy, pwa, self-hosted, svelte, sveltekit, webapp, youtube, youtube-music, youtube-music-api
Language: TypeScript
Homepage: https://beatbump.io/
Size: 86.2 MB
Stars: 1,060
Watchers: 23
Forks: 90
Open Issues: 102
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE

Awesome Lists containing this project

awesome-privacy-front-ends - Beatbump - A privacy-respecting alternative frontend for YouTube Music. `TypeScript/AGPL-3.0`. (List / YouTube Music)
awesome-svelte-kit - Beatbump - Alternative YouTube Music frontend built with Svelte/SvelteKit (📦 Built With Svelte / Open-Source Projects)
alternative-front-ends - Beatbump

README

        

# Beatbump

A privacy-respecting alternative frontend for YouTube Music. Built with SvelteKit, official instance hosted with Cloudflare Workers.

> NOTE: Beatbump is going through a major rewrite, so errors, bugs, and other problems may happen at random.



|  |  |  |

| ------------------------------------------------ | ------------------------------------------------------------- | ---------------------------------------------- |





	  

    

  

  

    

  



## Why Beatbump?

Beatbump is a fully-featured music listening experience, while helping to ease your privacy concerns associated with other platforms.

Some of Beatbump's features includes:

- Automix for continued listening

- No ads

- Background play on mobile devices\*

- Search for artists, playlists, songs, and albums

  - Note that all playback is audio only (for now)

- Local playlist management

  - Stored in-browser with IndexedDB

  - Can save songs individually under 'Favorites'

  - Peer-to-Peer data synchronization (using WebRTC)

- Group Sessions

  - Achieved using a WebRTC [mesh](https://en.wikipedia.org/wiki/Mesh_networking)

- Uses a custom wrapper around the YouTube Music API

...and so much more!

> [1] iOS updates may break this from time to time, but works as of iOS 15.6

## Repo Structure

| Directory                     | Description                                           |

| ----------------------------- | ----------------------------------------------------- |

| `app`                         | Beatbump web app                                      |

| `packages/hls-proxy-rewriter` | Proxy server used for Beatbump's music playback (WIP) |

## Instances

> Service Uptime Monitoring: https://stats.uptimerobot.com/9PnmRfz6Gm

| Name                             | URL

| ---                              | ---                                                                       |

| Beatbump (Official)              | https://beatbump.io                                                       |

| ~Vern (Clearnet)                 | https://bb.vern.cc/                                                       |

| ~Vern (Onion)                    | http://bb.vernccvbvyi5qhfzyqengccj7lkove6bjot2xhh5kajhwvidqafczrad.onion/ |

| ~Vern (I2P)                      | http://vern6inmbjzqpecx4kpkq5sln3cqqrfuxfzh4au3tpxbsfbwbnta.b32.i2p/      |

| btb.frail.duckdns.org (Clearnet) | https://btb.frail.duckdns.org/                                            |

| bb.ggtyler.dev (Clearnet)        | https://bb.ggtyler.dev/                                                   |

| ytm.sudovanilla.com (Cloudflare) | ytm.sudovanilla.com                                                       |

## Donations

Want to support Beatbump financially to aid with future development/hosting?

[Donate with PayPal!](https://www.paypal.com/donate/?hosted_button_id=E6YRHKS2H2KP2)

Donations of any amount are very much appreciated, so thank you if you choose to donate!

_(Other ways to donate coming soon!)_

## Docker

> Note: Still figuring out how to use Docker! Got a suggestion? Open an issue, thanks!

[DockerHub](https://hub.docker.com/r/snuffydev/beatbump)

### docker-compose (production)

The quickest way to host a Beatbump instance is with [Docker](https://www.docker.com/get-started). Once you have it installed, you can run:

```

docker-compose up

```

The app will now be accessible from `https://localhost:443  /  http://localhost:3000`.

### docker-compose (development)

(More details coming soon!)

## Documentation

You can find (temporary, incomplete, and in-progress) API documentation here: https://beatbump-docs.vercel.app/

> It's recommended (and appreciated) to host your own instance of Beatbump for public projects that want to use the data -- especially if you anticipate you will be making a large amount of requests. Thanks!

## Project Inspirations

- [Invidious](https://github.com/iv-org/invidious) - a privacy focused alternative YouTube front end.