# virgo

**Repository Path**: liuweig/virgo

## Basic Information

- **Project Name**: virgo
- **Description**: virgo的改良版，支持多显示器
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2025-09-27
- **Last Updated**: 2025-10-01

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

virgo
=====
Virtual Desktop Manager for Windows


Features:
- resource friendly: the executable is under 10 KB on disk and uses less than 1 MB of memory while running
- 4 virtual desktops by default (increase the constant and rebuild if you need more)
- tray icon shows the number of the desktop you are currently on
- each monitor keeps its own active desktop so multi-display setups stay independent
- single-monitor setups no longer snap back to desktop 1 after switching
- supports up to 8 monitors out of the box (`MAX_MONITORS`), tweak the constant and rebuild for more
- tray icon menu lets you toggle taskbar behavior and open the hotkey configuration window

Hotkeys (priority is given to the monitor under the mouse cursor; if that fails, the focused window's monitor is used):

        ALT + 1..4             -> change the current monitor to desktop 1..4
        CTRL + 1..4            -> move the active window to desktops 1..4 on its monitor
        ALT + CTRL + SHIFT + Q -> exit the program
        ALT + CTRL + SHIFT + S -> start/stop handling of other hotkeys

Hotkeys are configurable: right-click the tray icon -> **Configure hotkeys...** -> click a button and press the new combination. If a conflict occurs, the program prompts you to choose another combination until registration succeeds.

Tray menu:

- **Show windows from all desktops**: when enabled, windows from every desktop appear minimized on the taskbar. Clicking a window from another desktop automatically switches to that desktop; disable the option to show only the current desktop's windows.
- **Configure hotkeys...**: open the hotkey configuration window.
- **Exit**: quit the program.

The tray icon displays a value such as "1/2" to show the active desktop for each monitor.

Configuration file:

- the program creates/reads `virgo.cfg` in the executable directory to persist hotkeys and the "Show windows from all desktops" toggle
- settings are loaded on startup and saved immediately after changing them through the tray menu or the hotkey configuration dialog
- delete the file to return to the default hotkeys and taskbar behavior

Build instructions:

        git clone https://gitee.com/liuweig/virgo
        cd virgo
        make

If gcc/make aren't available yet, follow these steps to install the toolchain and build:

1. Download MSYS2 from http://msys2.github.io/
2. Open an MSYS2 shell and install mingw-w64-i686-gcc and mingw-w64-i686-make using pacman:

```pacman -S mingw-w64-i686-gcc```

```pacman -S mingw-w64-i686-make```

3. Rename `C:\\msys32\\mingw32\\bin\\mingw32-make.exe` to `make.exe`.
4. Update your PATH as needed, then run `make` inside the virgo directory to build the project.