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.

Bookmarking

To save or edit a bookmark for the current page, click the (or ) 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 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).
`ctrl`click \| 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: