Welcome to the Orion User Guide!

Orion is a free, lightning-fast, privacy-protecting browser for Apple users, open to the web and all its standards and protocols. One day, we hope everyone will say Orion is the best browser for all Apple devices. We're glad you're here!

Please note that Orion Docs are in beta and thus are not yet complete. We haven't documented all of Orion's amazing features yet. But, we will be adding more documentation here over time.

If you're new to Orion, our Quick Start and FAQ are great places to begin.

You can access our documentation in several ways:

• Click or tap an article link from the list.
• Click or tap the magnifying glass icon at the top of the screen and do a search.
• Use the !orion bang in Kagi Search. For example, searching in Kagi for !orion setting default search engine will show you results containing our documentation on how to set Orion's default search engine.

Feedback about this Orion documentation can be shared on our Discord Server in the #documentation channel. We would love to hear your thoughts on anything we can fix or improve.

Contributing

This documentation is open source at our Kagi Docs repo.

We gladly welcome any fixes & improvements! Please see our contribution guide before making a Pull Request.

Once your contributions are accepted, make sure to add yourself to the list of Contributors. Thank you!

About

Kagi Inc. is a company created with the mission to humanize the web. Our goal is to amplify the web of human knowledge, creativity, and self-expression.

Kagi was founded in 2018 by Vladimir Prelovac in Palo Alto, CA (USA). Kagi's advisory board consists of Raghu Murthi and Dr. Norman Winarsky. Our team is a fully remote team operating on all continents.

Kagi has been completely self-funded since its inception.

Kagi Inc. currently has two products: Kagi Search, a fast, private search engine, and Orion Browser, a fast, zero-telemetry browser.

Our company headquarters are in Palo Alto, CA.

Contact:

Kagi Inc.
Palo Alto, CA, USA
Email: vlad@kagi.com
Phone: 650 535-2700

We hope that our work impacts people's lives in some small way for the better. Thank you for your interest in being a part of this!

"With Kagi and Orion, we’re striving to build better ways to experience the web, ways that are safe yet fun for everyone, including my own kids."

—Vladimir Prelovac

About

Kagi Inc. is a company created with the mission to humanize the web. Our goal is to amplify the web of human knowledge, creativity, and self-expression.

Kagi was founded in 2018 by Vladimir Prelovac in Palo Alto, CA (USA). Kagi's advisory board consists of Raghu Murthi and Dr. Norman Winarsky. Our team is a fully remote team operating on all continents.

Kagi has been completely self-funded since its inception.

Kagi Inc. currently has two products: Kagi Search, a fast, private search engine, and Orion Browser, a fast, zero-telemetry browser.

Our company headquarters are in Palo Alto, CA.

Contact:

Kagi Inc.
Palo Alto, CA, USA
Email: vlad@kagi.com
Phone: 650 535-2700

We hope that our work impacts people's lives in some small way for the better. Thank you for your interest in being a part of this!

"With Kagi and Orion, we’re striving to build better ways to experience the web, ways that are safe yet fun for everyone, including my own kids."

—Vladimir Prelovac

Products

Kagi Inc. is currently a maker of two user-centric, privacy-respecting, common-sense obliging products.

Kagi Search

Kagi Search is a fast, user-centric and private web search engine with great results.

Visit Kagi Search documentation.

Orion Browser

Orion Browser is a fast, user-centric, zero-telemetry web browser (currently macOS/iOS only).

Visit Orion Browser documentation.

History

Kagi was founded by Vladimir Prelovac in May 2018 in Palo Alto, CA (USA). Kagi is completely self-funded since its inception.

We are not affiliated with the legendary Kagi - the shareware payments platform. That Kagi went bankrupt in an unfortunate turn of events. We liked the name and acquired it when we got the chance.

Early years

In the first couple of years (2018 - 2019) Kagi was focused on AI technology, driven by the notion that any future search engine will need to have a strong instant question-answering component. We called it "the last mile of search" and this project gave us the domain knowledge and expertise used in Kagi Search today. Other experiments like video question answering were built during this period.

In 2019 the first prototype of Kagi Search is made public. It used an unusual MUD-like, command-line mode with powerful features built in.

First prototype of Orion browser with support for web extensions on iOS is made, giving us 'wings' to continue building the future best browser on Apple devices.

Timeline

2018 (The Age of AI)

• Work begins on Kagi.ai
• Team size: ~3

2019 (First products)

• First prototype of Kagi Search
• Donna.gg is launched using Kagi's early technology
• Work begins on Orion Browser
• Team size: ~5

2020-2021 (COVID years)

• All blurred out. We worked a lot. The private beta of Kagi Search and Orion Browser launched
• Team size: ~10

2022 (Public beta and paid customers)

• Kagi Inc. incorporated
• Kagi search and Orion browser enter the public beta
• Three months later, thousands of people are paying for Kagi and Orion
• The team is now ~15

What Does "Kagi" Mean?

The word "kagi" means "key" in Japanese.

Kagi is pronounced as kah-gee. You can listen to the pronunciation.

Who is Kagi's Mascot?

We simply call him ”Doggo” for now. He's adorable!

Kagi Search Logo

More Kagi assets are available on the Kagi Assets page.

People sometimes ask why does Kagi have a "g" logo in the Google ballpark rather than a "k"?

Our designer insisted the Kagi logo is "anchored" in the letter "g," and we had to agree. Besides, we can't let Google own the letter "g" too, can we? ;)

Orion Browser Logo

More Orion assets are available on the Orion Press Kit page.

Resources & Brand Assets

You can go to the Kagi Assets webpage to access our resources and brand assets.

They include:

• The Orion web browser
• Browser extensions for Kagi Search
• Search and Autocomplete URLs for Kagi Search
• Variants of our "g" logo
• Typography
• Brand Colors
• Variants of Doggo the Kagi Mascot

Orion Browser

Orion browser has a press kit page with additional assets such as the logo and screenshots.

Work on Kagi Search

• Do you have advanced Crystal language knowledge?
• Can you solve difficult problems and code exceptionally well? (We’ll send a test project.)
• Do you want to be a part of international and fully-remote team building products with care?

Help create the best search engine in the world.

• Full-time or part-time (hourly rate) possible.
• Flexible work conditions, remote work OK.
• Early startup equity is available.

If so, send your CV to vlad@kagi.com.

Fun fact: All of Kagi Search works without JavaScript enabled in the browser. We see JavaScript as a way to enhance the product experience, not create it.

Work on Kagi Search

• Do you have advanced Crystal language knowledge?
• Can you solve difficult problems and code exceptionally well? (We’ll send a test project.)
• Do you want to be a part of international and fully-remote team building products with care?

Help create the best search engine in the world.

• Full-time or part-time (hourly rate) possible.
• Flexible work conditions, remote work OK.
• Early startup equity is available.

If so, send your CV to vlad@kagi.com.

Fun fact: All of Kagi Search works without JavaScript enabled in the browser. We see JavaScript as a way to enhance the product experience, not create it.

Work on Orion Browser

Requirements:

• Swifth experience (3+ years) with macOS or iOS

Roles:

• UI/UX developer: You have experience with macOS or iOS UX/UI components (AppKit/UIKit) and love creating native apps with great user interactions
• Backend developer - You can write code in Swift but also delve into WebKit (C++) if needed
• Extension support developer - You can help extend our WebExtensions API support by combining JavaScript, Swift (and occasionaly WebKit if needed)

We are hiring macOS and iOS developers for the Orion browser team. Create the best browser on Apple devices with us.

• Full-time or part-time (hourly rate) possible.
• Flexible work conditions, remote work OK.
• Early startup equity is available.

Send your CV to vlad@kagi.com and we will send a test project.

We are particularly keen on hiring in Japan, the land of amazing WebKit browser heritage (Shiira, Sleipnir...)

様々なブラウザの歴史を持つ日本の皆さんこんにちは！

Kagi Inc. がお届けする Orion ブラウザは、世界最新の macOS/iOS 用ブラウザです。 https://browser.kagi.com/ 私たちの目指す「Apple デバイス用の最高のブラウザ」を一緒に作りましょう。

ポジション: macOS または iOS 開発者 (Orion browser を製作するチームです)

必須スキル: Swift, JavaScript and/or C++ AppKit or UIKit に精通しており、難しい問題を解決できる

採用フロー:

1. CVの送付（英語にてご製作下さい）
2. 弊社よりテスト用のプロジェクト (in AppKit or UIKit) を送付します
3. ビデオ面接

雇用形態:

• フルタイム、またはパートタイム（1時間単位での換算）
• フルリモート
• ストックオプションも選択可能です

なお、下記について予めご了承下さい:

• 現在、日本に支社はございません。
• 候補者様とのやりとり、面接、コミュニケーションなどにおいて使用される言語は英語のみとなります。

Donations

Kagi pledges to contribute 5% of our profits to the following organizations that align with our mission of humanizing the web:

• Children beyond brands (Fairplay)
• European Center for Digital Rights (NOYB)
• Electronic Privacy Information Center (EPIC)
• Fight for the Future
• The Markup

Until we reach profitability, we are making a small monthly donation to the following projects:

• Crystal language
• Python language

Contact Us

• For customer support, use support@kagi.com
• For all other inquiries, use vlad@kagi.com

Support & Community

Get assistance, help shape the future of Orion and maybe even contribute!

Roadmap

Our community drives the future product direction of Kagi Search, and we hope you will become a part of it. Check out our roadmap.

Release notes & RSS

HTML version of release notes is available for Orion macOS at: browser.kagi.com/updates/orion-release-notes.html

For Orion iOS/iPadOS at: browser.kagi.com/updates/orion-iOS-release-notes.html

RSS feed for (joint) release notes is available at: orionfeedback.org/atom/t/release-notes

Forum

You can join OrionFeedback.org to see the bug reports and feature requests we are discussing, reviewing, and planning to address and to the discussion.

• Please see our Bug Reporting Guide for instructions on reporting issues.
• All bugs and feature requests are encouraged to be posted on the forum.

Discord

In addition, you can also join our Discord! for real-time discussion about the product and chat with other Orion users.

Email support

Feel free to email us for support.

Support & Community

Get assistance, help shape the future of Orion and maybe even contribute!

Roadmap

Our community drives the future product direction of Kagi Search, and we hope you will become a part of it. Check out our roadmap.

Release notes & RSS

HTML version of release notes is available for Orion macOS at: browser.kagi.com/updates/orion-release-notes.html

For Orion iOS/iPadOS at: browser.kagi.com/updates/orion-iOS-release-notes.html

RSS feed for (joint) release notes is available at: orionfeedback.org/atom/t/release-notes

Forum

You can join OrionFeedback.org to see the bug reports and feature requests we are discussing, reviewing, and planning to address and to the discussion.

• Please see our Bug Reporting Guide for instructions on reporting issues.
• All bugs and feature requests are encouraged to be posted on the forum.

Discord

In addition, you can also join our Discord! for real-time discussion about the product and chat with other Orion users.

Email support

Feel free to email us for support.

Orion is in Public Beta

While Orion is in public beta, we don't feel our vision is fully realized and ready for prime time. But we also don't want to build something in isolation. We want to build it with you, our users. We appreciate your support and patience as Orion evolves.

During this time, we plan to fix bugs, introduce more core features, and improve the stability of the product. We hope to have v1.0 ready some time in 2023.

You can read more about this in our public beta announcement post.

Supported OS Versions

We believe in the concept of "timeless computing," meaning that software should be built to last and new software should be mindful of older operating systems.

We try to maintain support for older operating systems whenever possible, while balancing the need to support newer OS versions.

macOS

We currently support these versions of macOS:

• 10.14 (Mojave)
• 10.15 (Catalina)
• 11 (Big Sur)
• 12 (Monterey)
• 13 (Ventura)

We plan to add support for 10.13 (High Sierra) in the future.

Intel and Arm64 optimizations will automatically activate on your first run of Orion.

iOS and iPadOS

We currently support iOS and iPadOS 13.0 and later.

Product Roadmap & Feedback Forum

You can view our Orion Product Roadmap to see the bug reports and feature requests we are discussing, reviewing, and planning to address.

The Roadmap is part of our Orion feedback forum, where you are welcome to submit bug reports and feature requests of your own. Our community drives the future product direction of Orion and we hope you will become a part of it.

When reporting a bug, please give us as much detail as possible. This will help us understand the problem. Include information such as:

• Steps to reproduce the problem
• Screenshots of what you are seeing
• Operating system and version
• Orion version
• Any browser extensions you are running and their versions
• Any error messages from the console of your web browser

Reporting a Bug

When reporting a bug, it is important to give us as much information as possible to help narrow down what the issue may be. Browsers are very complex pieces of software—every detail matters!

Whenever you open a bug report, you will be given a template that you can fill out that will help you write your report. Here is a breakdown of what is included, and how it helps us!

Describe Your Issue

1. Steps to reproduce. This is the most important piece of information for any bug report. lease include a clear list of instructions to reproduce the issue, even if you think it may be obvious. If we can not reproduce the problem, we are not able to fix it.

Important note: Most likely cause of problems on web pages is Content blocking and Web extension. You can rule out both quickly by enabling Compatibilty mode.

The second most likely cause of issues is WebKit, Orion's rendering engine. This is why we will ask you to check if the same problems exists in Safari browser. If it does it is most likely caused be WebKit and this can be more difficult for us to fix. In this case, you are encouraged to submit a bug report to WebKit.

Important note: You can also check if the issue is present using Safari Technology Preview if this available and applicable to you.

2. Expected behavior - What did you expect will happen? Indicating how other browsers behave may be useful. Use a screenshot/video to make your point if needed.

3. A screenshot or video of the issue. Very often, this is the best way to help us understand your issue. A picture really is worth a thousand words when it comes to bug reports!

Give Us Some Context

1. Orion, OS version; hardware type. What is the version of Orion, your system and what hardware you are running. You can copy this from Orion -> About menu if unsure. There is a lot of debug information available in Help -> Copy Debug Info to Clipboard that can be useful to us.

2. Image/Video. It is always helpful to upload images/videos. Our site will aloow dragging and dropping files as you write.

Things to Try

Sometimes there are a few things you can do to help us narrow down certain issues. Depending on the problem, you can try:

• Turn on Compatibilty mode
• Disabling all browser extensions
• Restarting Orion

Common Questions

My report includes NSFW media

Please don't post explicit images, videos, or text directly on the site.

If you can, please censor the images. Otherwise, you can leave them out. If we need them, we will ask you to provide them another way.

I just have a question or want to chat with other Orion users!

If you are just looking to chat or need some help, you are welcome to join our Discord server).

Discord Server

We have an Orion Discord server where you can provide general feedback and directly communicate with our community.

Please use the #introduce-yourself channel to say hello and let everyone know a bit about you.

We'd also love to hear your initial thoughts about Orion on the #first-impressions channel.

To make specific feature requests or bug reports, please use our Orion feedback forum rather than Discord.

Email Support

You can email support@kagi.com for customer support.

Before emailing, please see if your issue has been addressed on this knowledge base or our Orion feedback forum.

Keyboard Shortcuts

Orion for macOS uses OS-level keyboard shortcuts. You may wish to change certain shortcuts from their defaults. You may also find other apps have shortcuts that conflict with Orion's defaults. You can change the keyboard shortcuts for Orion or other apps based on your specific needs.

To change your shortcuts in macOS:

1. Click the Apple menu () and click System Preferences.
2. Click Keyboard.
3. Click the Shortcuts tab.
4. Click App Shortcuts in the list of options.

Apple provides more detailed information about creating keyboard shortcuts and resolving shortcut conflicts.

Feedback

Forum

You can join OrionFeedback.org to see the bug reports and feature requests we are discussing, reviewing, and planning to address and to the discussion.

• Please see our Bug Reporting Guide for instructions on reporting issues.
• All bugs and feature requests are encouraged to be posted on the forum.

Discord

In addition, you can also join our Discord! for real-time discussion about the product and chat with other Orion users.

Feedback

Forum

You can join OrionFeedback.org to see the bug reports and feature requests we are discussing, reviewing, and planning to address and to the discussion.

• Please see our Bug Reporting Guide for instructions on reporting issues.
• All bugs and feature requests are encouraged to be posted on the forum.

Discord

In addition, you can also join our Discord! for real-time discussion about the product and chat with other Orion users.

Documentation

The Orion user community is a diverse and passionate group of people who help make Orion better.

Every page in this documentation is editable. Click on the "Edit" icon in the top of the page to edit it and submit for review.

This requires a Github account as this documentation is open-source and hosted on Github. The repository with full instructions is here.

Translations

Community members help Orion with translation support thereby making Orion globally accessible.

If you are interested in helping us sign up at https://localazy.com/p/orion-browser

Select the language(s) or let us know what language we should add.

Remember it is a marathon and not a sprint, steady translation progress helps us humanize the web.

As a token of appreciation for helping us make Orion more international we will be awarding Kagi Premium to select contributors.

We would like to say a big thank you to everyone who has contributed so far!

Quick Start

Table of Contents

• Installing Orion
• Website Settings
• Vertical Tabs
• Reader Mode
• Quick Searches
• Web Archives
• Video Picture-in-Picture
• Focus Mode
• Edit Text on a Page
• Show Console Errors

Installing Orion

You can download an installer for Orion for macOS and install Orion for iOS/iPadOS from the App Store.

Orion is free and no account or signup is required to use it.

Website Settings

You're in control of your privacy and security with Orion. Click the gear icon at the top of an Orion for macOS window to access the Website Settings for the current webpage.

Vertical Tabs

If you love to have your browser tabs on the side, Orion has you covered with native vertical tabs support.

Reader Mode

Bring peace to a cluttered webpage with Reader Mode.

Quick Searches

Get right to the content you're looking for by using Quick Searches that directly search your favorite websites.

Web Archives

If a webpage won't load in Orion for macOS or you want to see an earlier version of it, you can see if the page is available in a Web Archive.

Here's an example of kagi.com's previous life when our domain was used by a payment processor:

Video Picture-in-Picture

When playing a video in Orion for macOS, you can view it in Picture-in-Picture mode.

Focus Mode

Focus Mode allows you to completely remove toolbars from your browser interface. Browse the web distraction-free!

Edit Text on a Page

Sometimes you may want to quickly edit text on a page so you can take that perfect screenshot. Orion for macOS makes this possible.

Show Console Errors

Web developers, we got you! You can add an indicator to the address bar of Orion for macOS that shows the number of errors on the page. This error indicator will allow you to quickly open Console and inspect the errors.

Quick Start

Table of Contents

• Installing Orion
• Website Settings
• Vertical Tabs
• Reader Mode
• Quick Searches
• Web Archives
• Video Picture-in-Picture
• Focus Mode
• Edit Text on a Page
• Show Console Errors

Installing Orion

You can download an installer for Orion for macOS and install Orion for iOS/iPadOS from the App Store.

Orion is free and no account or signup is required to use it.

Website Settings

You're in control of your privacy and security with Orion. Click the gear icon at the top of an Orion for macOS window to access the Website Settings for the current webpage.

Vertical Tabs

If you love to have your browser tabs on the side, Orion has you covered with native vertical tabs support.

Reader Mode

Bring peace to a cluttered webpage with Reader Mode.

Quick Searches

Get right to the content you're looking for by using Quick Searches that directly search your favorite websites.

Web Archives

If a webpage won't load in Orion for macOS or you want to see an earlier version of it, you can see if the page is available in a Web Archive.

Here's an example of kagi.com's previous life when our domain was used by a payment processor:

Video Picture-in-Picture

When playing a video in Orion for macOS, you can view it in Picture-in-Picture mode.

Focus Mode

Focus Mode allows you to completely remove toolbars from your browser interface. Browse the web distraction-free!

Edit Text on a Page

Sometimes you may want to quickly edit text on a page so you can take that perfect screenshot. Orion for macOS makes this possible.

Show Console Errors

Web developers, we got you! You can add an indicator to the address bar of Orion for macOS that shows the number of errors on the page. This error indicator will allow you to quickly open Console and inspect the errors.

Installing Orion

You can download an installer for Orion for macOS and read its latest release notes.

You can install Orion for iOS/iPadOS from the App Store and read its latest release notes.

Orion is free and no account or signup is required to use it.

Importing Data From Other Browsers

Orion for macOS can import data from several web browsers and source files:

• Safari
• Google Chrome
• Brave
• Bookmarks HTML File
• Passwords CSV File

Orion for iOS and iPadOS cannot import data. But, it can sync data with Orion for macOS. So, you can do your data importing using Orion on a Mac and then sync your imported data to Orion on a iPhone or iPad.

Importing Data on macOS

1. Click the File menu, click Import From, and click on a web browser or source file of your choosing.

2. The data that you can import will depend on your choice of web browser or source file.

• Web browsers may allow you to choose a browser Profile to import from and will allow you to choose the specific browser data that you wish to import.
• Bookmarks HTML Files and Passwords CSV Files will need to you to choose a specific file in the appropriate format from your file system,

3. Click the Import button for web browser imports or the Open button for file imports.

Safari Import

Google Chrome Import

Brave Import

Default Search Engine

Table of Contents

• No Preset Default Search Engine
• Setting or Changing the Default Search Engine
  • macOS
  • iOS
  • iPadOS

No Preset Default Search Engine

Orion doesn't come with a default search engine preset. If it did, the moment you started typing in the address bar, it would leak your IP address and browser fingerprint to a search engine that you may prefer to avoid.

Our commitment to your privacy means that Orion will ask you to set your default search engine on your first use of the address bar. You can choose any search engine you wish. Or, you can choose "None" to not have a default search engine at all.

Setting or Changing the Default Search Engine

You can easily set or change Orion's default search engine at any time.

macOS

1. Click the Orion menu and choose Preferences.

2. Click the Search tab.
3. You can choose your preferred "Search engine" from the list.

4. Or, you can click the Manage button to manually configure a search engine.

• Click the + button to add a new search engine.

• Fill in the Name, Search URL Template, and Suggestion URL Template(optional) fields. If you don't know the template URLs, ask the provider of your search engine for them.
• Click the Save Engine button.

iOS

1. Tap the three-dot menu (•••) in the bottom-right corner of your screen.
2. Tap Settings.

3. Tap Search Engine.

4. You can choose your preferred "Search engine" from the scrollable list.

5. Or, you can tap the + button in the upper right corner to manually configure a search engine.

• Fill in the Name, Search URL Template, and Suggestions URL Template (optional) fields. If you don't know the template URLs, ask the provider of your search engine for them.
• Click the Save button.

iPadOS

1. Tap the three-dot menu (•••) in the upper-right corner of your screen.
2. Tap Settings.

3. Tap Search Engine.

4. You can choose your preferred "Search engine" from the list.

5. Or, you can tap the + button in the upper right corner to manually configure a search engine.

• Fill in the Name, Search URL Template, and Suggestions URL Template (optional) fields. If you don't know the template URLs, ask the provider of your search engine for them.
• Click the Save button.

Troubleshooting Webpage Issues

Orion Compatibility Mode

If you're having an issue using a website on Orion for macOS, enabling Compatibility Mode for the website may resolve it.

Putting a website into Compatibility Mode will:

• Disable content blocking
• Disable tracking prevention
• Disable web fonts blocking
• Enable cookies
• Use the Safari user agent
• Disable all browser extensions

To put a website into Compatibility Mode, use the gear icon on Orion's toolbar:

The gear icon also allows you to access other Website Settings that allow more granular control when troubleshooting.

Empty Cache

If you encounter sluggish loading of web pages and/or switching tabs, try Develop menu -> Empty Cache.

iOS & iPadOS

iOS and iPadOS don't have the Compatibility Mode feature. But, you can disable content blockers for specific websites where they cause problems.

You just tap on the icon for a website in the address bar and then tap Turn off Content Blockers.

iOS

iPadOS

Troubleshooting Extension Issues

Orion supports both Chrome and Firefox extensions natively. Note that this support is still experimental and extensions may break or show unexpected behavior.

We recommend submitting such issues to orionfeedback.org.

Here are some extra things you can do to help us debug this:

• Copy console errors from background-script [Window->Extensions->Console (from options popup button for specific web-extension)]

• Copy console errors from web-extension popup if applicable
• Copy console errors from current active tab (in case its related to tab communication or content script)
• Store URL for web-extension
• Specify exactly what things are not working
• Video and screenshot will be good contains comparison with chrome and firefox browser where its working perfectly

What is Orion+?

Orion+ allows you to support the Orion project and mission. For a small fee ($5 per month or $50 per year), you’ll get:

• Direct communication with the development team
• The ability to influence the browser’s development
• Access to nightly builds, bleeding-edge WebKit (faster than stable), and experimental features
• The satisfaction of supporting an ad-free, unmonetized browser
• An Orion+ icon to represent that support

We are still working on some of these features and they will be released shortly.

Your financial contribution will help us to stay independent and to deliver on our promise of becoming the best browser for Apple users. You can also help us by spreading the word about Orion everywhere you go, from social media to the dinner table.

Please note that Orion+ fees are not tax deductible.

Website Settings

Table of Contents

• macOS Website Settings
• iOS Website Settings
• iPadOS Website Settings

macOS Website Settings

You can click the gear icon at the top of an Orion window to access the Website Settings for the current webpage.

You can control a number of settings related to the current website:

• Enable or disable Compatibility Mode
• Enable or disable Content Blockers
• Block or unblock Web Fonts
• Enable or disable Cookies
• Enable or disable Reader Mode
• Set Page Zoom between 50% and 300% to make content smaller or larger
• Control Auto Play so that:
  • Media is always allowed to automatically play
  • Media with sound is automatically stopped
  • Media is never allowed to automatically play
• Block or Allow Pop-up Windows
• Set the User Agent to a web browser or custom User Agent String of your choice
• Set whether the check of the SSL Certificate for the website must be Strict
• Control whether the website is set to Allow access, Deny access, or Ask for access to your Camera, Microphone, Screen Sharing, Location, and Notifications

iOS Website Settings

You can tap the icon for a website in Orion's address bar to access the Website Settings for the current web page.

You can control several settings related to the current website:

• Set Page Zoom between 50% and 300% to make content smaller or larger
• Enable or Disable Request Desktop Website, which shows a desktop computer version of the site rather than a mobile version
• Use Turn Off Content Blockers to enable or disable Content Blockers
• Enable or disable Use Reader Mode Automatically

iPadOS Website Settings

You can tap the icon for a website in Orion's address bar to access the Website Settings for the current web page.

You can control several settings related to the current website:

• Set Page Zoom between 50% and 300% to make content smaller or larger
• Enable or Disable Request Desktop Website, which shows a desktop computer version of the site rather than a mobile version
• Use Turn Off Content Blockers to enable or disable Content Blockers
• Enable or disable Use Reader Mode Automatically

Website Settings

Table of Contents

• macOS Website Settings
• iOS Website Settings
• iPadOS Website Settings

macOS Website Settings

You can click the gear icon at the top of an Orion window to access the Website Settings for the current webpage.

You can control a number of settings related to the current website:

• Enable or disable Compatibility Mode
• Enable or disable Content Blockers
• Block or unblock Web Fonts
• Enable or disable Cookies
• Enable or disable Reader Mode
• Set Page Zoom between 50% and 300% to make content smaller or larger
• Control Auto Play so that:
  • Media is always allowed to automatically play
  • Media with sound is automatically stopped
  • Media is never allowed to automatically play
• Block or Allow Pop-up Windows
• Set the User Agent to a web browser or custom User Agent String of your choice
• Set whether the check of the SSL Certificate for the website must be Strict
• Control whether the website is set to Allow access, Deny access, or Ask for access to your Camera, Microphone, Screen Sharing, Location, and Notifications

iOS Website Settings

You can tap the icon for a website in Orion's address bar to access the Website Settings for the current web page.

You can control several settings related to the current website:

• Set Page Zoom between 50% and 300% to make content smaller or larger
• Enable or Disable Request Desktop Website, which shows a desktop computer version of the site rather than a mobile version
• Use Turn Off Content Blockers to enable or disable Content Blockers
• Enable or disable Use Reader Mode Automatically

iPadOS Website Settings

You can tap the icon for a website in Orion's address bar to access the Website Settings for the current web page.

You can control several settings related to the current website:

• Set Page Zoom between 50% and 300% to make content smaller or larger
• Enable or Disable Request Desktop Website, which shows a desktop computer version of the site rather than a mobile version
• Use Turn Off Content Blockers to enable or disable Content Blockers
• Enable or disable Use Reader Mode Automatically

Password Management

Table of Contents

• Password Storage & Sync
• Importing Safari Passwords into Orion on macOS
• Syncing Passwords in Orion
  • macOS
  • iOS
  • iPadOS
• 1Password & Orion

Password Storage & Sync

Many users of Safari on Apple devices use iCloud Keychain to automatically sync Safari data, including website passwords, across devices.

Third-party web browsers, like Orion, cannot sync with the Keychain used by Safari. Orion must use its own Orion-specific Keychain. Safari cannot see the Orion Keychain and Orion cannot see the Safari Keychain.

If you want to use your Safari passwords in Orion, you will need to import the passwords into Orion on macOS. Then, you can use the passwords in Orion on all Apple devices through Orion's own Keychain sync.

Importing Safari Passwords into Orion on macOS

Orion on macOS can import your passwords from Safari 15+ on macOS. These versions of Safari ship with macOS 12 (Monterey) and macOS 13 (Ventura). They are also available on macOS 11 (Big Sur) through the Safari Technology Preview.

Once you have Safari 15+, follow these steps in Orion:

1. Click the File menu, choose Import From, and choose Safari.

2. Orion can import many different types of data from Safari, including passwords. Check and uncheck your desired import data and then click the Import button.

Syncing Passwords in Orion

To sync Orion passwords across devices, perform these steps on each device.

macOS

1. Click the Apple menu (), click System Preferences, and click Apple ID.
   • If you're using macOS 3.14 (Mojave), you don't need to click Apple ID.

2. In your iCloud/Apple ID settings, check the Keychain box if it isn't already checked.

iOS

1. Open the Settings app for your device.
2. Tap your name at the top of Settings.
3. Tap iCloud.
4. Turn on Passwords and Keychain if it isn't already on.

iPadOS

1. Open the Settings app for your device.
2. Tap your name at the top left corner of Settings.
3. Tap iCloud.

4. Turn on Keychain if it isn't already on.

1Password & Orion

1Password has not yet added support for Orion. Because of this, the 1Password browser extension does not function properly in Orion.

We have been told by 1Password that their development team is working on a new feature to allow users to choose their trusted browser. This will hopefully allow 1Password's browser extension to then work with Orion. 1Password has not given us any time estimate for when this new feature will be released.

In the meantime, 1Password 8 for macOS has a global autofill feature that does not require using any browser extension. Click inside a login field and press the command and \ keys at the same time.

Syncing Orion Data

Table of Contents

To sync Orion tabs, bookmarks, and reading lists across devices, perform these steps on each device.

• macOS
• iOS
• iPadOS

macOS

1. In Orion, use the Orion menu to open Preferences.

2. Click the Sync tab and check the box for Enable cross-device sync of your tabs, bookmarks, and reading list.

iOS

1. Open the Orion app.
2. Tap the three-dot menu (•••) in the lower-right corner of the screen.
3. Tap Settings.

4. In the Sync section, turn on Sync if it isn't already on.

iPadOS

1. Open the Orion app.
2. Tap the three-dot menu (•••) in the upper-right corner of the screen.
3. Tap Settings.

4. In the Sync section, turn on Sync if it isn't already on.

Troubleshooting

If you have problems syncing between devices try the following:

On iOS open Settings/Apple ID/iCloud/Apps Using iCloud/Show All and toggle off and on the button beside Orion

or

On MacOS open Settings/Apple ID/iCloud/iCloud Drive/Apps Syncing to iCloud Drive - Options and uncheck and check the box beside Orion

Reader Mode

Sometimes you just want to read the article on a website, not wade through ads, video embeds, and other distractions. Reader Mode is here to help. (Note that Orion's ad-blocking is deliberately disabled in the macOS example below.)

Table of Contents

• macOS Reader Mode
• iOS Reader Mode
• iPadOS Reader Mode

macOS Reader Mode

You can enable Reader Mode in three different ways while viewing a webpage.

• Click the icon on the left side of the address bar that looks like a document.

• Use the View menu and choose Show Reader.

• Type ⇧⌘R (Shift and Command and R) on your keyboard.

You can use the reverse of the three methods above to disable Reader Mode.

While in Reader Mode, you can use the icon on the right side of the address bar that looks like two letter A's to configure the layout the mode uses. You can control:

• Text size
• Background color
• Font
• Content width
• Text justification
• Borders

You can view and manage the Reader Mode settings for all websites in Orion's Preferences.

iOS Reader Mode

You can enable Reader Mode by tapping on the icon for the current website in the address bar and then tapping Reader Mode.

While in Reader Mode, you can use the icon on the left side of the address bar that looks like a document to configure the layout the mode uses. You can control:

• Text size
• Font
• Background color
• Text justification

From this menu you can also tap Reader Mode again to disable the mode.

You can view and manage the Reader Mode settings for all websites in Orion's Settings.

Tap Reader Mode.

iPadOS Reader Mode

You can enable Reader Mode by tapping on the icon for the current website in the address bar and then tapping Reader Mode.

While in Reader Mode, you can use the icon on the left side of the address bar that looks like a document to configure the layout the mode uses. You can control:

• Text size
• Font
• Background color
• Text justification

From this menu you can also tap Reader Mode again to disable the mode.

You can view and manage the Reader Mode settings for all websites in Orion's Settings.

Tap Reader Mode.

Vertical Tabs

If you love to have your browser tabs on the side, Orion has you covered with native vertical tabs support. Here's what it looks like on macOS.

Table of Contents

• macOS Vertical Tabs
• iOS Tab Styles
• iPadOS Vertical Tabs

macOS Vertical Tabs

You can enable vertical tabs by clicking the View menu and choosing Show Vertical Tabs Sidebar.

You can disable vertical tabs by going under the same View menu and choosing Hide Vertical Tabs Sidebar.

iOS Tab Styles

You can switch between Sidebar or Grid tab styles in Orion's settings.

1. Tap the three-dot menu (•••) in the bottom-right corner of your screen.
2. Tap Settings.

3. Tap Tab View Style.

Then, choose between Sidebar or Grid.

iPadOS Tab Styles

You can switch between Sidebar or Grid tab styles in Orion's settings.

1. Tap the three-dot menu (•••) in the upper-right corner of your screen.
2. Tap Settings.

3. Tap Tab View Style.

Then, choose between Sidebar or Grid.

Tab Groups

In Orion, Tab Groups are also called Named Windows. You can sync the tabs in a Named Window across Orion on all devices. Here's what it looks like in macOS.

Table of Contents

• macOS Tab Groups
• iOS Tab Groups
• iPadOS Tab Groups

macOS Tab Groups

Simply use the Rename command in the windows menu to give the current window a name, such as "Work".

The Tab Group will now sync in Orion across all of your devices where syncing is enabled.

iOS Tab Groups

1. Tap the icon that looks like two squares at the bottom on the screen.

2. Tap the Tabs menu at the bottom of your screen. The location and appearance of the menu can vary based on whether you use Sidecar or Grab tabs and how many tabs you have open.

3. In the menu at the bottom on the screen, tap New Tab Group from X Tab (the X will vary based on how many tabs you have open.)

4. Enter a name for the new tab group and tap Save.

The Tab Group will now sync in Orion across all of your devices where syncing is enabled.

iPadOS Tab Groups

1. Tap the icon that looks like two squares at the top right of the screen.

2. Tap the Tabs menu at the bottom of your screen. The location and appearance of the menu can vary based on whether you use Sidecar or Grab tabs and how many tabs you have open. In the menu that appears, tap New Tab Group from X Tab (the X will vary based on how many tabs you have open.)

3. Enter a name for the new tab group and tap Save.

The Tab Group will now sync in Orion across all of your devices where syncing is enabled.

Profiles

With Orion Profiles, you can create multiple identities to be used online and keep all your Orion information separate, like bookmarks, history, passwords, extensions, and other settings.

To create new and manage existing profiles, Use the File -> Profiles menu. Every Orion installation comes with the Default profile.

Orion has complete isolation of Profile information at the app level. That means that Profiles will have their own separate:

• Settings
• Passwords
• Extensions
• Bookmarks
• History
• Sessions and website data

Moreover, Profiles in Orion appear as separate apps in your Dock. The app-level separation between profiles has multiple advantages, such as if one of your Profiles crashes, the others are left intact.

Also, you can keep different profiles in your Dock and launch them with one click.

Using Quick Searches

Table of Contents

• macOS Quick Searches
• iOS Quick Searches
• iPadOS Quick Searches

macOS Quick Searches

You can search specific websites directly in Orion with Quick Search bookmarks that use invocation keywords.

For example, let's create a YouTube Quick Search bookmark:

1. Visit the following URL and start adding a new bookmark for it, but don't save the bookmark yet: https://www.youtube.com/results?search_query=cats

2. In the window that appears, make several changes:

• Under the "Add this page to:"" menu, choose whether you want the new bookmark saved to Favorites or some other location.
• Change the Title of the bookmark from "cats - YouTube" to a broader search title of your choice, such as "YouTube Search".
• Click the More Options button.

3. In the updated window, make two more changes:

• In the URL of the bookmark, replace the "cats" search query text with %s so the URL is now: https://www.youtube.com/results?search_query=%s
• Add yt as the "Invocation character or keyword".
• Click the Add button

Now, typing yt cats in Orion's address bar will send you into a search for "cats" on YouTube. And, typing yt dogs in Orion's address bar will send you into a search for "dogs" on YouTube. You can use the yt invocation keyword to search YouTube for anything.

You can repeat this process with the search results page for any website to add another Quick Search bookmark.

You can also edit any existing search results bookmark to make it into a Quick Search bookmark.

iOS Quick Searches

Quick Searches will be coming to iOS soon and these instructions explain how they will work.

You can search specific websites directly in Orion with Quick Search bookmarks that use invocation keywords.

For example, let's create a YouTube Quick Search bookmark:

1. Visit the following URL and start adding a new bookmark for it, but don't save the bookmark yet: https://m.youtube.com/results?search_query=cats

2. In the window that appears, make several changes:

• Change the Title of the bookmark from "cats - YouTube" to a broader search title of your choice, such as "YouTube Search".
• In the URL of the bookmark, replace the "cats" search query text with %s so the URL is now: https://www.youtube.com/results?search_query=%s
• Add yt as the "Invocation character or keyword".
• Under Location, choose whether you want the new bookmark saved to Favorites or some other location.
• Click the Save button

Now, typing yt cats in Orion's address bar will send you into a search for "cats" on YouTube. And, typing yt dogs in Orion's address bar will send you into a search for "dogs" on YouTube. You can use the yt invocation keyword to search YouTube for anything.

You can repeat this process with the search results page for any website to add another Quick Search bookmark.

You can also edit any existing search results bookmark to make it into a Quick Search bookmark.

iPadOS Quick Searches

Quick Searches will be coming to iPadOS soon and these instructions explain how they will work.

You can search specific websites directly in Orion with Quick Search bookmarks that use invocation keywords.

For example, let's create a YouTube Quick Search bookmark:

1. Visit the following URL and start adding a new bookmark for it, but don't save the bookmark yet: https://m.youtube.com/results?search_query=cats

2. In the window that appears, make several changes:

• Change the Title of the bookmark from "cats - YouTube" to a broader search title of your choice, such as "YouTube Search".
• In the URL of the bookmark, replace the "cats" search query text with %s so the URL is now: https://www.youtube.com/results?search_query=%s
• Add yt as the "Invocation character or keyword".
• Under Location, choose whether you want the new bookmark saved to Favorites or some other location.
• Click the Save button

Now, typing yt cats in Orion's address bar will send you into a search for "cats" on YouTube. And, typing yt dogs in Orion's address bar will send you into a search for "dogs" on YouTube. You can use the yt invocation keyword to search YouTube for anything.

You can repeat this process with the search results page for any website to add another Quick Search bookmark.

You can also edit any existing search results bookmark to make it into a Quick Search bookmark.

Viewing Web Archives

If a webpage won't load in Orion for macOS or you want to see an earlier version of it, you can see if the page is stored in the Wayback Machine Internet Archive.

While viewing the page in Orion for macOS (or trying to view it), click the Tools menu and choose Open Page in Internet Archive.

Here's an example of kagi.com's previous life when our domain was used by a payment processor:

Picture-in-Picture Videos

When playing a video in Orion for macOS, you can view it in Picture-in-Picture mode.

Click on the View menu and choose Show Picture-in-Picture Video or type Control-Command-P on your keyboard.

By default, the PiP video snaps to a corner of your screen. But, you can hold down the Command key and drag the video to any position you wish.

Focus Mode

Focus Mode allows you to completely remove toolbars from your browser interface. Browse the web distraction-free! Here's an example on macOS.

Table of Contents

• macOS Focus Mode
• iOS Focus Mode
• iPadOS Focus Mode

macOS Focus Mode

You can enter Focus Mode by clicking the View menu and choosing Enable Focus Mode. Or, you can type Shift-Command-F on your keyboard.

To exit Focus Mode, click the View menu and choose Disable Focus Mode. Or, you can type Shift-Command-F again on your keyboard.

iOS Focus Mode

1. Tap the three-dot menu (•••) in the bottom-right corner of your screen.
2. Tap Settings.

3. Turn on Focus Mode.

Here's an example of YouTube in Focus Mode.

iPadOS Focus Mode

1. Tap the three-dot menu (•••) in the upper-right corner of your screen.
2. Tap Settings.

3. Turn on Focus Mode.

Here's an example of CNN in Focus Mode.

Low Power Mode

Inspired by the same feature on iPhone, Low Power Mode reduces Orion's power consumption up to 90%. It does this by cleverly suspending browser tabs you haven't used after five minutes.

Table of Contents

• macOS Low Power Mode
• iOS Low Power Mode
• iPadOS Low Power Mode

macOS Low Power Mode

You can enable Low Power Mode by clicking the Tools menu and then clicking Low Power Mode....

You can then click the Enable button in the window that appears.

You can disable Low Power Mode using the same menu option.

iOS Low Power Mode

You can enable Low Power Mode in Orion's Settings.

1. Tap the three-dot menu (•••) in the bottom-right corner of your screen.
2. Tap Settings.

3. Turn on Low Power Mode.

You can disable Low Power Mode from the same place.

iPadOS Low Power Mode

You can enable Low Power Mode in Orion's Settings.

1. Tap the three-dot menu (•••) in the upper-right corner of your screen.
2. Tap Settings.

3. Turn on Low Power Mode.

You can disable Low Power Mode from the same place.

Allow Copy Paste

Some webpages prevent copy or paste. It's annoying! You can easily override this in Orion for macOS.

1. While on the annoying webpage, click the Tools menu.
2. Click Allow Copy & Paste.

Edit Text on Page

Sometimes you may want to quickly edit text on a page so you can take that perfect screenshot. Orion for macOS makes this possible.

1. While on the webpage, click the Tools menu.
2. Click Edit Text on Page.
3. Make Your text edits.
4. Use the Tools menu again and choose Edit Text on Page to stop editing.

Float on Top

Floating a window on top is a feature of many paid apps on the Mac App Store. Orion for macOS has it built-in for free.

1. While viewing a window in Orion that you want to float, click the Window menu.
2. Click Float on Top or type Control-Command-U.

The window will now float on top of all others. You can use the same menu choices or keyboard command on the window to disabling floating.

Show Console Errors

This one's for the web developers out there. You can add an indicator to the address bar of Orion for macOS that shows the number of errors on the page. This error indicator will allow you to quickly open Console and inspect the errors.

1. Click the Develop menu.
2. Click Show Console Errors Indicator.

Block Auto-Play

Many websites have videos and other media that automatically play when you load webpages.

On Orion for macOS, all media with sound is automatically stopped by default. There is a setting to quickly change auto-play behavior across all websites. Unique auto-play settings can also be made for specific websites.

To configure auto-play settings:

1. Click the Orion menu.
2. Click Preferences.

3. Click the Websites tab of Preferences.
4. Click on Auto Play from the list of settings on the left of the window.

There is a Default settings for all websites option at the top right of the window that can be set to:

• Allow all Auto-Play
• Stop Media with Sound
• Never Auto-Play

There is also an area in the lower right of the window where you can add (+ button) or remove (- button) websites and give listed websites specific auto-play settings.

Orion macOS Web Extensions Support

You will find here:

• Chrome and Firefox Extensions Support
• Installing Popular Extensions
• Managing Extensions
  • Compatibility Mode
• Enabling 3rd party extensions installation
  • Choosing a Chrome Extension or a Firefox Extension
• Troubleshooting Extension issues
• Supported WebExtensions APIs
• Manifest v2 vs. v3
• Safari Extensions Support

Chrome and Firefox Extensions Support

Orion enables users to tap into over 300,000 extensions created both for the Chrome and Firefox browsers, and run them natively on top of WebKit rendering engine.

By adopting the WebExtensions APIs, we've shown our support for creating a unified browser extension experience across all three major web rendering engines. We've ended up porting hundreds of WebExtension APIs, one by one, that were never meant to work with WebKit. It took us a few years to do that and this is still work in progress. You can help this effort by supporting Orion development and becoming Orion+ member.

On top of that, we've built advanced security features that give our users granular control over extensions, far beyond what Chrome and Firefox offer. For example, you can choose to allow an extension to run only on certain websites.

Orion support for WebExtensions APIs is currently at about 70%. This means that many extensions will work but also that many are not fully supported. When an extension does not work in Orion, it is likely not a bug, but we did not support all the APIs it needs to run on WebKit yet. It is enough that one API is not supported for the extension to not work. Our goal is to have 100% extension support by the time Orion leaves beta.

Note that while we designed Orion to be as fast and lightweight as possible, extensions may affect Orion's performance, which is out of our control. We advise limiting the number of extensions you use to only bare minimum required by your workflow. Orion includes many extension features natively, including a built in ad-blocker.

Installing Popular Extensions

Orion highlights some popular Web Extensions for you to try first:

1. Click the Orion menu.
2. Choose Popular Extensions.
3. Click Get to install an extension.

Managing Extensions

1. Click the Window menu.
2. Click Extensions.

3. From the Extensions management area, you can:

• Use the Add Extension button to install Firefox, Chrome, or file-based extensions
• Configure specific extensions
• Disable one or more extensions
• Uninstall one or more extensions

Managing Extensions Permissions and Compatibility Mode

In Orion, you can manage extension permissisions on a per-website basis.

Click the Gear icon in the toolbar to bring up website settings and look for "Extensions permissions" section. You can also manage extension permissions globally through Settings -> Websites menu (scroll down).

In addition, Orion features a simple to use Compatibility mode option, which applies 'safe' settings for the current website, including disabling all extensions.

Enabling 3rd party extensions installation

To enable installation of 3rd party extension, go to Settings -> Advanced and find "Allow installation of 3rd party Chrome extensions" or "Allow installation of 3rd party Firefox extensions" options.

Note that the extension support is still in beta. Extension may not be fully supported yet and if you encounter problems, website issues or performance issues, you can easily uninstall it by right-clicking the extension icon and selecting 'Uninstall' or through the manage extensions window.

If you are a developer, we have some tips for troubleshooting extension issues.

Choosing a Chrome Extension or a Firefox Extension

Orion supports both Chrome and Firefox extensions. Usually, they’re similar. Sometimes, an extension developer puts extra effort into one version, perhaps because they prefer that browser.

You can try both and use the one that works best for you. Orion is the only browser in the world that makes this choice possible!

Installing Extensions

Many Chrome and Firefox extensions already work with Orion. And, even more of them will work in the future.

You can install them directly from the Chrome or Firefox extension websites with one click installation.

The most popular extensions can be installed from Popular extensions screen.

Troubleshooting Web Extensions Issues

Sometimes Web Extensions will not work properly. Also Web Extensions are the most likely cause of performance or resource issues in Orion. If such issues occur, the safest is to uninstall the extension causing the issue.

You can also submit a bug report to Orion feedback forum and before that, check out our troubleshooting web extensions guide for more information.

Supported WebExtensions APIs

Orion currently supports about 70% of the WebExtensions APIs, and we add support for more all the time.

Manifest v2 vs. v3

The rollout of manifest v3 extensions in Chrome will not affect extensions in Orion.

Orion has its own implementation of the entire WebExtensions APIs collection. Different "manifests" are just numbers. We support WebExtensions APIs regardless of how Google decides to number them or change them. Manifest change impacts mainly Chromium clones. Orion will support both "manifest v2" and manifest v3" extensions in the future.

Safari Extensions Support

Unfortunately, Apple uses closed, proprietary APIs for Safari extensions rather than open WebExtensions APIs. So, it is not possible to use Safari extensions with Orion or any non-Safari browser.

Orion macOS Web Extensions Support

You will find here:

• Chrome and Firefox Extensions Support
• Installing Popular Extensions
• Managing Extensions
  • Compatibility Mode
• Enabling 3rd party extensions installation
  • Choosing a Chrome Extension or a Firefox Extension
• Troubleshooting Extension issues
• Supported WebExtensions APIs
• Manifest v2 vs. v3
• Safari Extensions Support

Chrome and Firefox Extensions Support

Orion enables users to tap into over 300,000 extensions created both for the Chrome and Firefox browsers, and run them natively on top of WebKit rendering engine.

By adopting the WebExtensions APIs, we've shown our support for creating a unified browser extension experience across all three major web rendering engines. We've ended up porting hundreds of WebExtension APIs, one by one, that were never meant to work with WebKit. It took us a few years to do that and this is still work in progress. You can help this effort by supporting Orion development and becoming Orion+ member.

On top of that, we've built advanced security features that give our users granular control over extensions, far beyond what Chrome and Firefox offer. For example, you can choose to allow an extension to run only on certain websites.

Orion support for WebExtensions APIs is currently at about 70%. This means that many extensions will work but also that many are not fully supported. When an extension does not work in Orion, it is likely not a bug, but we did not support all the APIs it needs to run on WebKit yet. It is enough that one API is not supported for the extension to not work. Our goal is to have 100% extension support by the time Orion leaves beta.

Note that while we designed Orion to be as fast and lightweight as possible, extensions may affect Orion's performance, which is out of our control. We advise limiting the number of extensions you use to only bare minimum required by your workflow. Orion includes many extension features natively, including a built in ad-blocker.

Installing Popular Extensions

Orion highlights some popular Web Extensions for you to try first:

1. Click the Orion menu.
2. Choose Popular Extensions.
3. Click Get to install an extension.

Managing Extensions

1. Click the Window menu.
2. Click Extensions.

3. From the Extensions management area, you can:

• Use the Add Extension button to install Firefox, Chrome, or file-based extensions
• Configure specific extensions
• Disable one or more extensions
• Uninstall one or more extensions

Managing Extensions Permissions and Compatibility Mode

In Orion, you can manage extension permissisions on a per-website basis.

Click the Gear icon in the toolbar to bring up website settings and look for "Extensions permissions" section. You can also manage extension permissions globally through Settings -> Websites menu (scroll down).

In addition, Orion features a simple to use Compatibility mode option, which applies 'safe' settings for the current website, including disabling all extensions.

Enabling 3rd party extensions installation

To enable installation of 3rd party extension, go to Settings -> Advanced and find "Allow installation of 3rd party Chrome extensions" or "Allow installation of 3rd party Firefox extensions" options.

Note that the extension support is still in beta. Extension may not be fully supported yet and if you encounter problems, website issues or performance issues, you can easily uninstall it by right-clicking the extension icon and selecting 'Uninstall' or through the manage extensions window.

If you are a developer, we have some tips for troubleshooting extension issues.

Choosing a Chrome Extension or a Firefox Extension

Orion supports both Chrome and Firefox extensions. Usually, they’re similar. Sometimes, an extension developer puts extra effort into one version, perhaps because they prefer that browser.

You can try both and use the one that works best for you. Orion is the only browser in the world that makes this choice possible!

Installing Extensions

Many Chrome and Firefox extensions already work with Orion. And, even more of them will work in the future.

You can install them directly from the Chrome or Firefox extension websites with one click installation.

The most popular extensions can be installed from Popular extensions screen.

Troubleshooting Web Extensions Issues

Sometimes Web Extensions will not work properly. Also Web Extensions are the most likely cause of performance or resource issues in Orion. If such issues occur, the safest is to uninstall the extension causing the issue.

You can also submit a bug report to Orion feedback forum and before that, check out our troubleshooting web extensions guide for more information.

Supported WebExtensions APIs

Orion currently supports about 70% of the WebExtensions APIs, and we add support for more all the time.

Manifest v2 vs. v3

The rollout of manifest v3 extensions in Chrome will not affect extensions in Orion.

Orion has its own implementation of the entire WebExtensions APIs collection. Different "manifests" are just numbers. We support WebExtensions APIs regardless of how Google decides to number them or change them. Manifest change impacts mainly Chromium clones. Orion will support both "manifest v2" and manifest v3" extensions in the future.

Safari Extensions Support

Unfortunately, Apple uses closed, proprietary APIs for Safari extensions rather than open WebExtensions APIs. So, it is not possible to use Safari extensions with Orion or any non-Safari browser.

uBlock Origin on macOS

Users of the uBlock Origin browser extension for content filtering are a passionate bunch. When we tell them Orion allows them to run uBlock in a WebKit-based browser on macOS, some have cried. But, they've assured us these are tears of joy!

Orion Content Blocking vs. uBlock Origin

Orion's built-in blocker is about 90% as efficient as uBlock Origin using default settings. But, our built-in blocker is faster. We designed it to be a great choice for most users.

For power users who want that last 10% with uBlock, we recommend disabling Orion's content blocker globally. Running both Orion blocking and uBlock may cause interference with each other.

To disable Orion's content blocking:

1. In Orion, click the Orion menu and choose Preferences.

2. Click the Websites tab.
3. Click Content Blockers in the list of options.
4. Set "Default settings for all websites" to Off.

We recommend leaving Orion's tracking protection on. It uses WebKit's machine-learning-based technology and complements uBlock Origin to provide the best overall protection.

You can then install the uBlock Origin extension for Chrome or Firefox in Orion.

Orion iOS & iPadOS Web Extension Support

Table of Contents

• Overview
• Enabling 3rd party extensions installation
• iOS Extensions Management
• iPadOS Extensions Management
• Safari Extensions Not Supported

Overview

Orion is the first web browser to offer preliminary support for Chrome and Firefox browser extensions on iOS and iPadOS.

Much of what we said about Web Extensions support on desktop Orion stands, with further limitations in the scope of APIs we can support which are imposed by Apple. This results in a smaller number of extensions that are currently fully functional on iOS and iPadOS. But small number is better than zero, and you can one-click install them from the Chrome or Firefox extension websites.

Enabling 3rd party extensions installation

1. Tap the three-dot menu (•••) in the bottom-right corner of your screen.
2. Tap Settings
3. Scroll to the Extensions settings group, and toggle Chrome or Firefox extensions on or off

Note that the extension support is still in beta. Extension may not be fully supported yet and if you encounter problems, website issues or performance issues, you can easily disable or uninstall it in the Extensions list after tapping the three-dot menu (•••) in the bottom-right (on iPhone; for iPads, it's in the top-right) corner of your screen (iPhone).

iOS Extensions Management

1. Tap the three-dot menu (•••) in the bottom-right corner of your screen.
2. Tap Extensions.

3. From the Extensions management area, you can:

• Use the + button to install Firefox, Chrome, or file-based extensions
• Disable one or more extensions
• Uninstall one or more extensions

iPadOS Extensions Management

1. Tap the three-dot menu (•••) in the upper-right corner of your screen.
2. Tap Extensions.

3. From the Extensions management area, you can:

• Use the + button to install Firefox, Chrome, or file-based extensions
• Disable one or more extensions
• Uninstall one or more extensions

Safari Extensions Not Supported

Unfortunately, Apple uses closed, proprietary APIs for Safari extensions rather than WebExtensions APIs. So, it is not possible to use Safari extensions with Orion or any non-Safari browser.

1Password & Orion

1Password has not yet added support for Orion. Because of this, the 1Password browser extension does not function properly in Orion.

We have been told by 1Password that their development team is working on a new feature to allow users to choose their trusted browser. This will hopefully allow 1Password's browser extension to then work with Orion. 1Password has not given us any time estimate for when this new feature will be released.

1Password support for Orion

In the meantime, 1Password 8 for macOS has a global autofill feature that does not require using any browser extension. Click inside a login field and press the command and \ keys at the same time.

Configure Ad & Tracking Blocking

Table of Contents

• Why Use Blocking?
• macOS Configuration
• iOS and iPadOS Configuration
• Websites Whitelisted From Blocking

Why Use Blocking?

Over 700 million devices block online ads, creating the largest silent protest in human history. We too believe in a cleaner, more humane web. 

Orion blocks both first-party and third-party ads, trackers, and other annoyances by default. We do this to make your online adventures more enjoyable and more private. It also saves you time, battery, and data. Yes, it may occasionally break a site, but in most cases the benefit outweighs the risk.

If you wish, you can disable blocking either for a specific website or globally.

macOS Configuration

You can disable the content blocking or tracker prevention for a specific site using the gear icon on Orion's toolbar:



To disable Orion's content blocking or tracking prevention globally:

1. In Orion, click the Orion menu and choose Preferences.
2. Click the Websites tab.
3. Click Content Blockers or Tracking Protection in the list of options.
4. Set "Default settings for all websites" to Off.

iOS and iPadOS Configuration

You can disable content blocking for a specific site by tapping the site's favicon image:

You can also configure content blocking globally:

1. Tap the three-dot menu (•••).
2. Tap Settings.
3. You can use the Ads and Tracking section to enable either Basic tracking protection or Full tracking and advertising protection.

Websites Whitelisted From Blocking

Orion comes with a built-in content blocker that in rare cases can affect proper functionality of some websites. We maintain a whitelist of websites where content blocker will be turned off by default.

This list currently consists of:

• browserbench.org - The content blocker interferes with JavaScript performance benchmarking. We decided it is best to have it off to measure the real speed of WebKit's JavaScript engine.
• wizzair.com - The content blocker interferes with rendering of the website.

If you wish, you can enable blocking on any whitelisted website using the instructions above.

Configure Ad & Tracking Blocking

Table of Contents

• Why Use Blocking?
• macOS Configuration
• iOS and iPadOS Configuration
• Websites Whitelisted From Blocking

Why Use Blocking?

Over 700 million devices block online ads, creating the largest silent protest in human history. We too believe in a cleaner, more humane web. 

Orion blocks both first-party and third-party ads, trackers, and other annoyances by default. We do this to make your online adventures more enjoyable and more private. It also saves you time, battery, and data. Yes, it may occasionally break a site, but in most cases the benefit outweighs the risk.

If you wish, you can disable blocking either for a specific website or globally.

macOS Configuration

You can disable the content blocking or tracker prevention for a specific site using the gear icon on Orion's toolbar:



To disable Orion's content blocking or tracking prevention globally:

1. In Orion, click the Orion menu and choose Preferences.
2. Click the Websites tab.
3. Click Content Blockers or Tracking Protection in the list of options.
4. Set "Default settings for all websites" to Off.

iOS and iPadOS Configuration

You can disable content blocking for a specific site by tapping the site's favicon image:

You can also configure content blocking globally:

1. Tap the three-dot menu (•••).
2. Tap Settings.
3. You can use the Ads and Tracking section to enable either Basic tracking protection or Full tracking and advertising protection.

Websites Whitelisted From Blocking

Orion comes with a built-in content blocker that in rare cases can affect proper functionality of some websites. We maintain a whitelist of websites where content blocker will be turned off by default.

This list currently consists of:

• browserbench.org - The content blocker interferes with JavaScript performance benchmarking. We decided it is best to have it off to measure the real speed of WebKit's JavaScript engine.
• wizzair.com - The content blocker interferes with rendering of the website.

If you wish, you can enable blocking on any whitelisted website using the instructions above.

Respecting Privacy

Orion has no built-in telemetry, so it can never "phone home" and risk exposing your data. Orion is truly and verifiably a privacy-respecting browser, unlike those that offer only an illusion of privacy.

Most browsers regularly "phone home" dozens or even hundreds times. Each request poses a security risk, no matter what information it sends, by potentially exposing your IP address and your browser fingerprint. Telemetry can also inadvertently leak personally identifiable information or corporate intelligence.

The safest way to secure your private data is for your browser to be zero telemetry out of the box. Want to keep your information safe and private? Orion makes it possible!

Protecting Privacy

Web ads have steadily eroded the online experience with their layout crowding, page slowing, annoying popups, and insidious malware. Yet, most browsers do not block ads by default. Orion is different.

It comes with a state-of-the-art ad and tracking blocker that blocks first-party and third-party scripts and requests. That means that Orion always blocks all trackers by default. We combined WebKit's Intelligent Tracking Protection with "Easy Privacy" and other lists, providing double protection.

We use WebKit's content-blocking functionality and an optimized content-blocking database to maximize speed and minimize latency as well. Orion successfully blocks 99.9% of all ads, including YouTube ads, both on desktop and mobile.

Preventing Fingerprinting

Orion approaches this problem with the philosophy of "no fingerprinter running, no fingerprinting possible". This is because it is literally impossible to prevent fingerprinting from a sophisticated fingerprinter, if one is ever allowed to run. 

Even a simple JS/CSS based fingerprinter will bypass 99% of "protections" created by browsers, let alone something sophisticated such as GPU fingerprinting or audio driver fingerprinting. Literally, if Javascript/CSS is allowed to run in your browser, and a fingerprinter runs on the page, your browser will be fingerprinted.

So forget user agent/screen resolution/OS masking and other marketing talk used by browsers—this was maybe a thing 15 years ago, if ever. This does not protect you against sophisticated fingerprinters on the web.

The only efficient protection against fingerprinting is what Orion is doing - preventing any fingerprinter from running in the first place. Orion is the only browser on the market that comes with full first-party and third-party ad and tracking script blocking, built-in by default, making sure invasive fingerprinters never run on the page.

Orion vs. Safari

Safari is truly one of the best browsers you can use on macOS, and we’re grateful to Apple for creating such a solid foundation. By basing Orion on Safari’s tech stack, then adding productivity enhancements such as built-in ad-blocking, Orion can provide users with exactly what they need.

You want speed? Orion is currently the fastest Mac browser out there. We built a snappy, lightweight browser around Safari’s WebKit engine to accelerate your web experience.

What about privacy? Orion is a true zero-telemetry browser, with a powerful built-in ad and tracking blocker. Even with its default settings, Orion offers the highest possible privacy protection on the web.

And extensions! Unlike Safari, Orion has native support for both Chrome and Firefox extensions. This gives our users access to the largest extensions ecosystem in the world. With Orion, you can one-click install your favorite extensions directly from the web.

Orion vs. Safari

Safari is truly one of the best browsers you can use on macOS, and we’re grateful to Apple for creating such a solid foundation. By basing Orion on Safari’s tech stack, then adding productivity enhancements such as built-in ad-blocking, Orion can provide users with exactly what they need.

You want speed? Orion is currently the fastest Mac browser out there. We built a snappy, lightweight browser around Safari’s WebKit engine to accelerate your web experience.

What about privacy? Orion is a true zero-telemetry browser, with a powerful built-in ad and tracking blocker. Even with its default settings, Orion offers the highest possible privacy protection on the web.

And extensions! Unlike Safari, Orion has native support for both Chrome and Firefox extensions. This gives our users access to the largest extensions ecosystem in the world. With Orion, you can one-click install your favorite extensions directly from the web.

Orion vs. Chrome, Firefox, & Others

Google and Mozilla have made great technological strides over the past decades. We’re grateful for those efforts because they help us take the next step in browser evolution. Orion has superior performance, memory use, and battery efficiency compared to any non-WebKit browser on a macOS.

Orion is the first browser to have a zero-telemetry policy, meaning it will never "phone home" with any of your data. It also comes with a default blocker that knocks out ads and trackers, keeping websites respectful of our users.

As a native Mac app, Orion uses macOS components to give you the speed, look, and feel of a Mac app along with deep integration of native system technologies.

And, of course, Orion takes its users seriously. Because we’re zero telemetry, we design the product based only on what our users tell us. We’re here for you, and we’re doing this together!

Orion Speed

Orion is as fast or faster than Safari, because while both use the WebKit engine, we streamlined our browser for smoother use. Orion is much faster than non-WebKit browsers like Firefox or Chrome and its derivatives (Edge, Brave, Opera, etc.).

Orion scores 326 on Speedometer 2.0 (using M1 MacBook Pro, with Orion's Compatibility mode ON) which is the fastest performance of any browser in existence (that we know of). 

On top of this, the native ad blocker makes Orion simply unrivaled in browsing speed. And, thanks to thoughtful optimizations, Orion feels faster and more responsive than Safari on slow and old Macs.

Memory Usage

Orion is lightweight with advanced memory-use technology. From single-tab optimizations to pinned tab management, we strive to minimize Orion's memory footprint. 

For power users, Orion has the best closed-tab management of all contemporary browsers. On default settings, Orion will consume 2x-3x less memory than mainstream choices after closing tabs. 

Frequently Asked Questions (FAQ)

Table of Contents

• What is Orion?
• How do I replay the intro video
• Why is it important for an app to be native?
• Why use Orion instead of Safari?
• Why use Orion instead of Chrome, Firefox or other browsers based on Chromium/Firefox?
• How fast is Orion?
• How much memory does Orion use?
• How does Orion respect my online privacy?
• How does Orion protect my online privacy?
• How do I clear Cookies?
• How does Orion support extensions?
• Does Orion have an iPhone or iPad app?
• Is there any way to get a previous build of Orion?
• How do I enable Debug menu?
• How do I access my Favorites via shortcuts (CMD + #)?
• Orion is displaying wrong icons for Favorites and Frequently Visited pages — how can I fix that?

What is Orion?

Orion is a native, lightning-fast, and privacy-protecting browser for Apple users, open to the web and all its standards and protocols. It's based on the WebKit open-source browser engine that also powers Apple's Safari web browser. One day, we hope everyone will say Orion is the best browser for all Apple devices.

Orion was built for professionals by professionals, but anyone can benefit from it. Installing Orion with its default settings on any Apple device will cut down on annoying ads and speed up page loads. We want everyone to enjoy the web.

How do I replay the intro video?

Watch is here in even higher quality!

Orion intro animation

Why is it important for an app to be native?

We take pride in Orion being 100% native on macOS/iOS/iPadOS.

Lets define what native means first: Native macOS app is an app that is specifically designed for the Apple macOS operating system and utilizes its APIs, frameworks, UI components and guidelines.

The main benefits of native apps include:

• Ensuring that the app feels familiar to users. HIG provides guidance on how to design an intuitive UI that follows platform conventions and therefore provides a consistent experience across apps for new and veteran users.

• It is generally accepted that Apple knows what it is doing when design is question. It is probably a good idea to follow its lead and probably one of the reasons you own a Mac or an iPhone. Following the extensive Human Interface Guidelines (HIG) makes any designer's job easier, not harder.

• Any long time Mac user can easily see how Chrome or Firefox look and feel out of place on a Mac. These browsers were originally designed for Windows, but they work and look the same even on macOS or Linux, when those are clearly different operating systems with different conventions, design rules and aesthetics.

• Native integrations allow apps to use powerful components provided by the OS. For example Orion utilizes Keychain to store passwords or gets the benefit of Live Text recognition of text in images. This make apps more powerful while being leaner and easier to build and maintain at the same time.

• Finally, and maybe most importantly, using native components and frameworks generally makes apps faster, better for battery life and overall snappier.

Why use Orion instead of Safari?

Safari is truly one of the best browsers you can use on macOS, and we're grateful to Apple for creating such a solid foundation. By basing Orion on Safari's tech stack, then adding productivity enhancements such as built-in ad-blocking, Orion can provide users with exactly what they need.

Why use Orion instead of Chrome, Firefox, or other browsers based on Chromium/Firefox?

Google and Mozilla have made great technological strides over the past decades. We're grateful for those efforts because they help us take the next step in browser evolution.

How fast is Orion?

We are... ahem.. fast.

How much memory does Orion use?

Orion is lightweight, with advanced memory-use technology that includes the best closed-tab management of all contemporary browsers.

How does Orion respect my online privacy?

Orion has no built-in telemetry, so it can never "phone home" and risk exposing your data. Orion is truly and verifiably a privacy-respecting browser — unlike those that only offer the illusion of privacy.

How does Orion protect my online privacy?

Web ads have steadily eroded the online experience with their layout crowding, page slowing, annoying popups, and insidious malware. Yet, most browsers do not block ads by default. Orion is different.

How do I clear cookies?

Go to Settings->Orion->Manage to search and clear individual site cookies OR Orion->Reset to reset ALL cookies, history, bookmarks, etc.

How does Orion support extensions?

Orion supports browser extensions based on open-standard WebExtensions APIs. These are the same APIs that power browser extensions for Chrome and Firefox. So, we support many of those extensions on macOS, iOS, and iPadOS.

Does Orion have an iPhone or iPad app?

Yep, Orion is available for both iOS and iPadOS.

Is there any way to get a previous build of Orion?

Yes, things don't always go as planned and mistakes can happen. If you ever need a previous version, you need to type a specific URL to get the version you want: https://browser.kagi.com/updates/{Current_OS}/{Orion_Beta_Version}.zip

Examples: Version 0.99.119-beta

• browser.kagi.com/updates/13_0/119.zip (Ventura)
• browser.kagi.com/updates/12_0/119.zip (Monterey)
• browser.kagi.com/updates/11_0/119.zip (Big Sur)
• browser.kagi.com/updates/10_15/119.zip (Catalina)
• browser.kagi.com/updates/10_14_0/119.zip (Mojave)

How to use Debug menu?

Orion's debug menu contains a number of commands that can be of interest to "advanced" users. To enabled Debug menu, type the following in terminal:

defaults write com.kagi.kagimacOS DebugMenu 1

If you use Orion RC (release candidate) replace with com.kagi.kagimacOS.RC.

When you relaunch Orion, you’ll find a new Debug menu, located to the right of the Help menu.

Test Web Page - Web Page for testing with default configuration and without any web-extension scripts

Reset Welcome Animation State - To reset welcome animation flag to see again on next launch

Reset Preferences - Reset all global settings

Clear Website Data - Remove all website data (cache, cookies etc)

Clear Content Blocking Lists - Remove Content Blocking List so that can be initialized again on next relaunch

Clear Policy Cache - Removes WebRequest APIs request/response blocking (from web-extensions like uBlock) cache

Disable Resource Interceptor - Bypass any requests/response interception (used by WebRequests API) to reduce request/response delay

Disable Reloading Tab on WebKit Crash - Disables auto reload feature of webpage when WebContent process crashes

Show Debug Log - Shows web-extension API console logs for testing/debug

Factory Reset - Wipe all data and reset Orion to factory settings

You can read more about Orion's advanced features in the technical documentation.

How do I access my Favorites via shortcuts (CMD + #)?

Open Preferences -> Browsing, uncheck "Use cmd1 - cmd9 to switch tabs".

Note that Orion uses Bookmarks bar that is separate from Favorites for more control, so you would need to copy bookmarks you want to the Bookmarks bar folder.

Orion is displaying wrong icons for Favorites and Frequently Visited pages — how can I fix that?

The easiest way to fix incorrect icons is to purge the websites cache. You can accomplish this with the following steps:

On iOS
Settings -> Data Management -> Clear History and Websites Data -> Toggle on Websites Cache -> Tap Clear.

On macOS
Develop -> Empty Cache.

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

Live stats

We have a very simple visualisation of Orion's active user count here.

Orion is zero telemetry so we do not know the actual number of users using it. This measures only the number of auto-update pings from users who have enabled auto updates and is the best first approximation we have.

Contributors

This entire documentation is open source and you can contribute by editing any page and creating a pull request. Check the instructions here.

The following contributors have helped improve Orion Browser documentation.

Thank you!

• Marc
• Zac
• Seth
• Alex Aidun
• Liam
• Vladimir Prelovac (vprelovac)
• MemeScreen
• laiz
• Aaron Graves

If you feel you're missing from this list, feel free to add yourself in a pull request.

Special thanks to mdBook for a wonderful markdown doc generator.

Kudos

The Kagi community is vibrant groups of passionate users who make us stronger.

We would like to thank the following individuals for their contributions.

Localazy Translations

Thank you to all our translators, our leaderboard is hosted below.