⚡ wswitch Switcher

2026-01-31.13-40-45.mp4

This is a fork of the snappy-switcher.

A blazing-fast, Alt+Tab window switcher for wayland compositors

The window switcher that actually understands your workflow.

---

🖥️ Compatible Compositors

wswitch works with any Wayland compositor that implements the foreign-toplevel protocol, such as Mango, Sway, and more.

📦 Installation

Arch Linux (AUR)

Using Yay yay -S wswitch

Using Paru paru -S wswitch

📦 Build from PKGBUILD

git clone https://github.com/DreamMaoMao/wswitch.git
cd wswitch
makepkg -si

Manual Build

📋 Dependencies

Package	Purpose
wayland	Core protocol
cairo	2D rendering
pango	Text layout
json-c	IPC parsing
libxkbcommon	Keyboard handling
glib2	Utilities
librsvg	SVG icons (optional)

Install dependencies (Arch):

sudo pacman -S wayland cairo pango json-c libxkbcommon glib2 librsvg

# Build
make

# Install system-wide
sudo make install PREFIX=/usr

---

🚀 Quick Start

1️⃣ Setup Configuration

wswitch-install-config

This copies themes and creates ~/.config/wswitch/config.ini.

2️⃣ Add to Mango Config

Add these lines to ~/.config/mango/config.conf:

# Start the daemon on login
exec-once = wswitch --daemon

# Keybindings
bind=Alt,Tab,spawn,wswitch next

3️⃣ You're Done! 🎉

reloagin your session and Press Alt + Tab to see it in action.

---

🎯 Change Theme

Edit ~/.config/wswitch/config.ini:

[theme]
name = catppuccin-mocha.ini

---

⚙️ Configuration

Details

# ~/.config/wswitch/config.ini

[general]
# overview = Show all windows individually
# context  = Group tiled windows by workspace + app class
mode = context

[theme]
name = wswitch-slate.ini
border_width = 2
corner_radius = 12

[layout]
card_width = 160
card_height = 140
card_gap = 10
padding = 20
max_cols = 5
icon_size = 56

[icons]
theme = Tela-dracula
fallback = hicolor
show_letter_fallback = true

[font]
family = Sans
weight = Bold
title_size = 10

---

🧪 Available Commands

Command	Description
wswitch --daemon	Start background daemon
wswitch next	Cycle to next window
wswitch prev	Cycle to previous window
wswitch toggle	Show/hide switcher
wswitch hide	Force hide overlay
wswitch select	Confirm current selection
wswitch quit	Stop the daemon

---

💡 Credits & Inspiration

Project	Contribution
snappy-switcher	Massive inspiration for the design of the window switcher

---

_{Licensed under GPL-3.0}