{"id":13628697,"url":"https://github.com/hifiberry/hifiberry-os","last_synced_at":"2025-05-14T18:02:37.054Z","repository":{"id":27069348,"uuid":"30535654","full_name":"hifiberry/hifiberry-os","owner":"hifiberry","description":"Linux distribution optimized for audio playback","archived":false,"fork":false,"pushed_at":"2025-04-25T15:17:09.000Z","size":50215,"stargazers_count":1067,"open_issues_count":80,"forks_count":131,"subscribers_count":37,"default_branch":"master","last_synced_at":"2025-05-14T18:02:17.761Z","etag":null,"topics":["airplay","alsa","audio","bluetooth","dsp","hifiberry","mpd","music","roon","snapcast","spotify"],"latest_commit_sha":null,"homepage":null,"language":"C","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/hifiberry.png","metadata":{"files":{"readme":"README.md","changelog":"Changelog","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","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,"zenodo":null}},"created_at":"2015-02-09T12:52:33.000Z","updated_at":"2025-05-14T14:29:09.000Z","dependencies_parsed_at":"2023-02-16T12:31:09.078Z","dependency_job_id":"ac79d170-4cc7-4cb4-abde-fd0b03797ac1","html_url":"https://github.com/hifiberry/hifiberry-os","commit_stats":null,"previous_names":[],"tags_count":40,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hifiberry%2Fhifiberry-os","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hifiberry%2Fhifiberry-os/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hifiberry%2Fhifiberry-os/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hifiberry%2Fhifiberry-os/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/hifiberry","download_url":"https://codeload.github.com/hifiberry/hifiberry-os/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254198452,"owners_count":22030964,"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":["airplay","alsa","audio","bluetooth","dsp","hifiberry","mpd","music","roon","snapcast","spotify"],"created_at":"2024-08-01T22:00:55.974Z","updated_at":"2025-05-14T18:02:32.043Z","avatar_url":"https://github.com/hifiberry.png","language":"C","funding_links":[],"categories":["C"],"sub_categories":[],"readme":"[![GitHub contributors](https://img.shields.io/github/contributors/hifiberry/hifiberry-os.svg)](https://GitHub.com/hifiberry/hifiberry-os/graphs/contributors/)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n# HiFiBerryOS\n\nHiFiBerryOS is our version of a minimal Linux distribution optimized for audio playback. \nThe goal isn't to add as much functionality as possible, but to keep it small. Therefore, \nit is based on Buildroot and it's not possible to use package managers to add more \nsoftware.\n\nThere is a robust update mechanism that will not overwrite the system, but switch between\nthe current and the new version (they run on different partitions). This is documented in more detail at [doc/updater.md](doc/updater.md).\n\n## User interface\n\nThe user interface is based on the [Bang \u0026 Olufsen Beocreate project](https://github.com/bang-olufsen/create).\n\n## Services\n\nAt the moment, the following services are supported:\n\n- Spotify (using [a fork of Spotifyd](https://github.com/hifiberry/spotifyd)) - requires a paid Spotify subscription\n- Airplay (using [shairport](https://github.com/mikebrady/shairport-sync))\n- Squeezebox (using [squeezelite](https://github.com/ralph-irving/squeezelite))\n- Bluetooth A2DP sink (using [BlueZ 5](http://www.bluez.org/))\n- Roon - requires a Roon subscription\n- [MPD](https://github.com/MusicPlayerDaemon/MPD)\n- Snapcast (experimental, using [Snapcast](https://github.com/badaix/snapcast) and [SnapcastMPRIS](https://github.com/hifiberry/snapcastmpris))\n- Analogue input on DAC+ ADC with input detection (using [a custom alsaloop implementation](https://github.com/hifiberry/alsaloop/))\n- Webradio (experimental)\n\n## Tools \n\nAdditional tools that are available:\n\n- [sox](http://sox.sourceforge.net/)\n- [HiFiBerry dsptoolkit](https://github.com/hifiberry/hifiberry-dsp)\n\n## Integrations and additional functionalities\n\nThere are several ways to add functionalities to HiFiBerryOS or integrate it into other systems.\n\n### Controlling the system\n\nThe main backend controller application is called [audiocontrol](https://github.com/hifiberry/audiocontrol2) and offers an API that can be used to start/stop players, switch sources or retrieve metadata.\nThis is often the easiest way if you want to integrate it into other systems, e.g. a automation system.\n\n### Extending audiocontrol\n\nAudiocontrol provides a [plugin system](https://github.com/hifiberry/audiocontrol2/blob/master/doc/extensions.md) that can be used to add more complex integrations.Also have a look at the [\"Anatomy of a controller plugin\"](https://github.com/hifiberry/audiocontrol2/blob/master/doc/rotary-controller-plugin.md)\n\n### Adding packages\n\nHiFiBerryOS is based on buildroot. This means, you can't easily install additional software from command line. Even if you do, it will be gone after the next update as an update will replace the full filesystem. You need to integrate additonal software via the [Buildroot build system](https://buildroot.org/)\n\n### Adding UI components\n\nThe UI also uses a plugin concept. Plugins are called extensions. Have a look at the [Beocreate documentation](https://github.com/bang-olufsen/create/tree/master/Documentation)\n\n## How it works / technical documentation\n\nYou can find technical documentation in [the repository's doc folder](doc/)\n\n## Building a disk image\n[The documentation for building images from source can be found here](/doc/building.md)\n\n## Contributions\nWe're looking forward to your contributions. Depending on functionality and code quality, we will decide if a contribution will be included in the base system or will be provided as a user-contributed module that users need to install by themselve.\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhifiberry%2Fhifiberry-os","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhifiberry%2Fhifiberry-os","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhifiberry%2Fhifiberry-os/lists"}