switchyard
Rules-based browser launcher for TUI + GNOME. switchyard.aly.codes
tui gnome bowser go
Star 1
Fork 0
Watch
switchyard website src content docs using.md
1.2 kB · 26 lines
Markdown
at master

title: Using Switchyard description: Learn what Switchyard does and how to start routing links. order: 10 #

Switchyard is a powerful, rules-based browser launcher. Once it is set as your default browser, clicked links pass through Switchyard first. It can then open the link in a specific browser, ask you which browser to use, or rewrite the URL before opening it.

Use it when different parts of your life live in different browsers: work links in Chrome, personal links in Firefox, video links in Brave, or to add privacy-friendly redirects before anything opens.

The basic flow is:

  1. Set Switchyard as your default browser.
  2. Add browser rules for domains, keywords, globs, or regular expressions.
  3. Optionally add link redirections to clean up or rewrite URLs.
  4. Let Switchyard route links automatically, or show the launcher when no rule matches.

Set as Default Browser #

After installation, set Switchyard as your default browser so it can route all clicked links:

xdg-settings set default-web-browser io.github.alyraffauf.Switchyard.desktop

Or use your desktop environment's graphical settings to set Switchyard as the default browser.