// how to use
Get the real song in your level
No tech skills needed. Pick one option below and follow the steps — each one is a single thing to do.
Make GD play it by itself
Set it up once. After that, every level that needs one of our songs gets it automatically.
about 2 minutes · PC & Android QuickJust download the song
Get the mp3 file for one song. Good if you only need it once.
about 30 seconds// option 1
Make GD play it by itself
What device do you play on?
-
1
Install Geode
Geode is a free app that lets Geometry Dash use mods. Already have it? You'll see a Geode button on GD's main menu — skip to step 2.
- Open geode-sdk.org and press Download.
- Open the file you downloaded and press Install. It finds GD for you.
- On your phone, open geode-sdk.org and download Geode Launcher.
- Install it. If your phone asks about “unknown apps”, press Allow.
- From now on, open GD with the Geode Launcher app instead of the normal GD icon.
✓ Done when: you open GD and see a Geode button on the main menu.
-
2
Install the Jukebox mod
Jukebox is the mod that swaps songs for you.
- In GD, press the Geode button on the main menu.
- Go to the Download tab and search Jukebox.
- Press Install, then restart GD when it asks.
✓ Done when: Jukebox shows up in Geode's Installed tab.
-
3
Add our link to Jukebox
This tells Jukebox where to find our songs. You only do this once.
https://gd.zxcinc.dev/jukebox-index.json- In GD, press Geode → open the Installed tab.
- Find Jukebox and press its settings button (the gear ⚙).
- Find Indexes, press Add, and paste the link. (Hold your finger on the box to paste.)
- Close GD completely and open it again. Jukebox only reads the link when the game starts.
✓ Done when: our link is in the Indexes list (next to the two that were already there — leave those on).
-
4
Play the level
- Open the level you want to play.
- Tap the song name on the level page. The Jukebox list opens.
- Find our song in the list and tap download. When it's done, tap the song to pick it.
- Press play. That's it — GD will use this song every time from now on.
✓ Done when: you hear the new song when the level starts.
Want the old song back? Tap the song name again and pick the first (default) song in the list.
// option 2
Just download the song
-
1
Download it
Go to the songs page and press Download on the song. The file is named after its song ID (like
717885.mp3) — don't rename it. -
2
Put it in the game
If you have Jukebox: open the level, tap the song name, press Add (+) and pick the file you downloaded.
If you don't (PC only): press Win + R, paste
%LOCALAPPDATA%\GeometryDash, press Enter, and drag the file into that folder. If Windows asks, choose Replace.
// words you'll see
What do these words mean?
Song ID
The number GD uses for a song. Each song here shows it — tap it to copy.
Geode
A free app that lets Geometry Dash use mods.
Jukebox
A Geode mod that swaps a level's song for a different one.
Link / index
Our list of songs. Adding it to Jukebox lets it find our songs by itself.
NONG
“Not On NewGrounds” — a song that isn't on Newgrounds, so GD can't get it alone.
// help
Something not working?
I added the link but I don't see the song
Close GD fully and open it again — Jukebox only reads the link when the game starts. Also check the level uses the same song ID as the one on our songs page.
The song doesn't match the level
Make sure you picked our version in the Jukebox list — other lists can have remixes of the same song.
Will my friends hear the song too?
Only if they follow this guide too. Everyone else hears the normal song for that ID.
I make levels — how do I use this?
Set your level's song to the song ID shown on our songs page, and write Song: gd.zxcinc.dev in your level description so players know where to get it. Want a song added? Ask in the Discord.
Does it cost anything?
No. It's free, with no account and no ads.
Still stuck? Ask in the zxcinc Discord.