Moving settings to a different computer

A quick tip on how to move your bliss rule settings to a different computer...

As I add more and more rules to bliss, it becomes more and more desirable to keep a record of what your settings are, because recreating them becomes harder the more rules you have! If you purchase a new computer, rebuild a server, or even just install bliss for a different user on an existing computer the settings from your previous install will not be transferred.

I received this email before Christmas:

I've got a new PC and want to move bliss across. What do I need to do to transfer the registration and config across?

The bliss configuration is stored in three files inside your %USER_HOME%\.bliss folder. Copying the configuration is as simple as copying these files to the correct location on your new installation.

%USER_HOME% is the path to your home folder on your particular computer, so the .bliss folder location depends on your operating system. By default, and in most cases, these are:

Windows XP C:\Documents and Settings\[username]\.bliss
Windows Vista, 7, 8 and 10 C:\Users\[username]\.bliss
Mac OS X (see below) /Users/[username]/Library/Preferences/bliss
Linux /home/[username]/.bliss
Docker /config (within the container); find where this is mounted from in the run command
Synology /var/packages/bliss/target/var/.bliss
QNAP `getcfg SHARE_DEF defVolMP -f /etc/config/def_share.info`/.qpkg/bliss/.bliss
VortexBox /root/.bliss

In that folder, make a copy of:

  • settings
  • activePolicies
  • ui

Copy these to the equivalent %USER_HOME%\.bliss folder on your target computer. Then, restart, and the settings should apply.

You may see other folders, such as jetty-ui and jetty-debug. Don't copy them; they are files used as to cache the user interface when running, and are regenerated. In some cases you may find the resulting file paths are too long to copy anyway.

A note on music libraries

There's a particular setting in settings that sets the music folder(s) being managed by bliss:

musicLibrary=/Volumes/My Music

The actual value (the right hand side) of musicLibrary will depend on your music library, of course! The important bit to be aware of is that this might not make sense on the target computer. If the location is on an internal hard drive, for instance, that location may not exist on the target.

If that's the case, don't expect bliss to start scanning straight away; you'll have to edit the music library location under settings and then Apply rules.

Moving your licence

Unfortunately your fixes licence cannot be moved technically such that it just appears on the new install. To install your licence, find the code from your purchase email, click the n fixes left link, and copy/paste the code on that page.

Thanks to ChristianReese for the image above.
tags: rules installation

The Music Library Management blog

Dan Gravell

I'm Dan, the founder and programmer of bliss. I write bliss to solve my own problems with my digital music collection.