Switchy
Every link. Your choice. Zero friction.
The lightning-fast browser picker for Windows that routes URLs exactly where you want them โ every single time.
Why Switchy?
You open Chrome for work, Firefox for personal browsing, Edge for that one internal app, and Brave for everything else.
But Windows lets you pick only one default browser โ and every link goes there, no matter what.
Switchy fixes that.
Click any link โ Switchy intercepts it โ a sleek, acrylic-glass picker floats up in under a second โ you tap a key and
it's open in exactly the right browser. You can even teach Switchy rules so work URLs go straight to Chrome, your team's
Notion links open in Firefox, and everything else still asks you. Pure control, zero compromise.
Showcases
Features
- Instant browser picker โ frameless, always-on-top acrylic window appears the moment a link is clicked; dismiss
with
Esc or pick with 1โ9
- Two layout modes โ vertical list or horizontal dock; switch in settings
- Timed auto-selection โ optional countdown that opens your default browser automatically if no key is pressed;
timer and duration are configurable
- Smart URL rules โ domain (
d$), regex (r$), and substring (s$) patterns auto-open URLs without asking; force
the picker with _Switchy
- Alternate browser profiles โ launch a browser's incognito or work-profile variant directly from the picker
- Single-instance IPC โ a second click forwards its URL to the running picker over a named pipe; no double windows
- Native Windows feel โ Acrylic backdrop on the picker, Mica on settings, frameless with custom drag region; looks
right at home on Windows 11
- Auto-detect browsers โ scans
StartMenuInternet registry to find every installed browser in seconds
- Icon extraction โ rasterizes browser icons directly from executable resources at configurable sizes (16โ256 px)
- Settings persist โ all configuration saved to
%APPDATA%\Switchy\settings.json
Project Structure
switchy/
โโโ main.go # Entry point & CLI modes (--register, --unregister, --settings)
โโโ app.go # Wails-bound App struct โ the frontend โ backend bridge
โโโ go.mod / go.sum
โโโ wails.json
โโโ .golangci.yml # golangci-lint configuration
โ
โโโ internal/ # Private Go packages
โ โโโ browser/
โ โ โโโ launch.go # Launch browsers; DetectInstalled via registry; FilterLegacyIE
โ โ โโโ icon_windows.go # Extract & rasterize HICON โ base64 PNG (shell32/gdi32)
โ โโโ config/
โ โ โโโ service.go # Load / Get / Save / Invalidate settings; schema migration
โ โ โโโ types.go # UserSettings, Browser, AlternateLaunch, Ruleset, Rule, AppSettings
โ โโโ ipc/
โ โ โโโ pipe.go # Named-pipe single-instance IPC (go-winio, \\.\pipe\SwitchyPipe)
โ โโโ registry/
โ โ โโโ registry.go # Register / Unregister Switchy as Windows default browser
โ โโโ rules/
โ โโโ matcher.go # URL-to-browser rule engine (domain / regex / substring)
โ
โโโ frontend/ # Vue 3 + TypeScript + Tailwind CSS
โ โโโ eslint.config.js # ESLint 9 flat config (TS + Vue + Prettier-compat)
โ โโโ .prettierrc.json # Prettier config (no-semi, single-quote, Tailwind class sort)
โ โโโ .prettierignore
โ โโโ src/
โ โโโ App.vue # Root router โ renders SelectorView or SettingsView
โ โโโ types.ts # Frontend type definitions (mirrors Go structs)
โ โโโ views/
โ โ โโโ SelectorView.vue # Browser picker (vertical list or horizontal dock)
โ โ โโโ SettingsView.vue # Configuration hub (browsers, rulesets, app settings)
โ โโโ components/
โ โ โโโ BrowserList.vue # Vertical stacked browser list
โ โ โโโ BrowserButton.vue # Single row item with icon, name, shortcut
โ โ โโโ BrowserDock.vue # Horizontal dock layout
โ โ โโโ BrowserDockTile.vue # Single dock tile with large icon and keycap badge
โ โ โโโ UrlCard.vue # URL display with protocol icon and copy button
โ โ โโโ BrowserEditor.vue # Browser config row in settings
โ โ โโโ RulesetEditor.vue # Ruleset config row in settings
โ โโโ composables/
โ โ โโโ useBrowserIcon.ts # Async icon loader (calls GetBrowserIconAt backend)
โ โโโ utils/
โ โโโ browser.ts # Shortcut key helpers, animation delay calculations
โ โโโ config.ts # Layout / overflow value normalizers
โ
โโโ build/ # Wails build assets
โ โโโ appicon.svg # Source logo โ regenerate appicon.png / icon.ico from this
โ โโโ appicon.png # 1024ร1024 app icon (used by Wails build)
โ โโโ windows/
โ โโโ icon.ico
โ โโโ info.json # Product metadata (version, company, copyright)
โ โโโ wails.exe.manifest
โ โโโ installer/
โ โโโ installer.iss # Inno Setup 6 script โ Switchy_Installer.exe
โ โโโ project.nsi # NSIS script (wails build --nsis)
โ
โโโ scripts/
โโโ build.ps1 # Full release build: Wails โ switchy.exe โ Inno Setup installer
Prerequisites
| Tool |
Version |
Install |
| Go |
1.25+ |
go.dev/dl |
| Wails CLI |
v2 |
go install github.com/wailsapp/wails/v2/cmd/wails@latest |
| Node.js |
18+ |
nodejs.org |
| golangci-lint |
latest |
go install github.com/golangci/golangci-lint/cmd/golangci-lint@latest |
| Inno Setup |
6 |
jrsoftware.org (installer only) |
Development
# From the switchy/ directory โ hot-reload on both Go and Vue changes
wails dev
Go methods are also exposed as a dev server at http://localhost:34115 so you can call them from the browser DevTools.
Code Quality
Frontend
cd frontend
npm run lint # report ESLint issues
npm run lint:fix # auto-fix what's fixable
npm run format # format all src files with Prettier
npm run format:check # CI-safe Prettier check (no writes)
Go
# Format
gofmt -w .
# Vet
go vet ./...
# Full lint (requires golangci-lint)
golangci-lint run ./...
Building
Executable only
wails build -platform windows/amd64
# โ build/bin/switchy.exe
Full release (exe + Inno Setup installer)
.\scripts\build.ps1
# โ build/bin/Switchy_Installer.exe
Register as Default Browser
After building or installing, run once:
.\build\bin\switchy.exe --register
Windows will open Default apps settings โ scroll to Web browser and select Switchy to complete the setup. (
Windows 10/11 requires this manual confirmation step; no app can bypass it.)
To remove Switchy from the registry:
.\build\bin\switchy.exe --unregister
URL Rule Patterns
Rules are evaluated in order across enabled rulesets. The first match wins.
| Prefix |
Type |
Example |
Matches |
d$ |
Domain |
d$example.com |
example.com and *.example.com |
r$ |
Regex |
r$^https://work\. |
Full URL matched against regex |
s$ |
Substring |
s$/confluence/ |
URL contains the string |
| (none) |
Substring |
github.com |
Same as s$ |
Set a rule's browser target to _Switchy to force the picker even when other rules would match.
CLI Flags
| Flag |
Effect |
| (no flag, with URL argument) |
Open the browser picker for the given URL |
--register |
Write Windows registry entries and open Default Apps settings |
--unregister |
Remove Switchy registry entries |
--settings |
Open the settings window |
Inspiration
Switchy is lovingly inspired by Hurl โ a fantastic open-source browser picker for
Windows that proved the concept beautifully.
Switchy builds on that idea with a Wails-powered UI, native-pipe IPC, URL rule matching, and alternate browser
profiles.
Huge respect to the Hurl team for laying the foundation.
Agent Context
This repository uses agent-context to generate and maintain its
AI-agent context files (e.g., AGENTS.md). If you're working on Switchy with an AI assistant, those files provide the
grounding architecture, conventions, and module map needed to navigate the codebase effectively.
License
MIT