Settings reference

Bonjourr's settings are stored in JSON formatting, which you can see in the settings management section. Use this page to know which JSON property refers to what. Last updated for version 20.2.2

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
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
},
}

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
}
}