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