[![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) [![Firefox](https://img.shields.io/amo/v/switchyard?logo=firefox-browser&logoColor=white&label=Firefox)](https://addons.mozilla.org/firefox/addon/switchyard/) [![Chrome](https://img.shields.io/chrome-web-store/v/ncehhpikkabfdcceimdhjjjodogflokc?logo=googlechrome&logoColor=white&label=Chrome)](https://chromewebstore.google.com/detail/switchyard/ncehhpikkabfdcceimdhjjjodogflokc)

<div align="center">
  <img width="128" height="128" src="data/icons/hicolor/scalable/apps/io.github.alyraffauf.Switchyard.svg" alt="Switchyard Icon">
  <h1>Switchyard</h1>
  <h3>A rules-based browser launcher for Linux.</h3>
</div>

<p align="center">
  <img src="data/screenshots/launcher.png" alt="Switchyard Launcher" width="600">
</p>

<p align="center">
  <a href="https://flathub.org/apps/io.github.alyraffauf.Switchyard"><img src="https://flathub.org/api/badge?locale=en&style=flat" alt="Get it on Flathub"></a>
</p>

## 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.
- **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
```