KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#developer-tools #codex #typescript #ai-agents #ai-agent #cli #claude-code #open-source #deepseek-harness #dsh-plugin #python #mcp

komoswitch

★ 12 Open GitHub ↗

A lightweight native Windows 11 workspace switcher widget for komorebi that integrates directly into the taskbar

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# komoswitch

A native Windows workspace switcher widget for [komorebi](https://github.com/LGUG2Z/komorebi) that integrates directly into your taskbar.

This is a lightweight alternative to [komorebi-switcher](https://github.com/amrbashir/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](https://raw.githubusercontent.com/tuasananh/komoswitch/main/assets/image-1.png)
![Image showcasing komoswitch on Windows 11 light mode](https://raw.githubusercontent.com/tuasananh/komoswitch/main/assets/image-2.png)

## 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](https://github.com/LGUG2Z/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](https://tuasananh.github.io/komoswitch/artifacts/).

### From Source

1. Clone the repository:
```bash
git clone https://github.com/kilkuwu/komoswitch.git
cd komoswitch
```

2. Build the application:
```bash
cargo build --release
```

3. Run the executable:
```bash
./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](https://github.com/LGUG2Z/komorebi) - The excellent tiling window manager this widget is designed for
- [winsafe](https://github.com/rodrigocfd/winsafe) - Safe Rust bindings for Windows API

komoswitch

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README