{"id":13409463,"url":"https://github.com/snuffyDev/Beatbump","last_synced_at":"2025-03-14T14:31:33.676Z","repository":{"id":38077561,"uuid":"377928549","full_name":"snuffyDev/Beatbump","owner":"snuffyDev","description":"Alternative YouTube Music frontend built with Svelte/SvelteKit 🎧","archived":false,"fork":false,"pushed_at":"2024-05-29T22:42:13.000Z","size":90341,"stargazers_count":1089,"open_issues_count":100,"forks_count":92,"subscribers_count":23,"default_branch":"master","last_synced_at":"2025-03-11T09:12:27.312Z","etag":null,"topics":["alternative-frontends","cloudflare-workers","docker-compose","frontend","javascript","music","privacy","pwa","self-hosted","svelte","sveltekit","webapp","youtube","youtube-music","youtube-music-api"],"latest_commit_sha":null,"homepage":"https://beatbump.io/","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/snuffyDev.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"custom":["https://www.paypal.com/donate/?hosted_button_id=E6YRHKS2H2KP2","https://www.buymeacoffee.com/snuffydev"],"ko_fi":"snuffydev"}},"created_at":"2021-06-17T18:37:49.000Z","updated_at":"2025-03-10T07:18:00.000Z","dependencies_parsed_at":"2024-10-24T16:13:45.524Z","dependency_job_id":null,"html_url":"https://github.com/snuffyDev/Beatbump","commit_stats":null,"previous_names":[],"tags_count":32,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/snuffyDev%2FBeatbump","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/snuffyDev%2FBeatbump/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/snuffyDev%2FBeatbump/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/snuffyDev%2FBeatbump/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/snuffyDev","download_url":"https://codeload.github.com/snuffyDev/Beatbump/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243593448,"owners_count":20316185,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["alternative-frontends","cloudflare-workers","docker-compose","frontend","javascript","music","privacy","pwa","self-hosted","svelte","sveltekit","webapp","youtube","youtube-music","youtube-music-api"],"created_at":"2024-07-30T20:01:01.052Z","updated_at":"2025-03-14T14:31:28.656Z","avatar_url":"https://github.com/snuffyDev.png","language":"TypeScript","readme":"\u003cimg align=\"right\" src=\".repo/images/logo-header.png\" width=\"128px\" height=\"128px\" /\u003e\n\n# Beatbump\n\nA privacy-respecting alternative frontend for YouTube Music. Built with SvelteKit, official instance hosted with Cloudflare Workers.\n\n\u003e NOTE: Beatbump is going through a major rewrite, so errors, bugs, and other problems may happen at random.\n\n\u003cdiv align=\"center\"\u003e\n\n| \u003cimg src=\".repo/images/playlist.jpeg\" width=\"\"/\u003e | \u003cimg src=\".repo/images/m_artist.png\" width=\"\" height=\"auto\"/\u003e | \u003cimg src=\".repo/images/m_queue.png\" width=\"\"/\u003e |\n| ------------------------------------------------ | ------------------------------------------------------------- | ---------------------------------------------- |\n\n\u003c/div\u003e\n\u003cp align=\"center\"\u003e\n\t  \u003ca href=\"https://www.gnu.org/licenses/agpl-3.0.en.html\"\u003e\n    \u003cimg alt=\"License: AGPLv3\" src=\"https://shields.io/badge/License-AGPL%20v3-blue.svg\"\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://codeberg.org/teaserbot-labs/delightful-humane-design\"\u003e\n    \u003cimg alt=\"Awesome Humane Tech\" src=\"https://raw.githubusercontent.com/humanetech-community/awesome-humane-tech/main/humane-tech-badge.svg?sanitize=true\"\u003e\n  \u003c/a\u003e\n\u003c/p\u003e\n\n## Why Beatbump?\n\nBeatbump is a fully-featured music listening experience, while helping to ease your privacy concerns associated with other platforms.\n\nSome of Beatbump's features includes:\n\n- Automix for continued listening\n- No ads\n- Background play on mobile devices\\*\n- Search for artists, playlists, songs, and albums\n  - Note that all playback is audio only (for now)\n- Local playlist management\n  - Stored in-browser with IndexedDB\n  - Can save songs individually under 'Favorites'\n  - Peer-to-Peer data synchronization (using WebRTC)\n- Group Sessions\n  - Achieved using a WebRTC [mesh](https://en.wikipedia.org/wiki/Mesh_networking)\n- Uses a custom wrapper around the YouTube Music API\n\n...and so much more!\n\n\u003e [1] iOS updates may break this from time to time, but works as of iOS 15.6\n\n## Repo Structure\n\n| Directory                     | Description                                           |\n| ----------------------------- | ----------------------------------------------------- |\n| `app`                         | Beatbump web app                                      |\n| `packages/hls-proxy-rewriter` | Proxy server used for Beatbump's music playback (WIP) |\n\n\n## Instances\n\n\u003e Service Uptime Monitoring: https://stats.uptimerobot.com/9PnmRfz6Gm\n\n| Name                             | URL\n| ---                              | ---                                                                       |\n| Beatbump (Official)              | https://beatbump.io                                                       |\n| ~Vern (Clearnet)                 | https://bb.vern.cc/                                                       |\n| ~Vern (Onion)                    | http://bb.vernccvbvyi5qhfzyqengccj7lkove6bjot2xhh5kajhwvidqafczrad.onion/ |\n| ~Vern (I2P)                      | http://vern6inmbjzqpecx4kpkq5sln3cqqrfuxfzh4au3tpxbsfbwbnta.b32.i2p/      |\n| btb.frail.duckdns.org (Clearnet) | https://btb.frail.duckdns.org/                                            |\n| bb.ggtyler.dev (Clearnet)        | https://bb.ggtyler.dev/                                                   |\n| ytm.sudovanilla.com (Cloudflare) | ytm.sudovanilla.com                                                       |\n\n\n## Donations\n\nWant to support Beatbump financially to aid with future development/hosting?\n\n[Donate with PayPal!](https://www.paypal.com/donate/?hosted_button_id=E6YRHKS2H2KP2)\n\nDonations of any amount are very much appreciated, so thank you if you choose to donate!\n\n_(Other ways to donate coming soon!)_\n\n## Docker\n\n\u003e Note: Still figuring out how to use Docker! Got a suggestion? Open an issue, thanks!\n\n[DockerHub](https://hub.docker.com/r/snuffydev/beatbump)\n\n### docker-compose (production)\nThe quickest way to host a Beatbump instance is with [Docker](https://www.docker.com/get-started). Once you have it installed, you can run:\n\n```\ndocker-compose up\n```\n\nThe app will now be accessible from `https://localhost:443  /  http://localhost:3000`.\n\n### docker-compose (development)\n\n\n(More details coming soon!)\n\n## Documentation\n\nYou can find (temporary, incomplete, and in-progress) API documentation here: https://beatbump-docs.vercel.app/\n\n\u003e 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!\n\n## Project Inspirations\n\n- [Invidious](https://github.com/iv-org/invidious) - a privacy focused alternative YouTube front end.\n","funding_links":["https://www.paypal.com/donate/?hosted_button_id=E6YRHKS2H2KP2","https://www.buymeacoffee.com/snuffydev","https://ko-fi.com/snuffydev"],"categories":["TypeScript","Media Streaming Platforms","Overview","List","📦 Built With Svelte","frontend"],"sub_categories":["Email Alias Services (Anonymous Forwarding)","YouTube Music","Open-Source Projects"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FsnuffyDev%2FBeatbump","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FsnuffyDev%2FBeatbump","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FsnuffyDev%2FBeatbump/lists"}