This guide explains how to organize your files so the app can correctly detect games, stations, icons, and audio. You must supply the actual game audio and artwork to the app, as we do not host any copyrighted content.
The below explanation will use the GTA games as an example, but you can create any radio stations you like, fictional or otherwise.
📁 Folder Structure Overview
This folder structure is designed so the app can automatically recognize games, stations, and artwork based purely on how files are organized and named.
At the top level, you have a single root folder (e.g. GTARadio).
Inside this, each subfolder represents a game. For example, GTA III and GTA IV are treated as separate games within the app in this example.
Inside each game folder:
- A single image file with the same name as the folder (e.g. GTA III.png) is used as the game artwork.
- Each radio station is made up of two files:
- An audio file (.mp3)
- A matching image file (.png)
- The audio file and image must have the exact same name (e.g. FlashbackFM.mp3 and FlashbackFM.png). This tells the app which artwork belongs to which station.
GTAradio/
├───GTA III/
│ GTA III.png
│ FlashbackFM.mp3
│ FlashbackFM.png
│ K-JAH.mp3
│ K-JAH.png
│
├───GTA IV/
│ GTA IV.png
│ International Funk 99.mp3
│ International Funk 99.png
│ Vice City FM.mp3
│ Vice City FM.png
│
├───GTA San Andreas/
│ GTA San Andreas.png
│ Radio Los Santos.mp3
│ Radio Los Santos.png🎮 Game Folders
- Each folder represents a game or radio collection.
- The folder name is used as the game or radio collection name in app.
- Each game folder must have a matching image in the game folder.
🎨 Game Icons
📁 Location: Inside the game folder
📝 Name: Must match the folder name
🖼️ Format: JPG
📐 Size: 920 × 430 pixels
Example:
GTAradio/
├───GTA San Andreas/
│ GTA San Andreas.png📻 Station Files
- Inside each game folder, stations are defined by pairs of files.
- Station Name.jpg
- Station Name.mp3
🎨 Station Icons
📁 Location: Inside the game folder
📝 Name: Must match the MP3 file
🖼️ Format: JPG
📐 Size: 512 × 512 pixels
Example:
GTAradio/
├───GTA San Andreas/
│ Radio Los Santos.mp3
│ Radio Los Santos.png🎵 Audio Files
📁 Location: Inside the game folder
📝 Name: Must match the JPG file
🎧 Format: MP3
📝 How the App Reads Your Files
The app will:
Scan the root folder for game folders
Match each folder with its .jpg icon of the same name
Open each game folder
Pair .mp3 files with .jpg files of the same name
Display them as radio stations
📻 Dynamic Radio Playback
Each station in the app behaves like a real in-game radio station rather than a standard music track.
When you start listening, playback begins at a random point within the audio file, creating the feeling that the station is already live. The app then keeps track of playback position in the background, so if you switch stations and return later, it will continue from where it would have been, not where you left it. This creates a seamless illusion that every station is constantly playing, just like in a real game world.
To support this feature, each radio station should be provided as a single continuous audio file (for example, a 1-hour mix containing music, ads, and transitions). This allows the app to maintain consistent timing and ensures smooth, uninterrupted playback when jumping in at any point.
Sample Radio stations from a fictional game series
This is a copyright free fictional set of radio stations to use as an example for how the app works and how the folders should be created
Download the folder here. Extract it, and add it to the app using the local folder option explained on the “Add Stations to App” page.
Alternatively add it as a remote stream or import it from remote stream using this URL
https://sample.grandtheft-audio.com
📁 Example Structure for the Grand Theft Auto series of games
Below is a complete example folder structure showing how a full radio collection can be organized (using GTA as a reference). This is provided purely as a structural example so you can understand how to organize your own files correctly.
Note: This example does NOT include any audio or image files. You must source your own content. You are responsible for ensuring you have the legal right to use any audio or images you add. This project does not provide, distribute, or host copyrighted material.
GTARadio/
├───GTA Advance/
│ GTA Advance Radio.jpg
│ GTA Advance Radio.mp3
│ GTA Advance.jpg
│
├───GTA Chinatown Wars/
│ Alchemist.jpg
│ Alchemist.mp3
│ Anvil.jpg
│ Anvil.mp3
│ Deadmau5.jpg
│ Deadmau5.mp3
│ DFA.jpg
│ DFA.mp3
│ DJ Khalil.jpg
│ DJ Khalil.mp3
│ GTA Chinatown Wars.jpg
│ Prairie Cartel.jpg
│ Prairie Cartel.mp3
│ Sinowav FM.jpg
│ Sinowav FM.mp3
│ Ticklah.jpg
│ Ticklah.mp3
│ Tortoise.jpg
│ Tortoise.mp3
│ Truth and Soul.jpg
│ Truth and Soul.mp3
│ Turntables on the Hudson .jpg
│ Turntables on the Hudson .mp3
│
├───GTA III/
│ Chatterbox FM.jpg
│ Chatterbox FM.mp3
│ Double Clef FM.jpg
│ Double Clef FM.mp3
│ Flashback.jpg
│ Flashback.mp3
│ Game Radio.jpg
│ Game Radio.mp3
│ GTA III.jpg
│ Head Radio.jpg
│ Head Radio.mp3
│ K-JAH.jpg
│ K-JAH.mp3
│ Lips 106.jpg
│ Lips 106.mp3
│ MSX FM.jpg
│ MSX FM.mp3
│ Rise FM.jpg
│ Rise FM.mp3
│
├───GTA IV/
│ Electro Choc.jpg
│ Electro Choc.mp3
│ Fusion FM.jpg
│ Fusion FM.mp3
│ GTA IV.jpg
│ Integrity.jpg
│ Integrity.mp3
│ International Funk 99.jpg
│ International Funk 99.mp3
│ Jazz Nation Radio.jpg
│ Jazz Nation Radio.mp3
│ K109 The Studio.jpg
│ K109 The Studio.mp3
│ Liberty City Hardcore.jpg
│ Liberty City Hardcore.mp3
│ Liberty Rock Radio.jpg
│ Liberty Rock Radio.mp3
│ Massive B Soundsystem.jpg
│ Massive B Soundsystem.mp3
│ Public Liberty Radio.jpg
│ Public Liberty Radio.mp3
│ Radio Broker.jpg
│ Radio Broker.mp3
│ RamJam FM.jpg
│ RamJam FM.mp3
│ San Juan Sounds.jpg
│ San Juan Sounds.mp3
│ Self-Actualization FM.jpg
│ Self-Actualization FM.mp3
│ The Beat.jpg
│ The Beat.mp3
│ The Classics.jpg
│ The Classics.mp3
│ The Journey.jpg
│ The Journey.mp3
│ The Vibe.jpg
│ The Vibe.mp3
│ Tuff Gong Radio.jpg
│ Tuff Gong Radio.mp3
│ Vice City FM.jpg
│ Vice City FM.mp3
│ Vladivostok FM.jpg
│ Vladivostok FM.mp3
│ WKTT Radio.jpg
│ WKTT Radio.mp3
│
├───GTA Liberty City Stories/
│ Double Clef FM.jpg
│ Double Clef FM.mp3
│ Flashback FM.jpg
│ Flashback FM.mp3
│ GTA Liberty City Stories.jpg
│ Head Radio.jpg
│ Head Radio.mp3
│ K-Jah.jpg
│ K-Jah.mp3
│ Liberty City Free Radio.jpg
│ Liberty City Free Radio.mp3
│ Lips 106.jpg
│ Lips 106.mp3
│ MSX 98.jpg
│ MSX 98.mp3
│ Radio Del Mundo.jpg
│ Radio Del Mundo.mp3
│ Rise FM.jpg
│ Rise FM.mp3
│ The Liberty Jam.jpg
│ The Liberty Jam.mp3
│
├───GTA London/
│ GTA London Radio.jpg
│ GTA London Radio.mp3
│ GTA London.jpg
│
├───GTA One/
│ GTA 1 Radio.jpg
│ GTA 1 Radio.mp3
│ GTA One.jpg
│
├───GTA San Andreas/
│ Bounce FM.jpg
│ Bounce FM.mp3
│ CSR.jpg
│ CSR.mp3
│ GTA San Andreas.jpg
│ K-DST.jpg
│ K-DST.mp3
│ K-JAH West.jpg
│ K-JAH West.mp3
│ K-Rose.jpg
│ K-Rose.mp3
│ Master Sounds.jpg
│ Master Sounds.mp3
│ Playback FM.jpg
│ Playback FM.mp3
│ Radio Los Santos.jpg
│ Radio Los Santos.mp3
│ Radio X.jpg
│ Radio X.mp3
│ SF-UR.jpg
│ SF-UR.mp3
│ West Coast Talk Radio.jpg
│ West Coast Talk Radio.mp3
│
├───GTA Two/
│ GTA 2 Radio.jpg
│ GTA 2 Radio.mp3
│ GTA Two.jpg
│
├───GTA V/
│ Blaine County Talk.jpg
│ Blaine County Talk.mp3
│ Blonded Los Santos.jpg
│ Blonded Los Santos.mp3
│ Channel X.jpg
│ Channel X.mp3
│ East Los FM.jpg
│ East Los FM.mp3
│ FlyLo FM.jpg
│ FlyLo FM.mp3
│ GTA V.jpg
│ iFruit Radio.jpg
│ iFruit Radio.mp3
│ Kult FM.jpg
│ Kult FM.mp3
│ Los Santos Rock.jpg
│ Los Santos Rock.mp3
│ Los Santos Underground.jpg
│ Los Santos Underground.mp3
│ Media Player.jpg
│ Media Player.mp3
│ MOTOMAMI.jpg
│ MOTOMAMI.mp3
│ Music Locker Radio.jpg
│ Music Locker Radio.mp3
│ Non Stop Pop FM.jpg
│ Non Stop Pop FM.mp3
│ Radio Los Santos.jpg
│ Radio Los Santos.mp3
│ Radio Mirror Park.jpg
│ Radio Mirror Park.mp3
│ Rebel Radio.jpg
│ Rebel Radio.mp3
│ Soulwax FM.jpg
│ Soulwax FM.mp3
│ Space 103.jpg
│ Space 103.mp3
│ Still Slipping.jpg
│ Still Slipping.mp3
│ The Blue Ark.jpg
│ The Blue Ark.mp3
│ The Lab.jpg
│ The Lab.mp3
│ The Lowdown 91.jpg
│ The Lowdown 91.mp3
│ Vinewood Boulevard.jpg
│ Vinewood Boulevard.mp3
│ WCTR.jpg
│ WCTR.mp3
│ West Coast Classics.jpg
│ West Coast Classics.mp3
│ Worldwide FM.jpg
│ Worldwide FM.mp3
│
├───GTA VI/
│ Coming Soon.jpg
│ Coming Soon.mp3
│ GTA VI.jpg
│
├───GTA Vice City/
│ Emotion.jpg
│ Emotion.mp3
│ Fever 105.jpg
│ Fever 105.mp3
│ Flash FM.jpg
│ Flash FM.mp3
│ GTA Vice City.jpg
│ K-Chat.jpg
│ K-Chat.mp3
│ Radio Espantoso.jpg
│ Radio Espantoso.mp3
│ V-Rock.jpg
│ V-Rock.mp3
│ VCPR.jpg
│ VCPR.mp3
│ Wave 103.jpg
│ Wave 103.mp3
│ Wildstyle.jpg
│ Wildstyle.mp3
│
└───GTA Vice City Stories/
Emotion.jpg
Emotion.mp3
Flash FM.jpg
Flash FM.mp3
Fresh FM.jpg
Fresh FM.mp3
GTA Vice City Stories.jpg
Paradise FM.jpg
Paradise FM.mp3
Radio Espantoso.jpg
Radio Espantoso.mp3
V-Rock.jpg
V-Rock.mp3
VCFL.jpg
VCFL.mp3
VCPR.jpg
VCPR.mp3
Wave 103.jpg
Wave 103.mp3🧾 How to Use This Example
Use this structure as a template
Create your folders using the same naming format
Add your own:
MP3 audio files
JPG station icons
JPG game banners
Ensure all naming rules match exactly
⚖️ Content Responsibility
By using this app and structure:
You confirm that any media you add is:
legally obtained
permitted for your use
You accept responsibility for how content is used or distributed