{"id":31563245,"url":"https://github.com/macmpi/tiny-radiocd","last_synced_at":"2025-10-05T04:57:33.322Z","repository":{"id":39372389,"uuid":"264934566","full_name":"macmpi/tiny-radioCD","owner":"macmpi","description":"Small footprint mpd-based radioCD player, for bluetooth speakers \u0026 headphones","archived":false,"fork":false,"pushed_at":"2023-05-12T13:42:49.000Z","size":202,"stargazers_count":4,"open_issues_count":0,"forks_count":0,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-09-16T16:53:17.622Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Shell","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/macmpi.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}},"created_at":"2020-05-18T12:36:22.000Z","updated_at":"2023-08-27T21:12:24.000Z","dependencies_parsed_at":"2023-01-23T04:46:27.283Z","dependency_job_id":null,"html_url":"https://github.com/macmpi/tiny-radioCD","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/macmpi/tiny-radioCD","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/macmpi%2Ftiny-radioCD","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/macmpi%2Ftiny-radioCD/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/macmpi%2Ftiny-radioCD/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/macmpi%2Ftiny-radioCD/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/macmpi","download_url":"https://codeload.github.com/macmpi/tiny-radioCD/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/macmpi%2Ftiny-radioCD/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":278411259,"owners_count":25982368,"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","status":"online","status_checked_at":"2025-10-05T02:00:06.059Z","response_time":54,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":[],"created_at":"2025-10-05T04:57:30.812Z","updated_at":"2025-10-05T04:57:33.314Z","avatar_url":"https://github.com/macmpi.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# tiny-radioCD\n A small-footprint radioCD player, for Bluetooth speakers, headphones, car-audio systems,...\n\nThis personal project is geared towards simple \u0026 essential use-cases for casual listeners using Bluetooth speakers, and missing their good-old Audio CDs playback...\n\n\n## \u003cu\u003eMain Features:\u003c/u\u003e\n\n- Audio-CD \u0026 web radio player\n\n- Sound output to any Bluetooth audio equipment, and available default audio port (can be HiFi DAC)\n\n- Simple remote control via Bluetooth keys and/or network mpc client\n\n- Focus on ease of use \u0026 efficiency under low memory \u0026 hardware requirements (based on [AlpineLinux](https://www.alpinelinux.org/))\n\n- Headless operation, one-touch update\n\n\\\n**tiny-radioCD** just relies on [MPD](https://www.musicpd.org/), ALSA and [bluez-alsa](https://github.com/Arkq/bluez-alsa/): it does not need to provide a graphical remote UI.\\\nTypically runs in 50MB of RAM on a low-cost PiZero device (135 MB rootf suitable for RAM-only operation).\\\nCheck-out our minimalistic USB-powered [PiZeroWed-Mac mini](https://github.com/macmpi/tiny-radioCD/wiki/PiZeroWed-Mac-mini)!\n\nThough mostly tested on Pi, it would run on any AlpineLinux supported platform (diskless/data/sys modes).\\\nSome ready-to-use images are available (Raspberry Pi armhf ram-only SD archive for instance).\\\nCustomized installs can be included as simple addon-scripts (refer to available Pi example).\n\n\n\n## Seamless user operation:\n\nPlayer control (play/pause/etc...) is naturally operated with bluetooth speaker/headphone ***built-in keys***.\nVolume adjustment is set by speaker amplification stage.\n\n***Multimedia bluetooth remotes*** are a perfect match too, allowing extended use-cases.\\\nTypically, the low-cost first-generation ***FireTV remote*** (\u0026 clone) works great (more info in [Wiki](https://github.com/macmpi/tiny-radioCD/wiki)).\\\n***USB Keyboards*** with multimedia keys are supported too.\n\nWith network availability, any ***mpc client application*** can easily connect to **tiny-radioCD** player with Avahi discovery, and provide convenient user interface.\\\n[***MaximumMPD***](https://itunes.apple.com/gb/app/maximummpd/id1437096437?mt=8) on iOS is a good example of such clients, but there are many other available on any platforms.\n\n***Hardware buttons*** (power on/off, eject) availability depend on actual devices running tiny-radioCD, and can easily be customized: i.e. on Pi, simple on/off push-button can be enabled with `dtoverlay=gpio-shutdown` in `usercfg.txt`.\n\n***mpc commands*** also work under console or ssh, as last resort...\n\n\n\n## Install procedure:\n\nIf you don't use [ready-made images](https://github.com/macmpi/tiny-radioCD/wiki/Pre-built-images), just do the following on your [AlpineLinux device](https://wiki.alpinelinux.org/wiki/Installation) with internet access:\n```\ncd /tmp\nwget -O tiny-radioCD.zip https://github.com/macmpi/tiny-radioCD/archive/master.zip\nunzip -oq tiny-radioCD.zip\ncd tiny-radioCD\nchmod +x setup-tiny-radioCD\nsudo ./setup-tiny-radioCD\n```\n\nAfter install, bluetooth speaker pairing (and eventual remote command pairing) may be done under console or ssh (alternatively, check *[easy-setup](https://github.com/macmpi/tiny-radioCD/wiki)* section in Wiki):\\\n`sudo bluetoothctl`     After a \u003cu\u003escan\u003c/u\u003e, make sure you \u003cu\u003epair\u003c/u\u003e, \u003cu\u003econnect\u003c/u\u003e and \u003cu\u003etrust\u003c/u\u003e your bluetooth devices.\\\nTake note of your speaker MAC address `XX:XX:XX:XX:XX:XX` in your home directory with:\\\n`printf \"XX:XX:XX:XX:XX:XX\" \u003e myspeaker`\\\nThen finish speaker setup with the below command:\\\n`sudo set-speaker myspeaker`    this command may greatly help switching between paired speakers later.\\\n(if running in diskless mode, do not forget to commit changes after pairing: `lbu commit -d`)\n\nReboot to take advantage of your new **tiny-radioCD**!\n\n\n\n## Versions history:\n\n```\n0.5: (May 17th 2020)\n- initial release, Alpine 3.11\n```\n\n\n\n## Contributions:\n\nContributions are welcome in `dev` branch.\n\n\n\n\u003cu\u003eSide note:\u003c/u\u003e several very generic \u0026 complete packages exist, with extensive feature-set \u0026 remote Web UI service (special credits to [Volumio2](https://volumio.org/)): great stuff too, different use-cases focus.\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmacmpi%2Ftiny-radiocd","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmacmpi%2Ftiny-radiocd","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmacmpi%2Ftiny-radiocd/lists"}