Music & Tuneify
Configure the Music library and the Tuneify ringtone/wallpaper store, including upload limits and approval.
Music is the server's shared music library. Tuneify is where players get ringtones, notification sounds and wallpapers. Both accept player uploads, and both hold uploads for admin approval before anyone else sees them.
Music
In Settings → Music in gksphone/config/config.json:
"Music": {
"uploadEnabled": true,
"maxDuration": 600,
"allowedFormats": ["mp3", "ogg"],
"defaultThumbnail": "/html/img/music/default-playlist.png"
}| Field | Does |
|---|---|
uploadEnabled | Show the Upload tab. false makes the library read-only |
maxDuration | Longest track, in seconds |
allowedFormats | Accepted audio formats |
defaultThumbnail | Cover used when the uploader supplies none |
maxDuration here only governs the interface. The server checks uploads against Config.MusicMaxDuration in config.lua separately — set both to the same value, or the app accepts a track the server then rejects.
Tuneify
"Tuneify": {
"uploadEnabled": true,
"allowedAudioFormats": ["mp3", "ogg"],
"allowedImageFormats": ["jpg", "jpeg", "png", "webp"],
"maxAudioDuration": 30
}Audio here is ringtones and notification sounds, so maxAudioDuration is short by design. Images are wallpapers.
To ship sounds and wallpapers yourself rather than take uploads, see Custom ringtones and notifications and Custom Wallpapers.
Approving uploads
Uploads are stored as pending and stay invisible until approved. Reviewing them needs admin auth:
/adminauth trueAn Admin tab then appears in Music and Tuneify, where you preview and approve or reject. /adminauth false turns it back off.
| Framework | Permission |
|---|---|
| ESX | admin |
| QBCore | god |
| Standalone | none — anyone can run it |
On standalone there is no permission check on /adminauth. Restrict it with an ACE before opening your server.
What players see
Music — Home and Search to browse, Library for their own approved uploads, Upload to submit a URL with title and artist. With 3D audio on, tracks can be heard by players nearby.
Tuneify — Home lists ringtones, notification sounds and wallpapers; Apply sets one straight away. Upload takes a category, title and file URL, and pending items can be deleted before review.