Hi everyone!

My HiBy R1 arrived a few days ago, and I absolutely love it! I immediately installed the Sonix Custom Firmware / Mod, but I noticed there was very little documentation available online regarding how to set up the MicroSD card properly.

Since I figured everything out after a bit of trial and error, I wanted to share a full overview of the optimal folder structure, along with useful tools and resources to get all your content set up!

1. MicroSD Root Directory Overview

Here is what your SD card root directory should look like:

SD Card
├── .local/                 # System/mod data (auto-generated)
├── .temp/                  # System cache (auto-generated)
├── Ebook/                  # EPUB books
├── Games/                  # Retro game ROMs
├── Music/                  # Audio files organized by genre/artist
├── Playlist/               # Custom M3U playlists
├── r1.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
└── 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.

📻 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://bbc.co.uk
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.

Hope this helps anyone getting started with their HiBy R1! Let me know if you have any questions about setting up your card or tweaking the config!