{"id":13553524,"url":"https://github.com/adblockradio/buffer","last_synced_at":"2025-04-03T05:31:02.247Z","repository":{"id":90758307,"uuid":"154836802","full_name":"adblockradio/buffer","owner":"adblockradio","description":"A player that buffers radio content and lets you fast-forward ads. Uses Adblock Radio as a backend.","archived":true,"fork":false,"pushed_at":"2019-05-05T12:08:38.000Z","size":803,"stargazers_count":83,"open_issues_count":0,"forks_count":6,"subscribers_count":6,"default_branch":"master","last_synced_at":"2024-11-04T01:32:43.189Z","etag":null,"topics":["adblockradio","player","radio","react"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/adblockradio.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"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}},"created_at":"2018-10-26T13:12:05.000Z","updated_at":"2024-06-09T23:43:54.000Z","dependencies_parsed_at":null,"dependency_job_id":"c31d6e8c-3323-455a-9422-21a3d464ce80","html_url":"https://github.com/adblockradio/buffer","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/adblockradio%2Fbuffer","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/adblockradio%2Fbuffer/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/adblockradio%2Fbuffer/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/adblockradio%2Fbuffer/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/adblockradio","download_url":"https://codeload.github.com/adblockradio/buffer/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246944377,"owners_count":20858773,"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":["adblockradio","player","radio","react"],"created_at":"2024-08-01T12:02:27.172Z","updated_at":"2025-04-03T05:31:01.800Z","avatar_url":"https://github.com/adblockradio.png","language":"JavaScript","funding_links":[],"categories":["JavaScript"],"sub_categories":[],"readme":"# Adblock Radio Buffer\nListen to the radio ad-free and without interruptions.\nAdblock Radio Buffer buffers radio content and lets you fast-forward ads.\n\nUses [Adblock Radio](https://github.com/adblockradio/adblockradio) as a backend, featuring machine-learning and acoustic fingerprinting techniques.\n\n[A technical discussion describes how it works](https://www.adblockradio.com/blog/2018/11/15/designing-audio-ad-block-radio-podcast/).\n\n## Preview\n\n![](doc/abr-buffer.png)\n\n### Player interface\n\nFor each radio, metadata is retrieved with the [open source live metadata scraper](https://github.com/adblockradio/webradio-metadata).\n\nA colored bar indicates how much of audio is available. Default setting is to buffer up to 15 minutes.\nEach color tells the user about the content of the audio:\n- blue for music\n- green for talk\n- red for ads\n\n### Select the content you want to hear\n\nYou can choose what kind of content you want to hear or skip on each radio.\n\nOn news stations, it is great just to skip ads.\nOn musical stations, it's convenient to skip ads and also talk interruptions.\n\n### Many radios available, more to come\n\nAt the time of writing, 84 radios are available in the player.\n\nIt is planned to add more. You can [submit requests here](https://github.com/adblockradio/available-models/).\n\n### Crowd-sourced improvements of the filters\n\nSometimes the predictor is wrong. Not a problem, it is possible to report mispredictions.\n\nIt makes Adblock Radio better for everybody.\n\n## Installation\n\n### Docker (recommended for most users)\n\nChoose a directory where configuration and log files will be stored.\n```\nmkdir /var/lib/adblockradio\nmkdir /var/lib/adblockradio/config\nmkdir /var/lib/adblockradio/log\n```\n\nBuilt images are available on Docker Hub as `adblockradio/buffer`. Check on https://hub.docker.com/r/adblockradio/buffer.\n\nFind the version you want to run, e.g. `0.1.0`.\n\n```\nVERSION=0.1.0\ndocker pull adblockradio/buffer:$VERSION\ncd /var/lib/adblockradio\ndocker run -it -p 9820:9820 -a STDOUT --mount type=bind,source=\"$(pwd)\"/config,target=/usr/src/adblockradio-buffer/config --mount type=bind,source=\"$(pwd)\"/log,target=/usr/src/adblockradio-buffer/log adblockradio/buffer:$VERSION\n```\nThe interface should now be available at http://localhost:9820/. Type Ctrl-P Ctrl-Q to detach from the container.\n\nTo make it accessible to remote clients, configure e.g. Nginx the following way:\n```\nserver {\n        server_name subdomain.your-server.com;\n        root /usr/share/nginx/html;\n\n        location / {\n                proxy_set_header   X-Real-IP $remote_addr;\n                proxy_set_header   Host      $http_host;\n                proxy_pass         http://127.0.0.1:9820;\n                proxy_set_header   X-Forwarded-Proto https;\n        }\n        listen 80;\n}\n```\nand use [Certbot](https://certbot.eff.org/) to enable HTTPS. You are good to go.\n\nAdvanced users and developers can build their own Docker image with `docker-build.sh`.\n\n### Desktop binary (Linux only, alpha quality)\nAn Electron Linux binary is available [here](http://cdn.s00.adblockradio.com/ABR-Buffer-v1.0.tar.gz).\nIt has been tested on Debian 8.0/LMDE2 x64.\nIt needs `ffmpeg` on your system. If you do not have it, run `sudo apt install ffmpeg`.\n\nWindows and Mac builds are expected in the future.\n\n### From source\nInstallation instructions expect a minimum of technical knowledge.\n\nCreate an empty directory somewhere on your machine, we call it `DIR`.\n\nFirst, install [Adblock Radio algorithm](https://github.com/adblockradio/adblockradio). You should now have `DIR/adblockradio` with the files inside. In that subdirectory, run `node demo.js` to check everything is working correctly.\n\nThen, install this player. Run these commands in `DIR`, so that `DIR/buffer` will be created:\n```\ngit clone https://github.com/adblockradio/buffer.git\ncd buffer\nnpm install\ncd client\nnpm install\nnpm run build\ncd ..\n```\n\n#### Interface in browser\n```\nnpm run start\n```\nOpen `http://localhost:9820` in your favorite browser.\nAdd your radios and enjoy!\n\n#### Interface in Electron (native desktop app)\n```\ncd node_modules/adblockradio\nnpm rebuild zeromq --runtime=electron --target=3.1.7 --update-binary\ncd ../..\nnpm run electron\n```\nAdd your radios and enjoy!\n\n\n### Development\n\nIn a first terminal, open React dev server:\n```\ncd client\nnpm start\n```\n\n#### Interface in browser\nIn another terminal, run the backend:\n```\nnpm run startdev\n```\nOpen `http://localhost:9820` in your favorite browser.\n\n#### Interface in Electron (native desktop app)\nIn another terminal, run the backend:\n```\nnpm run electrondev\n```\n\n## Roadmap\n\n- Nicer UI and UX (help would be appreciated)\n- Cross platform Electron builds\n- Docker builds (WIP)\n- Cordova apps (WIP), or even better React native apps\n\nContributions welcome.\n\n## Copyright\n\nCopyright 2018-2019, [Alexandre Storelli](https://github.com/dest4)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fadblockradio%2Fbuffer","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fadblockradio%2Fbuffer","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fadblockradio%2Fbuffer/lists"}