Technical Information

We’re still working on our official documentation, but here are a few points of interest if you’d like to get your "hands dirty" with Orion's advanced features.

Web Extension API support

Orion support for Web Extensions API is still experimental. You can find a list of currently supported APIs here.

To debug extension issues, follow the troubleshooting guide.

Orion iOS/iPadOS

How do I open Orion iOS from my app?

orion://open-url?url=url to open an URL
orion://search?q=query to perform search

Orion macOS

Location of Open Tabs

~/Library/Application\ Support/Orion/Defaults/browser_state.plist 

Location of Bookmarks

~/Library/Application\ Support/Orion/Defaults/favourites.plist 

Location of History

~/Library/Application\ Support/Orion/Defaults/history

Location of Orion Settings

~/Library/Preferences/com.kagi.kagimacOS.plist 

Location of Profiles

~/Library/Application Support/Orion/profiles (plist format)

Location of Snapshots

~/Library/Application Support/Orion/snapshots/snapshots.plist

Installed Extensions

cd ~/Library/Application\ Support/Orion/Defaults/Extensions 

Orion's WebKit Cache

cd ~/Library/WebKit/com.kagi.kagimacOS 

Orion's App Cache

cd ~/Library/Caches/com.kagi.kagimacOS 

Delete Single Preferences

defaults delete com.kagi.kagimacOS NewTabOpensTo
defaults delete com.kagi.kagimacOS NewWindowOpensTo
defaults delete com.kagi.kagimacOS HomePageURL 

Reset Orion Preferences/Bookmarks/History/Extensions

rm -rf ~/Library/Application\ Support/Orion
defaults delete com.kagi.kagimacOS 

Remove Cookies

rm -rf ~/Library/HTTPStorages/com.kagi.kagimacOS.binarycookies 

Backup Bookmarks to your user folder

cp ~/Library/Application\ Support/Orion/Defaults/favourites.plist ~/ 

Copy Orion settings from one Mac to another

Copy ~/Library/Preferences/com.kagi.kagimacOS.plist to the same location on another Mac.

Parse Reading List as json and print all URLs

plutil -convert json -o - ~/Library/Application\ Support/Orion/Defaults/reading_list.plist | jq -r '.[].url.relative'

Start Orion without any extensions active

Rename ~/Library/Application Support/Orion/Defaults/Extensions directory before launch. And after that rename this directory to Extensions again to have them back.

Orion's history is an sqllite database. Here's a simple snippet to get you started

sqlite3 ~/Library/Application\ Support/Orion/Defaults/history 'SELECT url FROM history_items INNER JOIN visits ON visits.history_item_id = history_items.id GROUP BY url ORDER BY count(visits.visit_time) DESC LIMIT 10' 

And here's a one-liner that will let you fuzzy search your history using fzf

sqlite3 ~/Library/Application\ Support/Orion/Defaults/history 'SELECT DISTINCT url FROM history_items' | fzf --ansi --multi | sed 's#.*\(https*://\)#\1#' | xargs open

Syncing settings to Orion RC (Release Candidate)

If you are just getting started with Orion RC and would like to copy over your settings/configuration, you can use this command:

cp -r ~/Library/Application\ Support/Orion ~/Library/Application\ Support/Orion\ RC