Author Topic: MusicBee File Paths: Installed vs Portable  (Read 10552 times)

karbock

  • Sr. Member
  • ****
  • Posts: 320
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 setup to another computer.

Table of Contents

(1) Environment variables used
(2) Folders and files
(3) Adapting some settings after switching to the portable version
(4) Access and remarks



(1) Environment variables used

The table below uses several environment variables. Unless you have a particular Windows configuration or an older version, here are typical values:

Variable
Typical value (may differ)
%USERPROFILE%C:\Users\(YourUserID)
%APPDATA%C:\Users\(YourUserID)\AppData\Roaming
%LOCALAPPDATA%C:\Users\(YourUserID)\AppData\Local
%ProgramFiles(x86)%C:\Program Files (x86)

Their accurate values can be displayed from Windows' command-line prompt (cmd.exe). Examples of possible commands:
  • echo %USERPROFILE%
    will display the content of that particular variable.
  • echo %USERPROFILE%\Music\MusicBee
    will display the full path of that subfolder.
  • env
    will display all defined environment variables (a few dozens).


(2) Folders and files

Nr.
Content
Files
Folder
(installed version)
Folder
(portable version)
AMain_settings
A.1Application settingsMusicBee3Settings.ini%APPDATA%\MusicBee\.\AppData
A.2Saved application settings*.ini%APPDATA%\MusicBee\Saved Settings\Application.\AppData\Saved Settings\Application
BLibrary_&_tagsInstalled versionPortable version
B.1LibraryMusicBeeLibrary*.*%USERPROFILE%\Music\MusicBee.\Library
B.2Library filters*.xautopf%APPDATA%\MusicBee\Filters.\AppData\Filters
B.3Custom tagsCustomTagConfig.xml%APPDATA%\MusicBee.\AppData
B.4Genre groupingGenreMapping.xml%APPDATA%\MusicBee.\AppData
B.5Tag hierarchy templates*.txt%APPDATA%\MusicBee\TagHierarchyTemplates.\AppData\TagHierarchyTemplates
CArtist_profilesInstalled versionPortable version
C.1Artist thumbs:
- Album Artist
- Artist
- Composer
- Original Artist

For Conductor/Lyricist, see D.1.
*.jpg%USERPROFILE%\Music\MusicBee\Artist Pictures\Thumb.\Library\Artist Pictures\Thumb
C.2Artist thumbs, resized from C.1*.png%LOCALAPPDATA%\MusicBee\InternalCache\ArtistThumbs.\AppData\InternalCache\ArtistThumbs
C.3Large pictures*.dat, *.tmp%LOCALAPPDATA%\MusicBee\InternalCache\ArtistBackdrops.\AppData\InternalCache\ArtistBackdrops
C.4Biographies*.bio.dat%LOCALAPPDATA%\MusicBee\InternalCache\ArtistData.\AppData\InternalCache\ArtistData
C.5Similar artists*.similar.dat%LOCALAPPDATA%\MusicBee\InternalCache\ArtistData.\AppData\InternalCache\ArtistData
C.6Soundtrack pictures%USERPROFILE%\Music\MusicBee\Soundtrack Pictures.\Soundtrack Pictures\
DIconsInstalled versionPortable version
D.1Genre / Genre grouping
Lyricist /  Conductor
Language / Mood / Occasion
Custom tags / Virtual tags
*.png%USERPROFILE%\Music\MusicBee\Artwork\Grouping Icons.\Library\Artwork\Grouping Icons
D.2Highlighting icons*.ico, *.png
  • %ProgramFiles(x86)%\MusicBee\Icons
  • %APPDATA%\MusicBee\Icons
.\Icons
D.3Toolbar icons*.ico, *.png
  • %ProgramFiles(x86)%\MusicBee\Icons
  • %APPDATA%\MusicBee\Icons
.\Icons
D.4Tab icons*.ico, *.png
  • %ProgramFiles(x86)%\MusicBee\Icons
  • %APPDATA%\MusicBee\Icons
.\Icons
EPlaylistsInstalled versionPortable version
E.1Playlists*.mbp, *.xautopf%USERPROFILE%\Music\MusicBee\Playlists.\Library\Playlists
E.2Current playlistNowPlaying.mbp%USERPROFILE%\Music\MusicBee.\Library\
E.3Current auto DJ playlistAutoDj.xautopf%APPDATA%\MusicBee\Recent Queries.\AppData\Recent Queries
FSkins_&_layoutsInstalled versionPortable version
F.1Skins*.xml, *.xmlc
  • %ProgramFiles(x86)%\MusicBee\Skins
  • %APPDATA%\MusicBee\Skins
.\Skins
F.2Theater 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.3Custom views*.mbv%APPDATA%\MusicBee\Saved Settings\Views.\AppData\Saved Settings\Views
F.4Custom panel arrangements (layouts)*.layout, *.tab-layout%APPDATA%\MusicBee\Saved Settings\Layouts.\AppData\Saved Settings\Layouts
GPlugins_&_equaliserInstalled versionPortable version
G.1Plugins(various)
  • %ProgramFiles(x86)%\MusicBee\Plugins
  • %APPDATA%\MusicBee\Plugins
.\Plugins
G.2Visualisers(various)
  • %ProgramFiles(x86)%\MusicBee\BBplugin
  • %APPDATA%\MusicBee\BBplugin
.\BBplugin
G.3Equaliser presets*.sde
  • %ProgramFiles(x86)%\MusicBee\Equaliser
  • %APPDATA%\MusicBee\Equaliser
.\Equaliser
HPodcastsInstalled versionPortable version
H.1IndexSubscriptions.dat%USERPROFILE%\Music\MusicBee\Podcasts.\Library\Podcasts\
H.2Episodes(audio files)%USERPROFILE%\Music\MusicBee\Podcasts.\Library\Podcasts\
H.3Artwork(picture files)%LOCALAPPDATA%\MusicBee\InternalCache\Subscriptions.\AppData\InternalCache\Subscriptions
IBookmarksInstalled versionPortable version
I.1Indexbookmarks.dat%APPDATA%\MusicBee.\AppData


(3) Adapting some settings
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 and Subscriptions.dat still contain references to several folders, you need to perform some easy replacements in the files with your preferred text editor.

Caution:
  • Make a backup copy of MusicBee3Settings.ini and Subscriptions.dat before editing them!
  • When replacing an old path by the new matching one, ensure the new path exists in your portable version.
The variable parts depending on your particular configuration are in green below.
The drive letter (C: here) may also differ in your case.


(3a) In MusicBee3Settings.ini

Where in the file?Replace:By:
At the beginning:
<ENV_OrigSetPath>...
</ENV_OrigSetPath>
C:\Users\(YourUserID)\AppData\Roaming\MusicBee

or the value of:
%APPDATA%\MusicBee
(Portable MB path)\AppData
On the next line:
<ENV_LibPath>...
</ENV_LibPath>
,
C:\Users\(YourUserID)\Music\MusicBee

or the value of:
%USERPROFILE%\Music\MusicBee
(Portable MB path)\Library
Below:
<ENV_KnownLib>...
</ENV_KnownLib>
,
C:\Users\(YourUserID)\Music\MusicBee

or the value of:
%USERPROFILE%\Music\MusicBee
(Portable MB path)\Library
all occurrencesC:\Users\(YourUserID)\Music\MusicBee\Playlists

or the value of:
%USERPROFILE%\Music\MusicBee\Playlists
(Portable MB path)\Library\Playlists
all occurrencesC:\Program Files (x86)\MusicBee

or the value of:
%ProgramFiles(x86)%\MusicBee
(Portable MB path)


(3b) In Subscriptions.dat

Where in the file?Replace:By:
all occurrencesC:\Users\(YourUserID)\Music\MusicBee\Podcasts

or the value of:
%USERPROFILE%\Music\MusicBee\Podcasts
(Portable MB path)\Library\Podcasts


(4) Access and remarks

Nr.
Content
Access
AMain_settings
A.1Application settingsPreferences
A.2Saved application settings(MB menu) -> Edit -> Saved settings
BLibrary_&_tags
B.1Library-
B.2Library filtersPreferences -> Library -> Music library -> define filters
B.3Custom tagsPreferences -> Tags (1) -> custom tags
B.4Genre groupingPreferences -> Tags (2) -> tag handling -> group genres
B.5Tag hierarchy templates(Tag Hierarchy Explorer menu) -> Edit Tag Hierarchy
CArtist_profiles
C.1Artist thumbs:
- Album Artist
- Artist
- Composer
- Original Artist

For Conductor/Lyricist, see D.1.
  • Music tab -> (Left panel) -> Album Artist / Artist / Composer / Original Artist
  • Music Explorer -> Artist Information -> Profile
C.2Artist thumbs, resized from C.1-
C.3Large picturesMusic Explorer -> Artist Information -> Profile
C.4BiographiesMusic Explorer -> Artist Information -> Profile
C.5Similar artistsMusic Explorer -> Artist Information -> Similar Artists -> More Similar Artists
C.6Soundtrack pictures
  • Preferences -> Tags (1) -> artwork -> soundtrack picture locations
  • Learn the whereabouts on MusicBee Wiki
DIcons
D.1Genre icons / Genre grouping icons
Lyricist /  Conductor
Language / Mood / Occasion
Custom tags / Virtual tags
  • Music tab -> Left panel -> Genre / Genre Category
  • Preferences -> Tags (2) -> tag handling -> group genres
D.2Highlighting iconsPreferences -> Tags (2) -> tag handling -> highlighting
D.3Toolbar iconsToolbar context menu -> Configure Toolbar…
D.4Tab iconsTab context menu -> Select Tab Icon...
EPlaylists
E.1PlaylistsPlaylists explorer tab
E.2Current playlistNow Playing tab
E.3Current auto DJ playlistAuto DJ tab
FSkins_&_layouts
F.1Skins(MB menu) -> View -> Skins
F.2Theater modes(MB menu) -> View -> Theater Mode
F.3Custom views(Main panel menu) -> Custom views
F.4Custom panel arrangements (layouts)(MB menu) -> View -> Import/Export
GPlugins_&_equaliser
G.1PluginsPreferences -> Plugins
G.2Visualisers(MB menu) -> View -> Visualizer
G.3Equaliser presetsEqualiser button (player controls)
Last Edit: December 21, 2023, 04:43:14 PM by karbock



psychoadept

  • Global Moderator
  • Sr. Member
  • *****
  • Posts: 10691
Awesome work
MusicBee Wiki
Use & improve MusicBee's documentation!

Latest beta patch (3.5)
(Unzip and overwrite existing program files)

Mr. Trev

  • Sr. Member
  • ****
  • Posts: 454
Fantastic bit of info
Considering the amout of questions regarding backup and new installs, I totally think this should be pinned somewhere…

phred

  • Global Moderator
  • Sr. Member
  • *****
  • Posts: 9305
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.
Download the latest MusicBee v3.5 or 3.6 patch from here.
Unzip into your MusicBee directory and overwrite existing files.

----------
The FAQ
The Wiki
Posting screenshots is here
Searching the forum with Google is  here

hiccup

  • Sr. Member
  • ****
  • Posts: 7791
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

  • Sr. Member
  • ****
  • Posts: 320
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

  • Sr. Member
  • ****
  • Posts: 7791
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

  • Sr. Member
  • ****
  • Posts: 320
Great.
Two nitpicking nitpicks:
...

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

karbock

  • Sr. Member
  • ****
  • Posts: 320
Added entries:

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

Improvements:

* numbering
* access & remarks
Last Edit: October 04, 2022, 08:15:48 AM by karbock

karbock

  • Sr. Member
  • ****
  • Posts: 320
Minor changes:

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

karbock

  • Sr. Member
  • ****
  • Posts: 320
Added:

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


karbock

  • Sr. Member
  • ****
  • Posts: 320
Added:

* Adapting MusicBee3Settings.ini after switching to the portable version

* C.6 Soundtrack pictures