Liner Notes
Red Guitar Pick
The FATpick Blog

The general settings menu contains several application-wide configuration options such as look-and-feel preferences, log and cache configuration, and more.

General Settings Menu
FATpick's General Settings Menu
With "Show Advanced Options" Enabled
(Screenshot from FATpick v2.5.2)

To access FATpick's general settings, select the "General" option from the Main Settings Menu. See below for a description of the various controls found within the menu.

UPDATE: This is an "evergreen" post that should reflect the most recent version of the application. Last updated: 7 January 2022.

General Settings Menu Options

Top Section

Theme

Use this drop-down menu to select the "skin" or theme that defines the color scheme and other cosmetic details for the application as whole.

Tooltip Mode

Adjusts the number and frequency of the help bubbles that pop-up when hovering over various interface elements.

Your choices include:

  • Novice - enables all tooltips; any available tooltip will be displayed on hover.

  • Intermediate - a balanced mode; disables the most basic or obvious tooltips.

  • Expert - minimal tooltips; only shows tooltips that (a) provide unique, interactive functionality or (b) describe especially complex or confusing controls.

  • Automatic - the default; enables all tooltips the first couple of times you visit a given screen, fewer over time.

Show Keyboard Focus

When enabled, the currently selected button, link, form control, or other interface element will be highlighted in a theme-specific way (such as an outline around the element).

Hitting tab or shift+tab on your keyboard will cycle through the available interface elements.

Hitting space or enter will trigger the element with keyboard focus as if you clicked the element with the mouse or trackpad.

Show Advanced Options

To simplify the interface, many advanced or obscure controls are hidden by default

Enabling "Show Advanced Options" will reveal these hidden options. Toggling this feature on (or off) will immediately show (or hide) additional buttons and controls in this menu, other settings menus, and in a few other assorted places throughout the app.

Back Up and Restore

Back Up

Clicking this button will save a copy of your current application settings "in the cloud": uploading your current configuration to the FATpick server so that it can be later restored.

TIP: Backing up your settings to the cloud is a useful way to:
  1. create a save-point that you can easily return to if you want to experiment with different settings;
  2. temporarily store (and recover) your custom configuration if you should need to fully remove and reinstall the application for some reason; and
  3. transfer your custom configuration from one computer to another.

Note that only a single copy of your settings is stored at one time.

Restore

Clicking this button will restore a previously saved configuration.

Note that only the most recently backed-up version of your settings can be restored.

Restore Factory Settings

Clicking this button will remove any custom settings you have applied and revert the application back to the original, "factory default" configuration.

Note that to avoid triggering this option accidentally you'll be asked to confirm this action.

Recenter App Window

Normally FATpick will remember the position of the application window and automatically open to the same size, position and display (monitor) you last used (if available) the next time the app is launched.

In the unlikely event that changes in your display configuration since the last launch leaves your FATpick window difficult to reposition or resize you can use this button to revert to the default window placement (full-size on your primary display).

This button is only visible when Show Advanced Options is enabled.

TIP: You can also restore the default window position by setting the command line parameter FTPK_WIN_RESET=1 via an environment variable or .ini file.

Cache

FATpick uses a small amount of space on your local hard drive to "cache" (temporarily store) songs you've played so that you don't need to download the files again.

The controls in this section can be used to manage this cache.

Note that the Cache section is only visible when Show Advanced Options is enabled.

Cache Size

Use this slider to adjust the amount of space that FATpick will use to store these temporary files.

Currently the cache size can be set between 240 MB and 1.5 GB, but that range is subject to change. See the tooltips associated with this control for an up-to-date range.

Clear Cache Now

There's generally no need to actively "manage" the cache. FATpick will automatically remove (and if necessary, replace) data in the cache when they become old or stale, and delete the least-recently-used files when the cache would otherwise exceed the allocated size.

You can, however, tell FATpick to delete all of its currently cached data by hitting the "Clear Cache Now" button.

Note that it is safe to delete data from the cache. The cached files are optional: FATpick will simply fetch another copy of any missing files that are needed. There should be no side-effect to clearing the cache other than the time it may take to download a fresh copy of the data.

Logs

You can optionally configure FATpick to record diagnostic and debugging information to an application log that you can personally review and/or share with the FATpick support team.

The controls in this section are used to manage this log configuration.

The Logs section is only visible when Show Advanced Options is enabled.

TIP: FATpick's application logs only require a tiny amount of disk space. Currently each individual log file is limited to at most 1 MB and the total size for all of FATpick's application logs is capped to at most 4 MB. Log files will automatically roll-over when these limits are reached.

Enable Logs

FATpick will only generate log files when this option is enabled.

Toggle this switch to the off position to remove any existing application logs and block the creation of any new log files.

This option is enabled by default.

TIP: Use the note at the bottom of this section of the General Settings menu to identify where FATpick's application log files are stored on your system. You can even click the given link to open the log file directory in the Windows Explorer or Mac Finder.

Clear Logs

Click this button to erase the current contents of your FATpick application logs.

Note that if logging is enabled the deleted files are likely to be immediately replaced by newly created, empty files.

Write Diagnostic Report

Clicking this button will write a detailed diagnostic report about your FATpick application instance and system context in which it is running into the application logs.

TIP: This button only writes the diagnostic information to your local application log file. The report is not shared with the FATpick support team automatically. You must send the logs to the support team after the report is written if that is your intent.

If you'd like to review the information contained in the report, you can navigate to the log file directory using the link at the bottom of this section of the menu.

Upload Logs

Click this button to share your application logs with the FATpick support team. This will securely upload a copy of your current log content to FATpick's "cloud" where it can be accessed by the support team.

TIP: If you're looking for a review or response - and we're not already expecting your logs - in addition to sharing the log files please use the in-app or web-based contact form to send a note to the support team describing your issue or concern. Our team is notified when new logs are shared, but won't know what to do with them without additional context.

Also See

See the Main Settings Menu for an index to other configuration options and application preferences.

Look for other posts in the Settings category for related documentation.

FATpick
Also see more posts tagged , or .
Or, visit the tag index, or view the latest posts.