{"id":13583339,"url":"https://github.com/rern/rAudio","last_synced_at":"2025-04-06T18:32:16.365Z","repository":{"id":37037423,"uuid":"320142424","full_name":"rern/rAudio","owner":"rern","description":"Raspberry Pi audio player: AirPlay, Audio CD, Bluetooth, DAB radio, DSP, Internet rafio, Multi-room, Spotify Connect, UPnP/DLNA","archived":false,"fork":false,"pushed_at":"2024-10-29T13:12:38.000Z","size":40136,"stargazers_count":344,"open_issues_count":1,"forks_count":38,"subscribers_count":24,"default_branch":"main","last_synced_at":"2024-10-29T15:57:43.407Z","etag":null,"topics":["airplay","audio-cd","audio-player","bluetooth","dlna-upnp","dsp","multi-room","raspberry-pi","raudio","spotify-connect"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":false,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/rern.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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}},"created_at":"2020-12-10T02:57:29.000Z","updated_at":"2024-10-28T12:35:04.000Z","dependencies_parsed_at":"2023-11-08T06:44:35.687Z","dependency_job_id":"cc705a13-8a54-4dd7-aba3-21867c561033","html_url":"https://github.com/rern/rAudio","commit_stats":null,"previous_names":[],"tags_count":189,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rern%2FrAudio","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rern%2FrAudio/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rern%2FrAudio/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rern%2FrAudio/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/rern","download_url":"https://codeload.github.com/rern/rAudio/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247531198,"owners_count":20953911,"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","audio-cd","audio-player","bluetooth","dlna-upnp","dsp","multi-room","raspberry-pi","raudio","spotify-connect"],"created_at":"2024-08-01T15:03:24.723Z","updated_at":"2025-04-06T18:32:16.356Z","avatar_url":"https://github.com/rern.png","language":"JavaScript","funding_links":[],"categories":["JavaScript"],"sub_categories":[],"readme":"r A u d i o\n---\nAudio player for \n- **Raspberry Pi**s:\n\t- 64bit: `5` `4` `3` `2` `Zero 2`\n\t- 32bit: `2 (BCM2836)`\n\t- Legacy: `1` `Zero`\n- BeagleBone Black\n- CubieBoard2\n\n![guide](https://github.com/rern/_assets/raw/master/guide/guide.gif)\n\n- Based on [Arch Linux Arm](https://archlinuxarm.org)\n- Control via GUI\n\t- Remote with any browsers\n\t- Android - [rAudio app](https://play.google.com/store/apps/details?id=com.raudio)\n\t- Local display ${\\textsf{\\color{gray}(not on RPi Zero and 1)}}$ \n- Share data and files between multiple rAudios\n\t- Server rAudio : clients (Easy setup with server IP address only)\n\t- File server : clients\n\t- Live data update - refresh across all rAudios\n- Live display update - refresh across multiple GUI clients\n- Metadata Tag Editor - `kid3-cli`\n- Album mode with coverarts\n- File mode with thumbnail icons\n- Coverarts and bookmarks - add, replace and remove\n- WebRadio coverarts - online fetched\n- `*.jpg`, `*.png` and animated `*.gif` applicable\n- `*.wav` - album artists and sort tracks\n- `*.cue` - virtually as individual tracks in all modes and user playlists\n- VU meter as coverart ${\\textsf{\\color{gray}(for remote screen)}}$\n- Wi-Fi connection can be pre-configured for headless mode.\n- Access point - `hostapd`\n- File sharing - `samba`\n- Easy update and extra features with Addons\n- Support boot from USB drive without SD card ([DIY](https://github.com/rern/rOS))\n-\n- Local files\n\t- USB HDD\n\t- USB Audio CD\n\t- NAS\n\t- SD card\n- Renderers / Clients - with metadata and coverarts\n\t- AirPlay\n\t- Bluetooth audio receiver\n\t- SnapClient - Multiroom audio client\n\t- Spotify Connect\n\t- DLNA / UPnP\n- Streamers\n\t- Bluetooth audio sender\n\t- HTTP ${\\textsf{\\color{gray}(no metadata)}}$\n\t- SnapServer - Multiroom audio client\n\t- Web Radio\n\t- DAB Radio ${\\textsf{\\color{gray}(not on RPi Zero and 1)}}$\n- Digital Signal Processors\n\t- CamillaDSP ${\\textsf{\\color{gray}(not on RPi Zero and 1)}}$\n\t- Equalizer\n\n### Supported devices\n- Bluetooth:\n\t- Audio - Receiver / Sender\n\t- Keyboard and mouse\n- USB:\n\t- Bluetooth\n\t- DAC\n\t- Keyboard and mouse\n\t- SDR ${\\textsf{\\color{gray}(for DAB Radio)}}$\n\t- Wi-Fi\n- GPIO:\n\t- [I²S audio module](https://github.com/rern/rAudio/blob/main/I2S_modules.md)\n\t- [Character LCD](https://github.com/rern/rAudio/raw/main/srv/http/assets/img/lcdchar.jpg) ${\\textsf{\\color{gray}(16x2, 20x4)}}$\n\t- Power on/off button\n\t- [Relay module](https://github.com/rern/rAudio/raw/main/srv/http/assets/img/relays.jpg)\n\t- [Rotary encoder](https://github.com/rern/rAudio/raw/main/srv/http/assets/img/rotaryencoder.jpg)\n\t- [Spectrum OLED](https://github.com/rern/rAudio/raw/main/srv/http/assets/img/mpdoled.jpg) ${\\textsf{\\color{gray}(128x64)}}$\n\t- [TFT 3.5\" LCD](https://github.com/rern/rAudio/raw/main/srv/http/assets/img/lcd.jpg) ${\\textsf{\\color{gray}(320x420)}}$\n\t- VU LED ${\\textsf{\\color{gray}(LEDs+Rs)}}$\n\n### Default root password\n- `ros`\n- If enable SnapClient, Multiple rAudios or Shared Data, do not change password from default.\n\n### Q\u0026A\n- [**rAudio Discussions**](https://github.com/rern/rAudio/discussions) - Questions, comments and bug reports\n\n### Image files\n- Raspberry Pi - [**Release i20250309**](https://github.com/rern/rAudio/releases/tag/i20250309)\n- BeagleBone Black - [DIY](https://github.com/rern/rAudio/discussions/299)\n- CubieBoard2 - [DIY](https://github.com/jazzi/rOS)\n\n### DIY Image file\n- [**rOS**](https://github.com/rern/rOS) - Build image files with interactive process\n\n### How-to\n- Write an image file to a micro SD card (8GB or more):\n\t- Install **Raspberry Pi Imager**\n\t\t- Windows, MacOS, Ubuntu: [Raspberry Pi Imager](https://www.raspberrypi.org/software/)\n\t\t- Manjaro: `pacman -Sy rpi-imager`\n\t\t- Others: [Build and install](https://github.com/raspberrypi/rpi-imager)\n\t- Download an image file\n\t- **Raspberry Pi Imager:**\n\t\t- `CHOOSE DEVICE` - (No need)\n\t\t- `CHOOSE OS`\n    \t\t- Select \"Use custom\" (bottom of the list)\n        \t- Select the image file\n\t\t- `CHOOSE STORAGE`:\n\t\t\t- Select SD card - normal boot\n\t\t\t- Select USB drive - boot from USB drive without SD card\n\t\t\t\t- For Raspberry Pi 2B v1.2, 3A+, 3B, 3B+, 4B\n\t\t\t\t- [USB mass storage boot](https://www.raspberrypi.org/documentation/hardware/raspberrypi/bootmodes/msd.md) must be set.\n\t\t\t\t- Should be used only when USB drive is faster than SD card.\n\t\t- `NEXT`\n    \t\t- `NO` customization settings\n        \t- `YES` continue\n    \t- On Windows - To ensure filesystem set properly:\n       \t\t- `CANCEL WRITE` when reach at least 2% on 1st write.\n           \t- Continue with `NEXT` again and let the writing finish.\n\t\t- Once writing done, verifying is not normally needed.\n- Existing users:\n\t- Keep current setup SD card.\n\t- Try with a spare one before moving forward.\n\t- Use only backup made from rAudio with the latest update\n- Before power on:\n\t- Wired LAN connection is recommended\n\t- Wi-Fi pre-configure: (any of)\n\t\t- Edit template file:\n\t\t\t- Rename `wifi0` in `BOOT` to `wifi`\n\t\t\t- Edit ESSID and Key.\n\t\t- From rAudio backup\n\t\t- From existing\n\t\t\t- Copy an existing profile file from `/etc/netctl`\n\t\t\t- Rename it to `wifi` then copy it to `BOOT` before power on.\n\t- Wi-Fi access point mode\n\t\t- Auto start: No IP address assigned from connected wired/wireless network\n\t\t- Force enable access point only: Place blank `accesspoint` file in `BOOT` before power on.\n\t\t- On client devices, select `rAudio` from Wi-Fi network list to connect with password `raudioap`.\n\t\t- On browser, open web user interface with URL `raudio.local`\n\t\t- Settings \u003e Networks \u003e Wi-Fi - search\n\t\t- Select access point to connect\n\t\t- Reboot\n\t\t- Browser refreshes when ready. (Manually refresh if it's too long.)\n\t- System pre-configure: (Run once)\n\t\t- Restore database and settings (Wi-Fi connection included.)\n\t\t\t- Copy rAudio backup file to `BOOT`\n\t\t\t- Use only backup made from rAudio with the latest update\n\t\t- Expand `root` partition:\n\t\t\t- By default, `root` partition will be expanded on initial boot.\n\t\t\t- SD card backup with shrunken `root` partition - Create a blank file `expand` in `BOOT` before backup\n   - Display (if needed)\n     \t- Connect before boot\n     \t- HDMI display on RPi 4 and 5 - Use `HDMI0` port\n\n- Boot duration\n\t- RPi4: 20+ seconds\n\t- RPi3: 50+ seconds\n\t- RPi1, Zero: 80+ seconds\n- After initial boot:\n\t- If there's a connected screen, IP address for connecting from remote devices will be displayed.\n\t- Before setup anything: Settings \u003e Addons \u003e rAudio \u003e Update (if available)\n\t- Restore settings and database:\n\t\t- If not pre-configured, Settings \u003e System \u003e Backup/Restore Settings\n\t- Build Library database:\n\t\t- Automatically run on boot if database is empty with connected USB and NAS\n\t\t- Force build / update - Settings \u003e update Library (icon next to Sources)\n\t\t- Tracks on existing database can be played during updating.\n\t\t- Before database is available, default WebRadio stations are available for playing.\n\t- Parse coverarts for Album and directory thumbnails :\n\t\t- Only if never run before or to force update\n\t\t- Library \u003e Album \u003e coverart icon (next to ALBUM heading)\n\t- User guide\n\t\t- Settings \u003e last icon next to Addons\n\n### Not working?\n- Power off and wait a few seconds then power on\n- If not connected, temporarily connect wired LAN then remove after Wi-Fi setup successfully.\n- Still no - Download the image file and start over again\n\n\n### Tips\n- Best sound quality:\n\t- Settings \u003e Player \u003e Bit-perfect - Enable\n\t- Use only amplifier volume (Unless quality of DAC hardware volume is better.)\n- Disable features if not use to lower CPU usage:\n\t- Settings \u003e Features\n\t- Disable `Browser on RPi` might cause audio glitches on refresh / switch page\n\t\t- After system upgrade `pacman -Syu` which kernel `linux-raspberrypi` also upgraded.\n\t\t- On 64bit version - Very likely, kernel upgraded or not.\n- Full screen UI\n\t- Android - [rAudio app](https://play.google.com/store/apps/details?id=com.raudio)\n   \t\t- APK for obsolete Android: [rAudio app](https://cloud.s-t-franz.de/s/kdFZXN9Na28nfD8/download?path=%2F\u0026files=rAudio.apk)\n\t- Add to Home Screen (Safari on iOS, Chrome on Android)\n- Coverart as large playback control buttons\n\t- Tap top of coverart to see controls guide.\n- Hide top and bottom bars\n\t- No needs for top and bottom bars\n\t- Use coverart controls instead of top bar buttons\n\t- Swipe to switch between pages\n\t\t\u003c- Library \u003c-\u003e Playback \u003c-\u003e Playlist -\u003e\n- Drag to arrange order\n\t- Library home blocks\n\t- Playlist tracks\n\t- Saved playlist tracks\n- Some coverarts missing from album directories\n\t- Subdirectories listed after partial Library database update from context menu.\n\t- Subdirectories - context menu \u003e Exclude directory\n- Some music files missing from library\n\t- Make sure embedded metadata in each file is in UTF-8 encoding.\n\t- Settings \u003e MPD \u003e question mark icon -scroll- FFmpeg Decoder\n\t- Enable if filetypes list contains ones of the missing files.\n- No albums found after update very large Library\n\t- Settings \u003e MPD \u003e Output Buffer - Increase by 8192 at a time\n\t- Update Library\n- CUE sheet\n\t- `*.cue` filenames must be identical to each coresponding music file.\n\t- Can be directly edited by Tag Editor.\n- Minimum permission for music files (on Linux ext filesystem)\n\t- Directories: `rwxr-xr-x` (755)\n\t- Files: `rw-r--r--` (644)\n- RPi to router connection:\n\t- With wired LAN if possible - Disable Wi-Fi\n\t- With WiFi if necessary\n\t- With RPi accesspoint only if there's no router\n- Connect to rAudio with IP address instead of raudio.local\n\t- Get IP address: Menu \u003e Network \u003e Network Interfaces list\n- Backup SD card which already setup\n\t- On Linux: `bash \u003c( curl -sL https://github.com/rern/rOS/raw/main/imagecreate.sh )`\n\t\t- Shrink ROOT partition to minimum\n\t\t- Create and compress image file\n- Custom startup / shutdown script\n\t- Copy custom script named `startup.sh` / `shutdown.sh` to `BOOT`\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frern%2FrAudio","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frern%2FrAudio","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frern%2FrAudio/lists"}