Music Library format
The Music Library is stored in your save directory as musiclibrary.dat. To learn how to retreive it from the servers, refer to this page.
To decode musiclibrary.dat, you need to Base64 URL-Safe decode it and Zlib inflate it.
The Music library is split into 4 parts:
{version}|{artists}|{songs}|{tags}Version
This is just the music library version. Not much more to say here.
Artists
These are all of the artists, separated by ; in the following format:
{artistID},{name},{website},{youtubeChannel}
The website is the full link, but it is URL encoded. The YouTube channel link is only the part that comes after https://youtube.com/channel/. If either of these are missing, there will be a space character in place of them.
Here is an example of an artist:
286,F-777,https%3A%2F%2Fjessevalentinemusic.bandcamp.com,UC6MNIegxWVDe6tOjL92QkUwSongs
This is where the old (2.205-) and new (2.206+) music libraries diverge. In both libraries, the songs are separated with ;. However, the new music library has each song in this format:
{id},{name},{artistID},{filesize},{duration},{tags},{musicPlatform},{extraArtists},{externalLink},{newButton},{priorityOrder},{songNumber}
Meanwhile the old music library has each song in this format:
{id},{name},{artistID},{filesize},{duration},{tags}
Here’s an explanation for each key:
| Name | Type | Description |
|---|---|---|
| id | integer | The song ID |
| name | string | The song name |
| artistID | integer | The primary artist ID |
| filesize | integer | The file size of the song in bytes |
| duration | integer | The song’s duration in seconds |
| tags | string | The song’s tags, separated by dots. The string also has extra dots at the start and end for unknown reasons |
| musicPlatform | integer | The platform this song comes from. 0 for None, 1 for NCS. |
| extraArtists | string | The IDs of the artists that contributed to the song, separated with . |
| externalLink | string | The external link to the song (NOT the GD download link) |
| newButton | boolean | Whether there’s a yellow NEW icon next to the song |
| priorityOrder | integer | The priority order of the song. Usually, songs are ordered alphabetically, but if the song has this number set above 0, then it gets put above all the other songs. The song also receives a blue NEW icon. All of the songs with this property have the previous property set as 0. |
| songNumber | integer | The number of the song in the list. Starts at 1. Usage is unknown |
Tags
These are all the tags that you can filter songs by. They are stored in the following format:
{id},{name};{id},{name}...
All tags as of version 117:
144,16bit;49,8bit;126,Acion;20,Action;114,Adventure;90,African;84,Aggressive;37,Alert;187,Alternative dance;211,Alternative hip-hop;186,Alternative pop;17,Ambiance;121,Ambience;124,Ambient;169,Angry;194,Anti-pop;66,Asian;115,Atmosphere;70,Atmospheric;204,Bass house;179,Bass music;39,Battle;232,Big room house;100,Blues;58,Boss;75,Bouncy;147,Brazilian phonk;184,Breakbeat;79,Bright;16,Calm;82,Calming;40,Casual;127,Celtic;165,Chasing;123,Chill;199,Chill bass;192,Chill house;195,Chill pop;48,Chiptune;23,Christmas;128,Cinematic;94,Classical;233,Color bass;41,Combat;9,Comedy;231,Complextro;89,Contemporary;72,Creepy;145,Cute;43,Cyberpunk;155,Dance;173,Dance-pop;221,Dance-punk;203,Dance-rock;11,Dark;190,Deep house;129,Desert;99,Disco;209,Disco house;14,Doom;205,Downtempo;149,Dreamy;78,Driving;109,Drone;164,Drum & bass;42,Drums;217,Drumstep;191,Dubstep;38,Dungeon;133,Dystopian;156,Eccentric;108,Edm;76,Eerie;6,Electro;219,Electro house;35,Electronic;174,Electronic pop;176,Electronic rock;96,Electronica;157,Elegant;64,Energetic;44,Environment;18,Epic;143,Ethnic;150,Euphoric;36,Event;177,Experimental;15,Fantasy;167,Fear;118,Field;132,Fire;158,Floating;139,Forest;85,Funk;10,Funny;210,Future bass;214,Future bounce;223,Future funk;197,Future house;212,Future rave;200,Future trap;201,Futurepop;110,Futuristic;153,Garage;159,Glamorous;216,Glitch hop;74,Grooving;54,Guitar;24,Happy;213,Hardcore;171,Hardstyle;135,Harp;166,Heavy;148,Hip-hop;91,Holiday;180,Hopeful;22,Horror;154,House;12,Humor;25,Humorous;56,Hybrid;59,Indie;208,Indie dance;29,Instrumental;8,Intense;95,Jazz;170,Jersey club;53,Jrpg;207,Jump-up;175,Laid back;101,Latin;193,Latin-dance;47,Light;188,Liquid;34,Lofi;182,Lofi hip-hop;61,Loop;113,Low-fi;28,Medieval;222,Melbourne bounce;178,Melodic dubstep;185,Melodic house;13,Metal;181,Midtempo bass;146,Military;196,Minimal;102,Modern;206,Moodshappy;105,Musical;26,Mysterious;46,Mystery;77,Mystical;140,Nature;189,Neurofunk;67,Nordic;19,Orchestral;183,Peaceful;57,Percussion;112,Phonk;30,Piano;32,Pirate;63,Platformer;98,Polka;86,Pop;202,Progressive electro;229,Progressive electron;218,Progressive house;73,Puzzle;142,Quirky;104,Reggae;80,Relaxed;62,Relaxing;160,Restless;45,Retro;52,Retrowave;92,Rock;161,Romantic;21,Rpg;151,Running;31,Sad;168,Scary;50,Sci-fi;137,Scifi;117,Sentimental;162,Sexy;122,Sfx;60,Short;87,Silentfilmscore;106,Ska;215,Slap house;131,Slavic;163,Smooth;172,Sneaking;7,Sneaky;81,Somber;71,Soundscape;88,Soundtrack;33,Spooky;103,Stings;134,Suspense;27,Suspenseful;130,Synth;220,Synth-pop;5,Synthwave;136,Tavern;198,Tech house;141,Techno;69,Texture;120,Theme;138,Tonal;119,Town;125,Trance;116,Tranquil;111,Trap;230,Tropical house;93,Unclassifiable;55,Underscore;68,Unnerving;51,Upbeat;83,Uplifting;107,Urban;152,Weird;65,Western;97,World;