Link Search Menu Expand Document

Upgrading Georgia

Georgia is updated frequently. While I welcome people cloning the github repo and getting the most up to date code, if it’s not in an official release there may be bugs/crashes and other bad behavior. If you’ve never edited javascript in a text-editor, you should probably stick to the official releases.

Checking for upgrades

Once every 24 hours, Georgia will check to determine if there is a new version of the theme available. If no song is playing and an update is available, the theme will notify you:


That “Update Available” text is a hyperlink, and clicking on it will open your default browser and take you to the Georgia releases page.

Alternatively if you want to check if there’s a new version while a song is playing you can use the option in the Help Menu:


Upgrading to the latest version

If there’s a new version on the releases page, just click on the Source Code .zip from the assets section to download the new version:


Inside that zip will be a folder with the name “Georgia-2.x.x” (version will change each time). Go inside that folder and then extract its contents to the georgia folder you initially installed the theme to in step #3 of the install instructions.

If foobar is still running, you can right-click on the background of the theme and select “Reload”, or just start foobar and you will be on the latest version.

Config file upgrades

After upgrading and reloading the theme, the configuration file will be upgraded, and any new or updated properties from the new version will be added to the configuration file. This might mean that in some rare occasions, a value you have edited might be overwritten with a new default. This will be done sparingly and I will attempt to notify users when it happens. 99% of the time, any existing properties will be left completely untouched.

The old version of the configuration file will be backed up to a new file containing the version of georgia which wrote it. For example, upgrading from 2.0.0 to 2.1.0 will create a georgia-config-2.0.0.jsonc. You can use these backups in case something goes wrong and you need to downgrade the version of Georgia, or so that you have a copy of your setting for any properties that might get reset to new defaults during the upgrade.

Copyright © 2018-2021 by kbuffington