Check out our GitHub!

komoswitch

komoswitch

A native Windows workspace switcher widget for komorebi that integrates directly into your taskbar.

This is a lightweight alternative to komorebi-switcher (using ~2MB of RAM, about 10x less), supporting multi-monitor setups and dynamic taskbar sizes.

Showcase

Image showcasing komoswitch on Windows 11 dark mode Image showcasing komoswitch on Windows 11 light mode

Features

  • Multi-Monitor Support: Works seamlessly across multiple monitors and taskbars
  • Adaptive Sizing: Scales properly for different taskbar sizes
  • Taskbar Integration: Seamlessly embeds into the Windows taskbar
  • Live Workspace Display: Shows all workspaces with real-time updates
  • Visual Status Indicators: Different colors for focused, empty, and occupied workspaces
  • Layout Awareness: Special indicators for monocle and maximized windows
  • Container Navigation: Visual container navigation for scrolling layouts
  • Click to Switch: Click on any workspace bar to instantly switch to it
  • Theme Aware: Automatically adapts to Windows light/dark theme
  • Right-click Menu: Right click to quit
  • Komorebi Active State: Show if Komorebi is currently paused

Prerequisites

  • Windows 10/11
  • komorebi window manager running
  • Rust toolchain (for building from source)

Installation

Pre-built Installers (Recommended)

The easiest way to install komoswitch is via the pre-built binaries generated by Oranda. You can find pre-compiled installers (MSI), ZIP archives, and a quick PowerShell install script on the komoswitch Install Page.

From Source

  1. Clone the repository:
git clone https://github.com/kilkuwu/komoswitch.git
cd komoswitch
  1. Build the application:
cargo build --release
  1. Run the executable:
./target/release/komoswitch.exe

Usage

Once launched, komoswitch will:

  1. Embed in Taskbar: The widget appears on the left side of your taskbar
  2. Show Workspaces: Each workspace is displayed as a numbered button
  3. Visual Feedback:
    • Blue/Accent: Currently focused workspace
    • Gray: Workspaces with windows
    • Light Gray: Empty workspaces
    • Pink: Monocle mode indicator
    • Purple: Maximized window indicator

Interactions

  • Left Click on a workspace bar: Switch to a workspace
  • Right Click on a workspace bar: Open context menu to quit the application

Container Navigation

For workspaces using scrolling layout with multiple containers, komoswitch displays:

  • Current container number (highlighted)
  • Previous/next container numbers
  • Dots indicating additional containers

Configuration

komoswitch automatically:

  • Detects Windows theme (light/dark mode)
  • Adjusts colors accordingly
  • Uses system accent colors for focused workspace
  • Responds to system theme changes in real-time

Logging

In debug builds, the application provides detailed logging. Set RUST_LOG=debug for verbose output.

Contributing

  1. Fork the repository
  2. Create a feature branch
  3. Make your changes
  4. Test thoroughly
  5. Submit a pull request

License

This project is licensed under the MIT License - see the LICENSE file for details.

Acknowledgments

  • komorebi - The excellent tiling window manager this widget is designed for
  • winsafe - Safe Rust bindings for Windows API