Features overview

Interface

Hover your mouse on the background credits to see exif infos

Show all settings

Bonjourr has lots of options. In an attempt to not be jarring for newcomers, we decided to hide most of them by default. If you're an advanced user, you can enable all those options by toggling Show all settings at the very top of the settings menu.

New tab title

You can customize the text and icon (called favicon) displayed by your browser when for each new tabs created. Text is limited to 80 characters, and icons can only be emojis for now.

Here is how to write emojis depending on your system:

Windows: WIN + . (windows key + dot)
MacOS: CTRL + CMD + Space
Everyone else: unicode.org/emoji/charts/full-emoji-list

Hide settings icon

When selecting the Hide settings icon, the icon is still clickable at the same position as before. You can also open the settings menu by pressing the Escape key.

Backgrounds

Bonjourr uses the Unsplash API to fetch its backgrounds. We select them manually and store them in four different collections that change according to the time of the day:

During the day or at night
2 hours around sunrise (Noon) or sunset (Evening)

Custom Unsplash collection

You can make your own collection of images using Unsplash. To do so, you'll need to create an Unsplash account and add all your images to a new collection. Once you're pleased with your selection, you need the collection's ID present in its URL. You will spot it easily since it's the string of random letters and numbers. For example, if your collection's URL is https://unsplash.com/collections/2170139/wolfdogs-of-unsplash, the ID is 2170139.

Head back to Bonjourr and paste the ID in the Unsplash collection field. You can add multiple collections by separating them with a comma.

Local files

Switch your Background type from "Unsplash" to "Local file", and you'll be able to drag and drop your own images from your computer to Bonjourr.

Time and date

The analog clock background is blurred when its opacity is above 0.

World clocks

World clocks allows you to add multiple clocks with different timezones. Removing the name of a world clock will remove the clock entirely.

Weather

Precise geolocation needs access to your device's GPS. Some browsers or systems might not allow access based on its privacy setting. MacOS / Safari often causes problems.

If there are multiple cities with the same name in your country, it might cause an issue. A good trick to fix the issue is to choose the name of the closest city with a unique name.

Until we add a "refresh weather" option, you can refresh the weather by toggling the weather Unit. Celsius -> Farenheit -> Celsius.

Detailed weather

Detailed weather allows you to easily go to a weather provider's website to get a detailed weather report. Click on the weather widget to go to your choice of provider.

⚠️ We are in no way affiliated with MSN, Accuweather, Yahoo!, or Windy.com. These websites offers reports with different data provider, hence the choice.

Quick Links

You can add and import Quick Links from the settings, and edit them when you right click on them.

An easy way to add a custom icon to your Quick Link is to upload it on somewhere like Imgur, and use that link as an icon. You can also convert your icon to a Data URI (max 8kB).

⚠️ Notice: as a security measure, local paths like file://, browser settings links like about:config or chrome://extensions can't be added. However, localhost: links will work just fine.

Icons

Link icons are retrieved by our homemade service favicon-fetcher. If you find that a website is missing its icon, you can create an issue on our service and it will be fixed.

You can change a link icon by right clicking on a link to open its menu, and adding a valid URL in the Icon input. It can be a:

Distant URL: https://en.wikipedia.org/favicon.ico
Locally hosted URL: http://127.0.0.1:4321/favicon.ico
DataURI smaller than 8kb: data:image/gif;base64,R0lGOD...AA7

But not a:

File path: file:///Users/Me/Pictures/flowers.png

Cache policy

Icons from favicon-fetcher are stored in the browser cache for a year. As long as the browser cache is not cleared, icons are not fetched (or updated) by the page. However, if the browser cache is often cleared or storage space is limited on your device, icons will have to be fetched from our service.

Icons you add manually from a distant URL will have a different cache policy, which might cause the icon to be fetched often or even every time.

Link folders

Links folders are pretty cool. You can drag and drop them. Dragging a folder on another will add the content of the dragged folder in the target. Deleting a folder with links inside will also delete those links.

Link groups

You can organize your links even more with link groups. To add a page, right click next to the default page. You cannot remove the default page but you can rename it. Deleting a page will remove the links inside.

You can pin groups by selecting Pin this group after opening the context menu from the group title.

Search bar

When enabling the custom search engine option, the searchbar becomes compatible with all search engines, which includes things like YouTube: https://www.youtube.com/results?search_query=%s.

Notes

Notes uses Markdown to create titles, lists, and checkboxes. To transform a line, just add these characters at the start of a line:

# big heading
## medium heading
### small heading
- classic list
[ ] checkbox
[x] checkbox, checked

Other Markdown features, like italics, are not available currently.

Keybindings

Keys	Action
Ctrl + Shift + 1	To big heading
Ctrl + Shift + 2	To medium heading
Ctrl + Shift + 3	To small heading
Ctrl + Shift + 4	To bullet list
Ctrl + Shift + 5	To todo list

Fonts

Bonjourr gets its fonts from Fontsource. If you want to see previews of the fonts Bonjourr offers, please visit fontsource.com.

Page layouts

There are 3 different page layouts to choose from: single, double and triple column. Each layout saves the position and alignment of your widgets independently.

These options only affect the current layout:

Widget toggle (Enable switches)
All options in grid toolbox
Reset layout

Github Gist

You can save your Bonjourr config in the cloud using Github Gist by selecting "Github Gist" in the Synchronization type option. Two more options appear:

Authentification token	Where you can add your Personal Access Token. It should look like this: `github_pat_oxoxo...`
Github Gist	To manually sync your config to your Gist account with Get and Send. These buttons only work after detecting a valid token.

You can create a Personal Access Token by following this guide on docs.github.com, or following the steps shown below:

Bonjourr is not affiliated with Github, and no connections to api.github.com are made until you select this sync type AND add a valid token. More details on our privacy page.

Settings management

Bonjourr allows you to export all your settings into a file. You can use this feature if you want to save them or share them to someone. You will in turn be able to import said settings into any instance of Bonjourr.

To do so, simply go to the bottom of your settings pannel, then click Export as file in the settings management. Your file will be downloaded. On your other instance of Bonjourr, you can then go to the Import tab of the settings management and drop your file. Bonjourr will reload and all your settings will be applied.

Browser syncing

Bonjourr is compatible with the automatic syncing features of both Firefox and Chrome. If you log into your Mozilla/Google account on your browser and have syncing enabled in your browser, Bonjourr should get synced to other instances of the same browser on other computers. This is true for all Bonjourr settings as well as Quick Links.

Keybindings

Keys	Action
Escape	Opens / closes settings
E (focused on link)	Edits links

Notes

You can use these keyboard shortcuts while editing your Note. Replace `Ctrl` by `Cmd` on macOS.

Keys	Action
Ctrl + Shift + 1	To big heading
Ctrl + Shift + 2	To medium heading
Ctrl + Shift + 3	To small heading
Ctrl + Shift + 4	To bullet list
Ctrl + Shift + 5	To todo list