Need clarification on something? Then check out these user guides, or ask your question.

Navigating to pages using the "addressbar"

In the center of Odysseus’s toolbars is it’s “addressbar”. Using it you can see what webpage you’re on, see how much of it has downloaded, and specify a new page to visit.


To save or edit a bookmark for the current page, click the star (or filled star) icon in the toolbar. If it’s filled that indicates the page has already been bookmarked.

Web browsing

At the top of every Odysseus window is the “toolbar”. These contain controls to manipulate the page your currently viewing, and to navigate to other pages. They also contain the window controls standard to your desktop, which will be otherwise ignored in this guide.

How can I contribute?

There are several things you can do to help make Odysseus even more awesome. You do not need to be a software developer to do so.

Downloading files on the Web

If you follow a link that isn’t to a (HTML) webpage it will be “downloaded” to your computer. You can also manually tell Odysseus to download a link using a right-click menu, as can the webpage.

Installing web extensions

You may install executable files written in a range of programming languages (including the web’s own JavaScript) to ~/.config/com.github.alcinnz.odysseus/extensions/ for them to be ran on every webpage viewed through Odysseus inside their sandbox. For more information on creating these extensions, see WebKitGTK’s guide.

Find in page

When you press ctrlF or select “Find In Page” from the application menu, a small secondary toolbar will appear on the topright of the visible webpage. This secondary toolbar consists mostly of a single text entry and can be used to find all occurances of some given text on the current webpage.

Odysseus browser history

All pages you’ve visited are accessible at odysseus:history, which is linked to from the newtab page and the gear menu. It can also be accessed using ctrlH. That page lists your browser history from the time you’ve updated to version 1.1.0 in reverse chronological order, whilst highlighting changes in hours, days, months, and years to make it easier to skim.

Odysseus Keyboard Shortcuts

ctrl, Navigate tab history backwards.
ctrl. Navigate tab history forwards.
ctrlQ Stop loading focused page.
ctrlR Reload focused page.
ctrlSHIFTR Reload focused page without reusing previously downloaded resources.
ctrlT Open a new tab in this window.
ctrlL Edit web address/go to new page/search [DuckDuckGo](https://ddg.gg/).
ctrlN Open a new window.
ctrlO Open a file from your harddrive. Prompts you to select which one.
ctrlS Save this webpage to your harddrive as an MHTML file.
ctrlU View the syntax-highlighted source code for the selected page.
ctrl+ | ctrl= Zoom in on this page.
ctrl- Zoom out on this page.
ctrl0 Restore normal zoom level.
ctrlF Find occurances of some text on this page. Presents a text entry where you can enter which text should be searched for.
esc Hide the controls shown by ctrlF.
ctrlP Send this page to a connected printer, so you can read it on physical paper.
ctrl? Open the Odysseus Guide (this site).
ctrlclick | middle click Open link in new tab.
middle button drag Alternative scrolling gesture, appropriate for longer pages.

Set as default browser

To set Odysseus as your default browser:

Homepage links

You open new tabs to go somewhere, so Odysseus provides links to pages it thinks you’re most likely to go to. Specifically it links to: