Skip to content

Settings file

Addy edited this page Jun 3, 2017 · 6 revisions

Settings

Settings are stored in JSON format. The settings.json file is located in the user data directory. On Windows this is typically something like c:\Users\Addy\Owl\Roaming\settings.json. on macOS it may look like /Users/addy/Library/Application Support/lulzApps/Owl.

Reference

boardlist.background.color (string) (hex-color)

The background color of the board panel. This is #444444 by default.


datetime.date.format

The date format string. The three possible values are:

  • long - Dates will use the operating system's "long" name for months. For example, on an English operatng system this would display "Jaunary" for the month.

  • short - Same as above except the abbreiviated or "short" name for a month. Thus this would display "Jan" instead of January.

  • textdate - Similar to `short but includes a three letter abbreviation of the day.

The default is textdate.


datetime.date.pretty (bool)

If true then dates of the same day or previous day will be changed from the actual date to "Today" or "Yesterday". If false then the actual date will always be used. This is used only when datetime.format is set to default.


datetime.format (enum)

Dates can be displayed in several formats. The two possible formats are:

  • moment - This works similar to the Moment.js (https://momentjs.com/) where dates are displayed using "A moment ago", "4 hours ago", "3 days ago", "8 months" ago, "1 year ago" and so on.
  • default - The default option uses other options to determine how to display the date and time. See: datetime.date.format, datetime.date.pretty, datetime.time.format

The default value is default.


datetime.time.format (string)

The time format can be AM/PM format with or without the 'am' or 'pm' appended to the time, or it can be in 24 hour format. The default is the AM/PM format with the text.


logs.file.enabled (bool)

Owl can generate logs to help with debugging problems. If true then log messages will be written to an owl.log file inside the directory defined by logs.file.path. If false, log messages will only be written to STDOUT. This is false by default.


logs.file.path (string)

The location of the owl.log file when logs.file.enabled is true. This is empty by default.


logs.level (enum)

The log level is the verbosity of the logging. For more information about logging levels see the log4j documentation. By default this is set to Off.


navigation.thread.newposts (enum)

When the user clicks on a thread that contains new posts, this setting will define where Owl scrolls when the thread is loaded. The possible three settings are:

  • new - the first unread post
  • first - the first post in the thread
  • last - the last post in the thread

The default value is new.


navigation.thread.nonewposts (enum)

This defines where Owl scrolls when there are no unread posts in the thread. The two valid values are:

  • first - the first post in the thread
  • last - the last post in the thread

The default value is last.


Thread Panel Options

threadlist.avatars.visible (bool)

Controls the visibility of user avatars in the thread panel. Default is true.

threadlist.lastauthor.visible (bool)

Controls the visibility of the last author information. The default is true.

threadlist.previewtext.visible (bool)

Controls the visibility of the preview text. The default is true.


version (string) [readonly]

The current version of Owl.

Note: This is updated automatically by Owl with each upgrade and should not be manually changed.