Settings reference

Last updated for version 19.2.5

General

{
showall: false, // Show all available settings in menu
lang: '', // Sets interface and settings menu language
dark: 'system', // enabled | disabled | auto | system
favicon: '', // An emoji
tabtitle: '', // Max 80 characters
greeting: '', // Max 24 characters
pagegap: 1, // Gap between widgets, from 0 to 8
pagewidth: 1600, // In pixel, from 600 to 2200
time: true, // toggles clock & date widget
main: true, // toggles weather & greetings widget
dateformat: 'eu', // auto | us | eu | cn
quicklinks: true, // toggles quicklinks widget
syncbookmarks: undefined, // <!> soon deprecated
textShadow: 0.2, // Interface text shadow, from 0 to 1
announcements: 'major', // all | major | none
review: 0, // Shows review popup at 30, -1 to disable
css: '', // User generated CSS
}

Backgrounds

Select your background provider, blur amount, and brightness

{
background_blur: 15, // In pixels
background_bright: 0.8, // Brightness from 0 to 1
background_type: 'unsplash', // unsplash | local
}

Unsplash

Paused frequency syncs the URL of the background in pausedImage

{
unsplash: {
every: 'hour', // background change frequency: tabs | hour | daylight | day | pause
collection: '', // User selected collection: comma-separated ids
lastCollec: 'day', // night | noon | day | evening | user
pausedImage: undefined, // Saved image when selecting "pause" frequency
time: undefined, // timestamp, set to 0 to change background
}
}

Clock

{
clock: {
size: 1, // Analog clock size
ampm: false, // 12 or 24 hours
analog: false, // Toggle analog or digital
seconds: false, // Toggle seconds
face: 'none', // none | numbers | roman | marks
style: 'round', // ??
timezone: 'auto', // auto | -12 | -11 | ... | +12
}
analogstyle: {
face: 'none', // 'none' | 'number' | 'roman' | 'marks' | 'swiss' | 'braun'
hands: 'modern', // 'modern' | 'swiss' | 'classic' | 'braun' | 'apple'
shape: 'round', // 'round' | 'square' | 'rectangle'
border: '#ffff', // Any valid CSS color
background: '#fff2', // Any valid CSS color
},
}

Links

General settings for quick links.

{
linkstyle: 'large', // large | medium | small | inline | text
linknewtab: false, // open in new tab
linksrow: 6, // From 1 to 16
linkgroups: {
on: false, // true | false
selected: '', // Selected group
groups: [''], // List of groups. Groups are unique titles.
pinned: [], // Groups pinned to interface
synced: [], // Synchronised groups, handled by the browser
},
}

When adding a quick link

{
[link._id]: {
_id: '' // "links" + 6 random characters
parent: '' // A group or folder id
order: 0 // Link position on interface
title: '' // Max 64 characters
url: '' // Max 256 characters
icon?: '' // Valid URL or dataURI
}
}

Notes, Search bar, and Quotes

These widgets behave pretty similarly: basic key-val.

{
notes: {
on: false, // Toggle widget
width: 40, // Container width in "em"
opacity: 0.1, // From 0 to 1
align: 'left', // left | center | right
},
searchbar: {
on: false, // Toggle widget
opacity: 0.1, // From 0 to 1
newtab: false, // Open in new tab
suggestions: true, // Toggle suggestions
engine: 'default', // default | google | bing | ddg | yahoo | qwant | ... | custom
request: '', // A valid search URL with its query parameter set to "%s"
placeholder: '', // Max 64 characters
},
quotes: {
on: false, // Toggle widget
author: false, // Toggle author
type: 'classic', // classic | inspirobot | kaamelott | custom | URL
frequency: 'day', // tabs | hour | daylight | day | pause
last: 1650516688, // Set to 0 to change quotes
},
}

Fonts

Most fields in fonts are set automatically by Bonjourr and cannot easily be modified manually.

{
font: {
family: '', // Fontsource font family
size: '14', // Interface size in 'px'
system: true, // Specify if font is from the device
weightlist: [], // Available font weights
weight: '400', // Interface font weight
}
}

Weather

{
weather: {
ccode: undefined, // Valid country code
city: undefined, // Any city name
unit: 'metric', // metric | imperial
provider: '', // Custom 'moreinfo' weather provider
moreinfo: 'none', // none | msnw | yhw | windy | custom
forecast: 'auto', // auto | always | never
temperature: 'actual', // actual | feelslike | both
geolocation: 'approximate', // approximate | precise | off
}
}

Hide

Specify which element on the page you want to hide.

{
hide: {
clock: false // true | false
date: false // true | false
greetings: false // true | false
weatherdesc: false // true | false
weathericon: false // true | false
settingsicon: false // true | false
}
}

Page layout

Page layouts are pretty complex. Grids are tables, items are widget alignments.

{
move: {
selection: 'single', // single | double | triple
layouts: {
single: {
grid: grid, // single column grid
items: items, // items aligment
},
double: {
grid: grid, // double column grid
items: items, // items aligment
},
triple: {
grid: grid, // triple column grid
items: items, // items aligment
}
}
}
}
// single
grid: [
['time'],
['main'],
['quicklinks']
],
// double
grid: [
['time', '.'],
['main', '.'],
['quicklinks', '.'],
],
// triple
grid: [
['.', 'time', '.'],
['.', 'main', '.'],
['.', 'quicklinks', '.'],
]
items: {
[widget]: {
box: '', // "baseline | center | end", "baseline | center | end"
text: '', // left | center | right
}
}