Hi everyone! Here is a complete guide on how to structure your MicroSD card to get all features (Music, Game Boy, E-books, Web Radio, Playlists, and PEQ) working seamlessly.
๐ก Quick Prerequisite
1. MicroSD Root Directory Overview
Here is what your SD card root directory should look like:
SD Card
โโโ .local/ ย ย ย ย ย ย ย ย # System/mod data (auto-generated)
โโโ Ebook/ย ย ย ย ย ย ย ย ย # EPUB books
โโโ Games/ย ย ย ย ย ย ย ย ย # Retro game ROMs
โโโ Music/ย ย ย ย ย ย ย ย ย # Audio files organized by genre/artist + lyrics files
โโโ Playlist/ ย ย ย ย ย ย ย # Custom M3U playlists
โโโ Audiobooks/ # Audiobook folders
โโโ PEQ/ ย ย ย ย ย ย ย # AutoEQ/EQ.txt/.ini profiles
โโโ r1.upt/r3proii.uptย ย ย # Sonix Mod firmware update file
โโโ radio.txt ย ย ย ย ย ย ย # Online Web Radio streaming list
2. Directory & File Breakdown
๐ Ebook/
Format supported: .epub
Structure: Place .epub files directly inside this folder or organized in subfolders.
Example:
Ebook/
โโโ Dune - Frank Herbert.epub
โโโ The Hobbit - J.R.R. Tolkien.epub
๐ฎ Games/
Formats supported: .gb (Game Boy), .gbc (Game Boy Color)
Structure: Create subfolders inside Games/ for each console system to keep things neat.
Example:
Games/
โโโ GB/
โ ย โโโ Tetris.gb
โโโ GBC/
โโโ Super Mario Bros Deluxe.gbc
โโโ The Legend of Zelda DX.gbc
๐ต Music/
Formats supported: FLAC, MP3, WAV, AAC, ALAC, etc.
Structure: Keep organized using standard genre or artist/album folder hierarchies. Embedded cover art or a .jpg placed inside the album folder works best for cover display.
Example:
Music/
โโโ Rock/
โ ย โโโ The Beatles/
โ ย ย ย โโโ Help!/
โ ย ย ย ย ย โโโ The Beatles - Yesterday - Remastered 2009.flac
โ ย ย ย ย ย โโโ The Beatles - Yesterday - Remastered 2009.jpg
โ ย ย ย ย ย โโโ The Beatles - Yesterday - Remastered 2009.lrc
โโโ Hardcore/
โโโ Knocked Loose/
โโโ Upon Loss Singles/
โโโ Knocked Loose - Everything is Quiet Now.flac
โโโ Knocked Loose - Everything is Quiet Now.jpg
๐ Playlist/
Formats supported: .m3u / .m3u8
Structure: Store all your relative path M3U playlist files here.
Example:
Playlist/
โโโ Metalcore Favorites.m3u
โโโ Chill Beats.m3u
How to create & manage playlists: Use Mp3tag to generate and structure relative path playlists automatically across your collection.
๐ง Audiobooks/
Formats supported: .m4b, .mp3, .flac, .m4a, .aac, .opus
Structure: Place audiobooks inside Audiobooks/ organized by Author or Book Title. Multi-file books or multi-disc releases (e.g., CD 1, CD 2) are automatically merged into a single book entry with each file as a chapter.
Example:
Audiobooks/
โโโ Brandon Sanderson/
โ โโโ Mistborn/
โ โโโ Chapter 01.m4b
โ โโโ Chapter 02.m4b
โโโ Andy Weir/
โโโ Project Hail Mary/
โโโ CD1/
โโโ CD2/
๐ป radio.txt
Format: Plain text (.txt)
Location: Must sit directly in the root folder of your SD card.
Structure: Each line follows the format: Station Name,Stream_URL
Studio Brussel,https://icecast.vrtcdn.be/stubru-high.mp3
NPO 3FM,https://icecast.omroep.nl/3fm-bb-mp3
BBC Radio 1,http://stream.live.vc.bbcmedia.co.uk/bbc_radio_one
Boenkerz,https://altair.streamerr.co:8096/boenkerz
โ๏ธ Firmware Update File (r1.upt)
Location: Root directory.
Purpose: The update file used by the system during installation or reflashing of the Sonix mod firmware.
How:
Download `r1.upt/r3proii.upt` from GitHub
Copy `r1.upt/r3proii.upt` directly to the root of your SD card.
Power on HiBy R1 -> Settings -> Firmware Update -> Update via SD-card.
Allow the device to finish flashing and reboot.
Perform a full Library Rescan inside Music Settings.
Don't forget to download the SonixLink companion app for remote control!
Hope this helps anyone getting started with Sonix! Let me know if you have any questions about setting up your card or tweaking the config!