getmusicbee.com

Support => Tips and Tricks => Topic started by: karbock on July 15, 2022, 11:21:02 AM

Title: MusicBee File Paths: Installed vs Portable
Post by: karbock on July 15, 2022, 11:21:02 AM
MusicBee File Paths (Installed vs. Portable)

This summary is intended to help users wishing to:

Table of Contents

(1) Environment variables used (https://getmusicbee.com/forum/index.php?topic=36875.0#post_Title_1)
(2) Folders and files (https://getmusicbee.com/forum/index.php?topic=36875.0#post_Title_2)
  • (A) Main settings (https://getmusicbee.com/forum/index.php?topic=36875.0#post_Title_2A)
  • (B) Library & tags (https://getmusicbee.com/forum/index.php?topic=36875.0#post_Title_2B)
  • (C) Artist profiles (https://getmusicbee.com/forum/index.php?topic=36875.0#post_Title_2C)
  • (D) Icons (https://getmusicbee.com/forum/index.php?topic=36875.0#post_Title_2D)
  • (E) Playlists (https://getmusicbee.com/forum/index.php?topic=36875.0#post_Title_2E)
  • (F) Skins & layouts (https://getmusicbee.com/forum/index.php?topic=36875.0#post_Title_2F)
  • (G) Plugins & equaliser (https://getmusicbee.com/forum/index.php?topic=36875.0#post_Title_2G)
  • (H) Podcasts (https://getmusicbee.com/forum/index.php?topic=36875.0#post_Title_2H)
  • (I) Bookmarks (https://getmusicbee.com/forum/index.php?topic=36875.0#post_Title_2I)
(3) Adapting some settings after switching to the portable version (https://getmusicbee.com/forum/index.php?topic=36875.0#post_Title_3)
  • (3a) In MusicBee.ini (https://getmusicbee.com/forum/index.php?topic=36875.0#post_Title_3a)
  • (3b) In Subscriptions.dat (https://getmusicbee.com/forum/index.php?topic=36875.0#post_Title_3b)
(4) Access and remarks (https://getmusicbee.com/forum/index.php?topic=36875.0#post_Title_4)



(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:


(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:
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 (https://musicbee.fandom.com/wiki/How_to_Display_Movie_Backdrops_for_Soundtrack_Music)
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)
Title: Re: Migration INSTALLED <-> PORTABLE version
Post by: frankz on July 15, 2022, 12:57:38 PM
Excellent. 
Title: Re: Migration INSTALLED <-> PORTABLE version
Post by: The Incredible Boom Boom on July 16, 2022, 11:53:26 AM
This is outstanding
Title: Re: Migration INSTALLED <-> PORTABLE version
Post by: psychoadept on July 17, 2022, 07:06:03 AM
Awesome work
Title: Re: Migration INSTALLED <-> PORTABLE version
Post by: Mr. Trev on July 18, 2022, 03:08:40 PM
Fantastic bit of info
Considering the amout of questions regarding backup and new installs, I totally think this should be pinned somewhere…
Title: Re: Migration INSTALLED <-> PORTABLE version
Post by: phred on July 18, 2022, 07:32:17 PM
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.
Title: Re: MusicBee File Paths: Installed vs Portable
Post by: hiccup on July 19, 2022, 01:16:13 PM
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.
Title: Re: MusicBee File Paths: Installed vs Portable
Post by: karbock on July 20, 2022, 03:29:15 PM
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.
Title: Re: MusicBee File Paths: Installed vs Portable
Post by: hiccup on July 20, 2022, 04:14:26 PM
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
Title: Re: MusicBee File Paths: Installed vs Portable
Post by: karbock on July 20, 2022, 06:37:20 PM
Great.
Two nitpicking nitpicks:
...

I agree with you.
As for .XMLC as possible extension for TMs: I don't find any occurrence either.
Title: Re: MusicBee File Paths: Installed vs Portable
Post by: karbock on October 03, 2022, 07:39:22 PM
Added entries:

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

Improvements:

* numbering
* access & remarks
Title: Re: MusicBee File Paths: Installed vs Portable
Post by: karbock on October 12, 2022, 08:53:52 PM
Minor changes:

* %USERPROFILE%\AppData\Roaming -> %APPDATA%
* %USERPROFILE%\AppData\Local -> %LOCALAPPDATA%
Title: Re: MusicBee File Paths: Installed vs Portable
Post by: karbock on October 29, 2022, 11:24:14 AM
Added:

D.4 - Tab icons (feature available from v3.5.8334)
Title: Re: MusicBee File Paths: Installed vs Portable
Post by: karbock on November 06, 2022, 03:52:28 PM
Added:

* More details in C.1 + D.1
Title: Re: MusicBee File Paths: Installed vs Portable
Post by: karbock on February 20, 2023, 09:10:46 AM
Added:

* Adapting MusicBee3Settings.ini after switching to the portable version

* C.6 Soundtrack pictures
Title: Re: MusicBee File Paths: Installed vs Portable
Post by: karbock on May 15, 2023, 07:12:08 PM
Added:

* E.4 History
Title: Re: MusicBee File Paths: Installed vs Portable
Post by: hiccup on May 31, 2023, 05:59:22 PM
Perhaps this location for TM's should be added?:
https://getmusicbee.com/forum/index.php?topic=39390.msg212893#msg212893

Doing a speed-read on it, I am a bit confused if this is about Theater Modes or Skins though.
Title: Re: MusicBee File Paths: Installed vs Portable
Post by: karbock on May 31, 2023, 07:33:36 PM
Perhaps this location for TM's should be added?:
https://getmusicbee.com/forum/index.php?topic=39390.msg212893#msg212893

Doing a speed-read on it, I am a bit confused if this is about Theater Modes or Skins though.

In fact, the location is already in the table, but with «%APPDATA%» instead of «c:\users\<your id>\appdata\roaming».
There are 2 «Add Skin» commands:
Title: Re: MusicBee File Paths: Installed vs Portable
Post by: hiccup on May 31, 2023, 08:00:14 PM
In fact, the location is already in the table, but with «%APPDATA%» instead of «c:\users\<your id>\appdata\roaming».
Ah, O.K. I overlooked that.
But other users might too? Not everybody will fully understand the workings of %APPDATA%?
(not a strong opinion, your call of course)
Title: Re: MusicBee File Paths: Installed vs Portable
Post by: sveakul on May 31, 2023, 08:08:52 PM
I just have to say, wouldn't the music world would be so much simpler if everyone just used the P-O-R-T-A-B-L-E version of MusicBee?  Got multiple users on the same PC with their own preferences?  Just make multiple portable installs in differently named folders.  Like, where is the disadvantage?
Title: Re: MusicBee File Paths: Installed vs Portable
Post by: phred on May 31, 2023, 08:18:02 PM
Like, where is the disadvantage?
There is no disadvantage. I think those users who don't use the Store (yech) or the Portable versions are folks who aren't too conversant with PCs in general. They don't understand unzipping and placing in a directory of your choice. Or even having the knowledge to select a directory for the portable files. Simply clicking on "install" takes all the guess work out of it for those PC neophytes.

EDIT: correction
Title: Re: MusicBee File Paths: Installed vs Portable
Post by: hiccup on May 31, 2023, 08:23:31 PM
Like, where is the disadvantage?
There is no disadvantage.
Luckily, using the portable version is already strongly recommended and well-explained in the F.A.Q. under items #1a, #1b and #1c.
(oh wait, there hasn't been a functional F.A.Q. for a while)
Title: Re: MusicBee File Paths: Installed vs Portable
Post by: sveakul on May 31, 2023, 08:54:34 PM
I think those users who don't use the Store (yech) or the Portable versions are folks who aren't too conversant with PCs in general.
phred I think you meant to say "..who USE the Store or the INSTALLER versions.."
Title: Re: MusicBee File Paths: Installed vs Portable
Post by: karbock on May 31, 2023, 09:03:43 PM
In fact, the location is already in the table, but with «%APPDATA%» instead of «c:\users\<your id>\appdata\roaming».
Ah, O.K. I overlooked that.
But other users might too? Not everybody will fully understand the workings of %APPDATA%?
(not a strong opinion, your call of course)
I've just added some explanation about the environment variables used.
Title: Re: MusicBee File Paths: Installed vs Portable
Post by: phred on May 31, 2023, 09:06:15 PM
phred I think you meant to say "..who USE the Store or the INSTALLER versions.."
Of course I did. Thanks for catching that. I'll edit it.
Title: Re: MusicBee File Paths: Installed vs Portable
Post by: Gendji on July 18, 2023, 04:04:54 PM
No idea if this is something that belongs in this guide but while trying to make the switch to portable, i noticed that the podcast graphics i use are stored at "L:\Users\*.*\AppData\Local\MusicBee\InternalCache\Subscriptions\".

The links can be found in the Subscriptions.dat file under \Library\*.*\Podcasts\.

I changed the .dat file with a text editor replaced "L:\Users\*.*\AppData\Local\MusicBee\InternalCache\Subscriptions\" with "\MusicBeePortable\AppData\InternalCache\Subscriptions\" and it worked.
Title: Re: MusicBee File Paths: Installed vs Portable
Post by: karbock on July 19, 2023, 06:55:01 AM
No idea if this is something that belongs in this guide but while trying to make the switch to portable, i noticed that the podcast graphics i use are stored at "L:\Users\*.*\AppData\Local\MusicBee\InternalCache\Subscriptions\".

The links can be found in the Subscriptions.dat file under \Library\*.*\Podcasts\.

I changed the .dat file with a text editor replaced "L:\Users\*.*\AppData\Local\MusicBee\InternalCache\Subscriptions\" with "\MusicBeePortable\AppData\InternalCache\Subscriptions\" and it worked.

Thanks for your contribution, Gendji! It fits perfectly within the purview of this thread.
I have just updated the main post accordingly.
Title: Re: MusicBee File Paths: Installed vs Portable
Post by: Gendji on July 19, 2023, 07:49:40 AM
Thanks for your contribution, Gendji! It fits perfectly within the purview of this thread.
I have just updated the main post accordingly.

Happy to help, and thank you very much for the guide, finally managed to go portable :)
Title: Re: MusicBee File Paths: Installed vs Portable
Post by: Gendji on July 20, 2023, 01:02:02 PM
One other thing i noticed while figuring out how to get file associations working with portable.

No idea if that works for everyone but when i started portable as administrator, the file associations that i had with the installed version, where saved in the registry, assigned to portable. So .flac, .mp3 etc., open portable MB and play when clicked in explorer for example. That's all i had to do to make it work. 

Hope i am making sense.
Title: Re: MusicBee File Paths: Installed vs Portable
Post by: karbock on December 21, 2023, 04:40:58 PM
* Added: Bookmarks