= Hidden Preferences =

There are some preferences in Gaupol, which are not exposed in the user interface, but are changeable by editing a configuration file. Most users should have no need to change these, but for completeness, they are documented here. Gaupol's configuration file is an ini-style file with sections and options, where the values of options are JSON-strings and thus have strict syntactic rules. Gaupol's configuration file should usually be found at `~/.config/gaupol/gaupol.conf` on Unix or `C:\Documents and Settings\USERNAME\Application Data\Gaupol\gaupol.conf` on Windows XP or `C:\Users\USERNAME\AppData\Roaming\Gaupol\gaupol.conf` on Windows Vista and later. The hidden preferences and their default values arranged by section are as follows.

{{{
[application_window]
toolbar_style = ICONS
}}}

 * '''`toolbar_style`''' defines the style of the main toolbar, i.e. whether to display icons, text or both. Allowed values are `ICONS`, `TEXT`, `BOTH` and `BOTH_HORIZ`.

{{{
[debug]
text_editor = "gedit +$LINENO $FILE"
}}}

 * '''`text_editor`''' defines the text editor command to use when opening files from the big "Something went wrong" dialog. At least `emacs` works here as well with the same arguments.

{{{
[editor]
undo_limit = 50
use_undo_limit = false
use_zebra_stripes = true
}}}

 * '''`undo_limit`''' defines the maximum amount of undoable (and redoable) actions if `use_undo_limit` is `true`.

 * '''`use_undo_limit`''' allows limiting the amount of undoable actions. This might be useful for computers with very little memory, although it is not tested whether or not it has any actual relevant benefit -- probably not.

 * '''`use_zebra_stripes`''' defines whether to use alternating background colors for odd and even rows in subtitle list displays. These background colors can greatly clarify the display with multiline text, but it comes at a slight cost in speed.

{{{
[file]
max_recent = 10
}}}

 * '''`max_recent`''' defines the maximum amount of recent files to show in the file menu and the open button drop-down on the main toolbar.

{{{
[general]
dark_theme = false
}}}

 * '''`dark_theme`''' allows using the dark GTK+ theme variant.

{{{
[search]
max_history = 10
}}}

 * '''`max_history`''' defines the maximum amount of search history items to show in search dialog's pattern and replacement drop-down entries.

{{{
[video_player]
context_length = 1.0
line_alignment = "center"
seek_length = 30.0
}}}

 * '''`context_length`''' defines the amount (in seconds) before selection to start when playing video matching selection or before selection to seek to when seeking to start of selection. And likewise for end. This should usually be set to a minimum amount of time that provides sufficient amount of leading and trailing context.

 * '''`line_alignment`''' defines the alignment of lines of a single subtitle relative to each other in the video player. Try "left", "right" or "center".

 * '''`seek_length`''' defines the amount (in seconds) seeked by the "Seek Backward" and "Seek Forward" actions.
