Git Product home page Git Product logo

beatbump's Introduction

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.

License: AGPLv3 Awesome Humane Tech

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
  • 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.ml
~Vern (Clearnet) https://bb.vern.cc/
~Vern (Onion) http://bb.vernccvbvyi5qhfzyqengccj7lkove6bjot2xhh5kajhwvidqafczrad.onion/
~Vern (I2P) http://vern6inmbjzqpecx4kpkq5sln3cqqrfuxfzh4au3tpxbsfbwbnta.b32.i2p/
Project Segfault (GeoDNS) https://bb.projectsegfau.lt/
Project Segfault (EU) https://bb.eu.projectsegfau.lt/
Project Segfault (US) https://bb.us.projectsegfau.lt/
Project Segfault (IN) https://bb.in.projectsegfau.lt/
Project Segfault (Tor) http://beatbump.pjsfkvpxlinjamtawaksbnnaqs2fc2mtvmozrzckxh7f3kis6yea25ad.onion/
Project Segfault (I2P) http://pjsfk4xvekoc7wx4pteevp3q2wy7jmzlem7rvl74nx33zkdr4vyq.b32.i2p/
btb.frail.duckdns.org (Clearnet) https://btb.frail.duckdns.org/

Donations

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

Donate with PayPal!

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

docker-compose (production)

The quickest way to host a Beatbump instance is with Docker. 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 - a privacy focused alternative YouTube front end.

beatbump's People

Contributors

snuffydev avatar alx-alexpark avatar davidcollini avatar mohammadrafigh avatar neeraj-2401 avatar ganyuke avatar locxter avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.