hifiberry-os
Linux distribution optimized for audio playback
File Explorer
Download Latest Version (.zip)- pre-push
- 01-bug-report.yml
- 02-feature-request.yml
- config.yml
- SKILL.md
- check-packages.yml
- SUPPORT.md
- acr-webmcp.md
- add-your-own-player.md
- backend-apis.md
- kiosk-mode.md
- maintainers-wanted.md
- power-key.md
- security-model.md
- kiosk-mode.sh
- build.sh
- clean.sh
- acr-webmcp
- acr-webmcp.service
- format
- changelog
- control
- dirs
- hifiberry-acr-webmcp.nginx
- install
- rules
- acr-webmcp.service
- acr-webmcp
- build.sh
- clean.sh
- aes67.json
- aes67.json
- aes67.json
- format
- changelog
- control
- copyright
- hifiberry-aes67.maintscript
- hifiberry-aes67.nginx
- postinst
- rules
- __init__.py
- api.py
- board.py
- configdb.py
- configure.py
- linker.py
- main.py
- pwconf.py
- pwgraph.py
- registry.py
- selection.py
- settings.py
- sink.py
- state.py
- sync.py
- aes67.svg
- aes67.json
- aes67-agent.service
- aes67.service
- __init__.py
- test_api.py
- test_board.py
- test_configdb.py
- test_configure.py
- test_linker.py
- test_main.py
- test_pwconf.py
- test_pwgraph.py
- test_registry.py
- test_selection.py
- test_settings.py
- test_sink.py
- test_state.py
- test_sync.py
- setup.py
- build.sh
- clean.sh
- README.md
- build.sh
- clean.sh
- README.md
- format
- changelog
- control
- copyright
- rules
- __init__.py
- main.py
- analoginput.service
- requirements.txt
- setup.py
- build.sh
- clean.sh
- README.md
- build.sh
- build.sh
- clean.sh
- config-avahi
- config-avahi.8
- build.sh
- clean
- clean.sh
- SOUNDCARD-DETECTION.md
- SPLIT_DAEMON_ARCHITECTURE.md
- build.sh
- clean.sh
- build.sh
- clean.sh
- format
- changelog
- control
- copyright
- rules
- adc.txt
- amp100.eep
- amp100.txt
- amp4.eep
- amp4.txt
- amp4pro.eep
- amp4pro.txt
- beocreate2.eep
- beocreate2.txt
- compile-eep
- dac2.txt
- dac2adcpro.eep
- dac2adcpro.txt
- dac2hd.eep
- dac2hd.txt
- dac2pro.eep
- dac2pro.txt
- dac8x.eep
- dac8x.txt
- dacplus.eep
- dacplus.txt
- dacplusadc.eep
- dacplusadc.txt
- dacplusadcpro.eep
- dacplusadcpro.txt
- digi2pro.eep
- digi2pro.txt
- digi2standard.eep
- digi2standard.txt
- digiplus.eep
- digiplus.txt
- digipro.eep
- digipro.txt
- dsp2x4.eep
- dsp2x4.txt
- studio_adc.txt
- studiodac8x.eep
- studiodac8x.txt
- basic_usage.py
- hat_info_example.py
- __init__.py
- bitbang_i2c.py
- cli.py
- hat_eeprom.py
- hateeprom.1
- hateeprom.cpython-313.pyc
- hateeprom.py
- README.md
- setup.py
- build.sh
- clean.sh
- Makefile
- uuid.txt
- firmware-studio-setup
- flash-studio-dac8x
- studio-dac8x-status
- format
- changelog
- control
- copyright
- rules
- studiodac8x-0.0.3.hex
- README.md
- build.sh
- clean.sh
- freqresp
- format
- changelog
- compat
- control
- rules
- build.sh
- clean.sh
- build.sh
- clean.sh
- format
- changelog
- control
- copyright
- rules
- build.sh
- clean.sh
- README.md
- build.sh
- clean.sh
- format
- changelog
- control
- copyright
- hifiberry-librespot.maintscript
- librespot.1
- librespot.service
- postinst
- postrm
- rules
- spotify-event.1
- start-librespot.1
- spotify.svg
- librespot.json
- librespot.svg
- librespot.json
- librespot.service
- spotify-event.sh
- start-librespot.sh
- build.sh
- clean.sh
- mpd.conf.default
- format
- changelog
- control
- copyright
- postinst
- postrm
- prerm
- rules
- mpd.json
- hifiberry-mpd-reconcile.service
- mpd.service
- configure-mpd.1
- configure-mpd.py
- mpd-reconcile
- mpd-set-permissions
- mpd-set-permissions.1
- start-mpd.1
- start-mpd.sh
- build.sh
- clean.sh
- build.sh
- clean.sh
- changelog
- control
- copyright
- hifiberry-pipewire-configs.install
- hifiberry-pipewire-configs.substvars
- rules
- 10-hifiberry-rates.conf
- 99-hifiberry-headless.conf
- 90-default-volume.conf
- 91-hide-midi-ui.conf
- 98-hifiberry-digi-no-capture.conf
- 99-hifiberry-bluetooth.conf
- build.sh
- clean.sh
- build.sh
- clean.sh
- changelog
- control
- copyright
- rules
- build.sh
- clean.sh
- format
- changelog
- control
- copyright
- rules
- build.sh
- clean.sh
- format
- changelog
- control
- copyright
- rules
- build.sh
- clean.sh
- format
- changelog
- control
- copyright
- rules
- build.sh
- clean.sh
- format
- changelog
- control
- copyright
- rules
- build.sh
- clean.sh
- changelog
- control
- copyright
- rules
- build.sh
- clean.sh
- format
- changelog
- control
- copyright
- hifiberry-raat.lintian-overrides
- hifiberry-raat.service
- postinst
- postrm
- rules
- start-raat.1
- raat.json
- configure-raat.py
- raat.service
- start-raat.sh
- build.sh
- clean.sh
- version.txt
- build.sh
- clean.sh
- build.sh
- clean.sh
- format
- changelog
- conffiles
- control
- copyright
- hifiberry-shairport.maintscript
- nqptp.service
- postinst
- postrm
- prerm
- rules
- shairport-sync.service
- shairport-sync.service.in
- airplay.svg
- nqptp.1
- shairport-airplay2.1
- shairport-event-start.1
- shairport-event-stop.1
- shairport-event.1
- shairport-metadata-example.1
- shairport-playpause.1
- shairport-start.1
- shairport-stop.1
- shairport-sync-metadata-reader.1
- shairport.1
- start-nqptp.1
- start-shairport.1
- shairport.json
- nqptp.service
- shairport.service
- shairport.svg
- shairport.json
- shairport-event.sh
- shairport-metadata-example.sh
- shairport-playpause.sh
- shairport-sync.conf.default
- start-nqptp.sh
- start-shairport.sh
- build.sh
- clean.sh
- VERSIONING.md
- build.sh
- format
- changelog
- compat
- control
- copyright
- manpages
- rules
- songrec.1
- build.sh
- clean.sh
- README.md
- build.sh
- clean.sh
- format
- changelog
- control
- copyright
- hifiberry-squeezelite.maintscript
- postinst
- postrm
- rules
- squeezelite.service
- squeezelite.svg
- squeezelite.1
- start-squeezelite.1
- squeezelite.json
- squeezelite.svg
- squeezelite.json
- squeezelite.service
- start-squeezelite
- build.sh
- clean.sh
- check-rms
- format
- changelog
- control
- copyright
- rules
- studiodac8x-0.1.hex
- check-rms.1
- check-rms
- configure-hardware
- dsp1.xml
- install-tools
- reset-dsp
- routing.py
- stresstest-dsp
- test.sh
- create-test-dacadc8x
- create-test-dacplusadc-nosoundtest
- create-test-studiodac8x
- enable-tests
- run-test
- select-test
- set-resolution
- test-c1
- test-dacadc8x
- test-dacplusadcpro-nosoundtest
- test-studiodac8x
- autologin.conf
- build.sh
- clean.sh
- active-alsa-processes
- alsa-mode
- alsa-state
- bootmsg
- check-compatibility
- check-internet
- check-network.sh
- check-system
- debuginfo
- detect-hifiberry
- enable-mdns
- fix-dacadcpro-mixer
- fix-unused-volume
- hifiberry-cardid
- myurl
- pause-all
- readhat
- reconfigure-players
- restore-volume
- set-initial-volume
- shutdown-system
- speaker-role
- store-volume
- unmute-amp100
- control
- active-alsa-processes
- alsa-mode
- alsa-state
- bootmsg
- check-compatibility
- check-internet
- check-network.sh
- check-system
- debuginfo
- detect-hifiberry
- enable-mdns
- fix-dacadcpro-mixer
- fix-unused-volume
- hifiberry-cardid
- myurl
- pause-all
- readhat
- reconfigure-players
- restore-volume
- set-initial-volume
- shutdown-system
- speaker-role
- store-volume
- unmute-amp100
- active-alsa-processes
- alsa-mode
- alsa-state
- bootmsg
- check-compatibility
- check-internet
- check-network.sh
- check-system
- debuginfo
- detect-hifiberry
- enable-mdns
- fix-dacadcpro-mixer
- fix-unused-volume
- hifiberry-cardid
- myurl
- pause-all
- readhat
- reconfigure-players
- restore-volume
- set-initial-volume
- shutdown-system
- speaker-role
- store-volume
- unmute-amp100
- configure-players.service
- configure-system.service
- hifiberry-detect.service
- hifiberry-finish.service
- initial-volume.service
- internet.service
- network-up.service
- restore-volume.service
- sshdconfig.service
- build.sh
- snd_soc_core_disable_pm.conf
- build.sh
- build.sh
- build.sh
- start-radio
- usbaudio.json
- usbaudio.json
- format
- changelog
- control
- copyright
- hifiberry-usbaudio.maintscript
- postinst
- rules
- __init__.py
- gadget.py
- gadget_cli.py
- linker.py
- main.py
- monitor.py
- state.py
- usbaudio.svg
- usbaudio.json
- hifiberry-usbgadget.service
- usbaudio-state.service
- usbaudio.service
- __init__.py
- test_gadget.py
- test_linker.py
- test_main.py
- test_monitor.py
- test_state.py
- setup.py
- build.sh
- clean.sh
- README.md
- UNPUBLISHED
- build.sh
- clean.sh
- build.sh
- clean.sh
- build-all
- build.md
- cleanup-old-packages
- copy-packages
- docker-build.sh
- Dockerfile
- packagecheck.txt
- repos.md
- baseline-packages
- check-packages.py
- check-release.py
- commitid
- compile-kernel
- create-chroot
- cross-compile-env.sh
- disable-cross-compile
- dump-dsp-params-spi.py
- dump-dsp-params.py
- enable-cross-compile
- git-repo-sync.py
- hbos-minimal.sh
- hbos-player.sh
- install-dev-packages
- install-packages
- resize-ext-partitions
- upgrade-bookworm-to-trixie
- version-helper.sh
- .gitignore
- addrepo
- install-all
- progress-report.md
- README.md
- TODO
- upgrade-to-trixie
# Installation Guide
git clone https://github.com/hifiberry/hifiberry-os
Downloads the entire project code from GitHub to your computer.
cd hifiberry-os
Moves into the project folder you just downloaded.
2. Official Install Script
Easy Recommended- APT (Debian/Ubuntu ๊ณ์ด) Built into Debian/Ubuntu-based Linux distributions.
curl -Ls https://raw.githubusercontent.com/hifiberry/hifiberry-os/refs/heads/main/addrepo | bash
Downloads and runs the official install script in one line โ this handles the full setup automatically.
curl -Ls https://raw.githubusercontent.com/hifiberry/hifiberry-os/refs/heads/main/install-all | bash
Downloads and runs the official install script in one line โ this handles the full setup automatically.
sudo apt install -y hbos-full
Installs directly from the APT package repository (Debian/Ubuntu-based).
sudo apt install -y hbos-minimal
Installs directly from the APT package repository (Debian/Ubuntu-based).
Pulled directly from this repo's README.
3. Docker
Easy- Git Needed to download the project code from GitHub.
- Docker Desktop Needed to build and run containers. Install it and keep it running in the background.
docker build -f packages/Dockerfile -t hifiberry-os .
Builds a runnable image based on the Dockerfile.
docker run -p 8080:80 hifiberry-os
Runs the built image as an actual container.
4. Python
Easypip install -r packages/analoginput/src/requirements.txt
Installs the Python libraries listed in requirements.txt (or similar).
python <์คํํ ํ์ผ๋ช
>.py # README์์ ์ ํํ ์คํ ํ์ผ๋ช
์ ํ์ธํ์ธ์
Runs the Python script (or module).
5. Make
Medium- Git Needed to download the project code from GitHub.
- Make Usually pre-installed on Linux/macOS. On Windows, install separately (e.g. via MSYS2 or WSL).
cd packages/eeprom
This project's files live in a subfolder, so move into it first.
make
Compiles the code based on the generated build configuration to produce an executable.
