MusicBee File Paths: Installed vs Portable

[karbock]

MusicBee File Paths (Installed vs. Portable)

This summary is intended to help users wishing to:

• switch from the installed to the portable version;
• back up data;
• transfer their MB install to another computer.

Table of Contents Folders and files Adapting MusicBee3Settings.ini after switching to the portable version Access and remarks

Folders and files

The table below uses several environment variables, whose values can be displayed within Windows' command-line prompt (cmd.exe), with command env.

Unless you have a particular Windows configuration or an older version, here are typical values:

• %USERPROFILE% is usually C:\Users\(YourUserID).
• %APPDATA% is usually C:\Users\(YourUserID)\AppData\Roaming.
• %LOCALAPPDATA% is usually C:\Users\(YourUserID)\AppData\Local.
• %ProgramFiles(x86)% is usually C:\Program Files (x86).

Nr.	Content	Files	Folder (installed version)	Folder (portable version)
A	Main settings
A.1	Application settings	MusicBee3Settings.ini	%APPDATA%\MusicBee\	.\AppData
A.2	Saved application settings	*.ini	%APPDATA%\MusicBee\Saved Settings\Application	.\AppData\Saved Settings\Application
B	Library & tags
B.1	Library	MusicBeeLibrary*.*	%USERPROFILE%\Music\MusicBee	.\Library
B.2	Library filters	*.xautopf	%APPDATA%\MusicBee\Filters	.\AppData\Filters
B.3	Custom tags	CustomTagConfig.xml	%APPDATA%\MusicBee	.\AppData
B.4	Genre grouping	GenreMapping.xml	%APPDATA%\MusicBee	.\AppData
B.5	Tag hierarchy templates	*.txt	%APPDATA%\MusicBee\TagHierarchyTemplates	.\AppData\TagHierarchyTemplates
C	Artist profiles
C.1	Artist thumbs: - Album Artist - Artist - Composer - Original Artist	*.jpg	%USERPROFILE%\Music\MusicBee\Artist Pictures\Thumb	.\Library\Artist Pictures\Thumb
C.2	Artist thumbs, resized from C.1	*.png	%LOCALAPPDATA%\MusicBee\InternalCache\ArtistThumbs	.\AppData\InternalCache\ArtistThumbs
C.3	Large pictures	*.dat, *.tmp	%LOCALAPPDATA%\MusicBee\InternalCache\ArtistBackdrops	.\AppData\InternalCache\ArtistBackdrops
C.4	Biographies	*.bio.dat	%LOCALAPPDATA%\MusicBee\InternalCache\ArtistData	.\AppData\InternalCache\ArtistData
C.5	Similar artists	*.similar.dat	%LOCALAPPDATA%\MusicBee\InternalCache\ArtistData	.\AppData\InternalCache\ArtistData
C.6	Soundtrack pictures		%USERPROFILE%\Music\MusicBee\Soundtrack Pictures	.\Soundtrack Pictures\
D	Icons
D.1	Genre icons / Genre grouping icons Lyricist /  Conductor Language / Mood / Occasion Custom tags / Virtual tags	*.png	%USERPROFILE%\Music\MusicBee\Artwork\Grouping Icons	.\Library\Artwork\Grouping Icons
D.2	Highlighting icons	*.ico, *.png	%ProgramFiles(x86)%\MusicBee\Icons %APPDATA%\MusicBee\Icons	.\Icons
D.3	Toolbar icons	*.ico, *.png	%ProgramFiles(x86)%\MusicBee\Icons %APPDATA%\MusicBee\Icons	.\Icons
D.4	Tab icons	*.ico, *.png	%ProgramFiles(x86)%\MusicBee\Icons %APPDATA%\MusicBee\Icons	.\Icons
E	Playlists
E.1	Playlists	*.mbp, *.xautopf, *.xradiopf*	%USERPROFILE%\Music\MusicBee\Playlists	.\Library\Playlists
E.2	Current playlist	NowPlaying.mbp	%USERPROFILE%\Music\MusicBee	.\Library\
E.3	Current auto DJ playlist	AutoDj.xautopf	%APPDATA%\MusicBee\Recent Queries	.\AppData\Recent Queries
E.4	History	ActivityLog.dat	%APPDATA%	.\AppData
F	Skins & layouts
F.1	Skins	*.xml, *.xmlc	%ProgramFiles(x86)%\MusicBee\Skins %APPDATA%\MusicBee\Skins	.\Skins
F.2	Theater modes	*.xml	%ProgramFiles(x86)%\MusicBee\Plugins\TheaterMode.List %ProgramFiles(x86)%\MusicBee\Plugins\TheaterMode.Embeded %APPDATA%\MusicBee\Plugins\TheaterMode.List %APPDATA%\MusicBee\Plugins\TheaterMode.Embeded	.\Plugins\TheaterMode.List .\Plugins\TheaterMode.Embeded
F.3	Custom views	*.mbv	%APPDATA%\MusicBee\Saved Settings\Views	.\AppData\Saved Settings\Views
F.4	Custom panel arrangements (layouts)	*.layout, *.tab-layout	%APPDATA%\MusicBee\Saved Settings\Layouts	.\AppData\Saved Settings\Layouts
G	Plugins & equaliser
G.1	Plugins	(various)	%ProgramFiles(x86)%\MusicBee\Plugins %APPDATA%\MusicBee\Plugins	.\Plugins
G.2	Visualisers	(various)	%ProgramFiles(x86)%\MusicBee\BBplugin %APPDATA%\MusicBee\BBplugin	.\BBplugin
G.3	Equaliser presets	*.sde	%ProgramFiles(x86)%\MusicBee\Equaliser %APPDATA%\MusicBee\Equaliser	.\Equaliser

Adapting MusicBee3Settings.ini
after switching to the portable version

When switching from the installed to the portable version, copying all your files to their new locations is the crucial part.
But not the last step: as MusicBee3Settings.ini still contains references to several folders, you need to perform some easy replacements in the file with your preferred text editor.

Caution:

• Make a backup copy of MusicBee3Settings.ini !
  
• When replacing an old path by the new matching one, always ensure the new path exists in your portable version.

The variable parts depending on your particular configuration are in green below.

Where in the file?	Replace:	By:
At the beginning: <ENV_OrigSetPath>... </ENV_OrigSetPath>	C:\Users\(YourUserID)\AppData\Roaming\MusicBee\	(Portable MB path)\AppData
On the next line: <ENV_LibPath>... </ENV_LibPath>,	C:\Users\(YourUserID)\Music\MusicBee\	(Portable MB path)\Library
Below: <ENV_KnownLib>... </ENV_KnownLib>,	C:\Users\(YourUserID)\Music\MusicBee\	(Portable MB path)\Library
all occurrences	C:\Users\(YourUserID)\Music\MusicBee\Playlists	(Portable MB path)\Library\Playlists
all occurrences	C:\Program Files (x86)\MusicBee	(Portable MB path)

Access and remarks

Nr.	Content	Access
A	Main settings
A.1	Application settings	Preferences
A.2	Saved application settings	(MB menu) -> Edit -> Saved settings
B	Library & tags
B.1	Library	-
B.2	Library filters	Preferences -> Library -> Music library -> define filters
B.3	Custom tags	Preferences -> Tags (1) -> custom tags
B.4	Genre grouping	Preferences -> Tags (2) -> tag handling -> group genres
B.5	Tag hierarchy templates	(Tag Hierarchy Explorer menu) -> Edit Tag Hierarchy
C	Artist profiles
C.1	Artist thumbs, for: - Album Artist - Artist - Composer - Original Artist	Music tab -> (Left panel) -> Album Artist / Artist / Composer / Original Artist Music Explorer -> Artist Information -> Profile
C.2	Artist thumbs, resized from C.1	-
C.3	Large pictures	Music Explorer -> Artist Information -> Profile
C.4	Biographies	Music Explorer -> Artist Information -> Profile
C.5	Similar artists	Music Explorer -> Artist Information -> Similar Artists -> More Similar Artists
C.6	Soundtrack pictures	Preferences -> Tags (1) -> artwork -> soundtrack picture locations Learn the whereabouts on MusicBee Wiki [/url]
D	Icons
D.1	Genre icons Genre grouping icons	Music tab -> Left panel -> Genre / Genre Category Preferences -> Tags (2) -> tag handling -> group genres
D.2	Highlighting icons	Preferences -> Tags (2) -> tag handling -> highlighting
D.3	Toolbar icons	Toolbar context menu -> Configure Toolbar…
D.4	Tab icons	Tab context menu -> Select Tab Icon...
E	Playlists
E.1	Playlists	Playlists explorer tab
E.2	Current playlist	Now Playing tab
E.3	Current auto DJ playlist	Auto DJ tab
F	Skins & layouts
F.1	Skins	(MB menu) -> View -> Skins
F.2	Theater modes	(MB menu) -> View -> Theater Mode
F.3	Custom views	(Main panel menu) -> Custom views
F.4	Custom panel arrangements (layouts)	(MB menu) -> View -> Import/Export
G	Plugins & equaliser
G.1	Plugins	Preferences -> Plugins
G.2	Visualisers	(MB menu) -> View -> Visualizer
G.3	Equaliser presets	Equaliser button (player controls)

[frankz]

Excellent. 

[The Incredible Boom Boom]

This is outstanding

[psychoadept]

Awesome work

[Mr. Trev]

Fantastic bit of info
Considering the amout of questions regarding backup and new installs, I totally think this should be pinned somewhere…

[phred]

I totally think this should be pinned somewhere…

I plan on doing that but I've asked the OP to make a few changes for legibility.

[hiccup]

I'm not sure these are in the purview of your table, but in case that they are you may want to add them:

Custom tags - CustomTagConfig.xml - \AppData
Equalizer presets - .sde - \Equaliser
Library filters - .xautopf - \AppData\Filters
Genre grouping - GenreMapping.xml - \AppData
Program settings - MusicBee3Settings.ini - \AppData

Saved application settings - .ini - \AppData\Saved Settings\Application
Saved layouts - .tab-layout - \AppData\Saved Settings\Layouts
Saved views - .mbv - \AppData\Saved Settings\Views
Toolbar icons - .png - \Icons

Those are their locations in a portable install. I don't know where they are in the installed version.

[karbock]

I'm not sure these are in the purview of your table, but in case that they are you may want to add them:
...

Thanks! I've just updated the table.

[hiccup]

Great.
Two nitpicking nitpicks:
- Skins are named Themes in your table. That's not wrong, but Skins is the term that is used pretty much everywhere, both in MB and on the forum.
- The table has .xmlc as a possible extension for Theater modes. I am pretty sure TMs are always .xml

[karbock]

Great.
Two nitpicking nitpicks:
...

I agree with you.
As for .XMLC as possible extension for TMs: I don't find any occurrence either.

[karbock]

Added entries:

* Artist profiles -> large pictures
* Artist profiles -> biographies
* Artist profiles -> similar artists
* Visualizers

Improvements:

* numbering
* access & remarks

[karbock]

Minor changes:

* %USERPROFILE%\AppData\Roaming -> %APPDATA%
* %USERPROFILE%\AppData\Local -> %LOCALAPPDATA%

[karbock]

Added:

D.4 - Tab icons (feature available from v3.5.8334)

[karbock]

Added:

* More details in C.1 + D.1

[karbock]

Added:

* Adapting MusicBee3Settings.ini after switching to the portable version

* C.6 Soundtrack pictures