Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/sigoden/window-switcher
Easily switch between windows of the same app with Alt+` (Backtick), also switch between apps with Alt+Tab.
https://github.com/sigoden/window-switcher
rust windows windows-rs windows-switcher
Last synced: 1 day ago
JSON representation
Easily switch between windows of the same app with Alt+` (Backtick), also switch between apps with Alt+Tab.
- Host: GitHub
- URL: https://github.com/sigoden/window-switcher
- Owner: sigoden
- License: mit
- Created: 2022-02-26T12:18:17.000Z (almost 3 years ago)
- Default Branch: main
- Last Pushed: 2024-10-22T23:23:37.000Z (2 months ago)
- Last Synced: 2024-10-23T06:15:39.198Z (2 months ago)
- Topics: rust, windows, windows-rs, windows-switcher
- Language: Rust
- Homepage:
- Size: 274 KB
- Stars: 592
- Watchers: 7
- Forks: 23
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Window Switcher
Window-Switcher offers hotkeys for quickly switching windows on Windows OS:
1. ```Alt+`(Backtick)```: switch between windows of the same app.
2. ```Alt+Tab```: switch between apps. (disabled by default)
**💡 Hold down the `Alt` key and tap the ``` `(Backtick)/Tab ``` key to cycle through windows/apps, Press ```Alt + `(Backtick)/Tab``` and release both keys to switch to the last active window/app.**
## Installation
1. **Download:** Visit the [Github Release](https://github.com/sigoden/windows-switcher/releases) and download the `windows-switcher.zip` file.
2. **Extract:** Unzip the downloaded file and extract the `window-switcher.exe` to your preferred location.
3. **Launch:** `window-switcher.exe` is a standalone executable, no installation is required, just double-click the file to run it.
For the tech-savvy, here's a one-liner to automate the installation:
```ps1
iwr -useb https://raw.githubusercontent.com/sigoden/window-switcher/main/install.ps1 | iex
```
## Configuration
Window-Switcher offers various customization options to tailor its behavior to your preferences. You can define custom keyboard shortcuts, enable or disable specific features, and fine-tune settings through a configuration file.
To personalize Window-Switcher, you'll need a configuration file named `window-switcher.ini`. This file should be placed in the same directory as the `window-switcher.exe` file. Once you've made changes to the configuration, make sure to restart Window-Switcher so your new settings can take effect.
Here is the default configuration:
```ini
# Whether to show trayicon, yes/no
trayicon = yes
[switch-windows]
# Hotkey to switch windows
hotkey = alt+`
# List of hotkey conflict apps
# e.g. game1.exe,game2.exe
blacklist =
# Ignore minimal windows
ignore_minimal = no
# Only switch within the current virtual desktops: yes/no/auto
only_current_desktop = auto
[switch-apps]
# Whether to enable switching apps
enable = no
# Hotkey to switch apps
hotkey = alt+tab
# Ignore minimal windows
ignore_minimal = no
# Only switch apps within the current virtual desktops: yes/no/auto
only_current_desktop = auto
```
## Running as Administrator (Optional)
The window-switcher works in standard user mode. But only the window-switcher running in administrator mode can manage applications running in administrator mode.
**Important:** If you enable the startup option while running in standard user mode, it will launch in standard mode upon system reboot. To ensure startup with admin privileges, launch the window-switcher as administrator first before enabling startup.
## Hotkeys for non-English keyboard layouts
When using non-English keyboard layouts, standard keycodes might not match the expected keys, leading to functionality issues with hotkeys. To ensure your hotkeys work correctly, follow these guidelines:
1. **Visit kbdlayout.info**: Go to [http://kbdlayout.info/shortcut](http://kbdlayout.info/shortcut) and select your keyboard layout and desired keys. This will provide an image and detailed mapping.
2. **Keycode Mapping**: Use the keycodes provided to correctly map your hotkeys. Here are some standard keycodes:
https://github.com/sigoden/window-switcher/blob/55f00463318971fca79204fe7a4eb9592f659881/src/config.rs#L227-L324
3. **Customizing for Language-Specific Keyboards**:
- If your keyboard is in a language other than English, such as German, you may need to adjust the hotkeys. For example:
- Original hotkey: ``` alt+` ```
- Adjusted hotkey: `alt+|` or `alt+vk_oem_5`
4. **Test Your Hotkey Setup**: After configuring, test the hotkeys to ensure they perform the intended actions across different keyboard layouts.
By following these steps, you can adapt hotkeys for various non-English keyboard layouts, ensuring smooth functionality regardless of the language or region of your keyboard.
## License
Copyright (c) 2023-2024 window-switcher developers.
window-switcher is made available under the terms of the MIT License, at your option.
See the LICENSE files for license details.