Expert Preferences

Harmony has a few expert settings which are not exposed in a preference pane.

You can change these with the defaults command in the Terminal application but you need to do this while Harmony is not running.

In setting a preference you specify a descriptive key and it's given value with the following syntax:

defaults write com.sweeterrhythm.HarmonyApp key value

You can reset a key to its default value using:

defaults delete com.sweeterrhythm.HarmonyApp key

Or you can read the value of a key using:

defaults read com.sweeterrhythm.HarmonyApp key

autoSaveTimer

Harmony saves it's database every 5 minutes (300 seconds). This preference can change the frequency of that. The value is in seconds and is an integer. Values lower than 60 and higher than 900 seconds are ignored.

Example:

defaults write com.sweeterrhythm.HarmonyApp autoSaveTimer -int 600

customPresentationWindow

Harmony normally presents at full screen on an attached display, such as a projector. Or in the preview window, when no secondary display is attached. This preference overrides that behavior and allows you to create a custom presentation window. When set, Harmony's Preview window preference pane is replaced by a similar pane with controls for configuring the custom presentation window. This feature can be useful for creating a presentation window that spans multiple displays or has an aspect ratio different from the display. (The "Displays have separate spaces" mode of OS X Mavericks and later should be disabled to use this feature.) The value is boolean, meaning it will take YES or NO.

Example:

defaults write com.sweeterrhythm.HarmonyApp customPresentationWindow -bool YES

doubleClickingMediaBrowserPlaysItem

When double clicking on an item in the media browser, Harmony will set the default and current background to that item. If you'd rather play the item when double clicking, set this preference. The value is boolean, meaning it will take YES or NO.

Example:

defaults write com.sweeterrhythm.HarmonyApp doubleClickingMediaBrowserPlaysItem -bool YES

presentationDisplay

On a multi-display system, Harmony will use the 2nd display as the presentation display. If you have more than 2 displays and wish to project on a display other than the 2nd display, use this preference. The value is an integer. Values less than 2 or greater than the number of displays are ignored.

Example:

defaults write com.sweeterrhythm.HarmonyApp presentationDisplay -int 3

previewWindowOpacity

This preference can make the preview window transparent. The value is floating point number between 0 and 1. The default is 1. A value of 0 will make the preview window disappear.

Example:

defaults write com.sweeterrhythm.HarmonyApp previewWindowOpacity -float 0.5

useHarmonyBible

By default Harmony will use it's own bible translations, but if it detects Accordance is installed Harmony will use the bible translations provided by Accordance. If you would rather use Harmony's bible translations when Accordance is installed on the same Mac, set this preference. The value is boolean, meaning it will take YES or NO.

Example:

defaults write com.sweeterrhythm.HarmonyApp useHarmonyBible -bool YES

Related articles:

File locations & backup notes
Integrating with Accordance
Preview Window
Using Scripture
Using Themes


Help Home  Help Index