https://github.com/alyraffauf/switchyard

Modern rules-based browser launcher and link redirector ready to replace your default browser.
https://github.com/alyraffauf/switchyard

browser flatpak gnome gtk4 libadwaita linux

Last synced: about 1 month ago
JSON representation

Modern rules-based browser launcher and link redirector ready to replace your default browser.

• Host: GitHub
• URL: https://github.com/alyraffauf/switchyard
• Owner: alyraffauf
• License: gpl-3.0
• Created: 2026-01-13T18:33:24.000Z (about 2 months ago)
• Default Branch: master
• Last Pushed: 2026-01-28T22:23:58.000Z (about 1 month ago)
• Last Synced: 2026-01-29T13:52:34.865Z (about 1 month ago)
• Topics: browser, flatpak, gnome, gtk4, libadwaita, linux
• Language: Go
• Homepage: https://switchyard.aly.codes/
• Size: 4.68 MB
• Stars: 59
• Watchers: 0
• Forks: 0
• Open Issues: 5
• Metadata Files:
  • Readme: README.md
  • Funding: .github/FUNDING.yml
  • License: LICENSE.md

Awesome Lists containing this project

README

          
[![CI](https://github.com/alyraffauf/switchyard/actions/workflows/ci.yml/badge.svg)](https://github.com/alyraffauf/switchyard/actions/workflows/ci.yml) [![License: GPL v3](https://img.shields.io/badge/License-GPL%20v3-blue.svg)](http://www.gnu.org/licenses/gpl-3.0) [![Ko-fi](https://img.shields.io/badge/Donate-Ko--fi-ff5e5b?logo=ko-fi&logoColor=white)](https://ko-fi.com/alyraffauf)



  

  
Switchyard

  
A rules-based browser launcher for Linux.





  





  



## Features

- **Browser rules**: Automatically open links in specific browsers based on conditions you define.

- **Link redirections**: Clean up links before they open—remove tracking parameters, swap domains, and more.

- **Quick launcher**: When no rule matches, choose a browser with a click or keyboard shortcut.

- **Lightweight**: Runs only when you click a link. No background processes.

- **GTK4 + libadwaita**: Native GNOME look and feel.

## Installation

### Flatpak (Recommended)

Switchyard is available on [Flathub](https://flathub.org/apps/io.github.alyraffauf.Switchyard):

```bash

flatpak install flathub io.github.alyraffauf.Switchyard

```

### Nix Flake

```bash

nix run github:alyraffauf/switchyard

```

### Building from Source

For non-Flatpak builds, requires Go 1.24+, GTK4/libadwaita development libraries, and [just](https://github.com/casey/just).

```bash

just install-deps # For Fedora

just build

sudo just install # To /usr/local

```

#### Building Flatpak

```bash

just flatpak # Build and install

```

## Documentation

- [Using](docs/Using.md) - Set as default browser, usage examples.

- [Configuration](docs/Configuration.md) - Config file format, rules, and settings.

- [URI Scheme](docs/URI%20Scheme.md) - Custom `switchyard://` URLs for specifying browser preferences.

- [Prior Art](docs/Prior%20Art.md) - Similar tools that inspired Switchyard.