https://github.com/snolab/CapsLockX
Manipulate your computer like a hacker! 像黑客一样操作电脑！
https://github.com/snolab/CapsLockX
ahk ahk-scripts capslock capslock-enhancement capslockx tab-wasd wasd
Last synced: 2 months ago
JSON representation
Manipulate your computer like a hacker! 像黑客一样操作电脑！
- Host: GitHub
- URL: https://github.com/snolab/CapsLockX
- Owner: snolab
- License: gpl-3.0
- Created: 2017-06-09T11:06:11.000Z (about 8 years ago)
- Default Branch: main
- Last Pushed: 2024-10-29T21:43:34.000Z (8 months ago)
- Last Synced: 2024-10-29T23:47:51.068Z (8 months ago)
- Topics: ahk, ahk-scripts, capslock, capslock-enhancement, capslockx, tab-wasd, wasd
- Language: AutoHotkey
- Homepage: https://snolab.github.io/CapsLockX/
- Size: 210 MB
- Stars: 249
- Watchers: 9
- Forks: 24
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE.md
- Code of conduct: CODE_OF_CONDUCT.md
- Security: SECURITY.md
- Roadmap: docs/Roadmap.md
Awesome Lists containing this project
README
# CapsLockX - 💻 Get Hacker's Keyboard. Operate your computer like a **hacker**
CapsLockX is a modular hotkey script engine based on AutoHotkey. It allows you to operate your computer efficiently like a hacker in a movie without ever taking your hands off the keyboard. It comes packed with functions that are intuitive and easy to use: enhanced editing, virtual desktop and window management, mouse simulation, in-app hotkey enhancement, JS mathematical expression calculation, and many more multifunctional features are there for you to personally customize.
Here is a tiny online demo to show you the feeling how WASD Mouse + HJKL Keyboard works - [Try CapsLockX](https://snomiao.github.io/capslockx.js/)
Docs in Languages:
**[English Docs (ChatGPT Translated)](https://capslockx.snomiao.com/)**
**[简体中文 説明](./docs/README.zh.md)**
**[See Any Language Docs (Google Translated)](https://capslockx.snomiao.com/)**
---
## Badges Wall 📛 Badges
[](https://github.com/Program-in-Chinese/overview),
[](https://996.icu)
[](https://github.com/snolab/CapsLockX/blob/master/LICENSE.md)
[](https://github.com/snolab/CapsLockX/stargazers)
[](https://github.com/snolab/CapsLockX/actions/workflows/gh-pages-release.yml)
[](https://www.jsdelivr.com/package/gh/snolab/capslockx)
[](https://www.npmjs.com/capslockx)
[](https://github.com/snolab/CapsLockX/actions/workflows/npm-publish.yml)
[](https://community.chocolatey.org/packages/CapsLockX/)
[](https://github.com/snolab/CapsLockX/actions/workflows/choco-push.yml)
[](https://community.chocolatey.org/packages/CapsLockX/)
---
## Why?
CapsLockX was created to address several common frustrations that many computer users face on a daily basis. Here are some of the main reasons why CapsLockX exists:
1. **Efficient Window Management**: Modern computer usage often involves juggling multiple windows and virtual desktops, especially for professionals working on complex projects. CapsLockX provides intuitive hotkeys for managing virtual desktops and windows, making it easy to switch between tasks seamlessly without losing focus.
2. **Enhanced Text Editing**: Moving between the typing area and the editing control area can be cumbersome, especially for heavy typists or programmers. CapsLockX introduces Vim-like keybinds and other enhancements that allow for efficient text navigation and editing directly from the keyboard.
3. **Mouse Simulation**: Constantly switching between the keyboard and the mouse can disrupt workflow and lead to repetitive strain injuries (RSI). CapsLockX solves this by enabling comprehensive mouse emulation using the keyboard, allowing users to perform mouse actions with simple key combinations.
4. **Streamlined Shortcut Management**: Different applications often have their own sets of shortcuts, which can be hard to remember or inefficiently placed. CapsLockX provides a unified way to enhance and customize hotkeys within various applications, allowing for a more cohesive and efficient working environment.
5. **Mathematical Expression Calculation**: For users who frequently need to perform calculations, CapsLockX offers a way to quickly evaluate JavaScript mathematical expressions directly from the keyboard, streamlining workflows that involve frequent calculations.
6. **Multifunctional Customization**: CapsLockX is modular and highly customizable, allowing users to tailor the hotkey scripts to their specific needs. Whether you need specific functions for coding, writing, designing, or managing tasks, CapsLockX can be adapted to meet those requirements.
7. **Portable and Open Source**: CapsLockX is designed to be a portable tool that can be easily transferred and used across different systems. As an open-source project, it also provides transparency and community-driven improvements, ensuring that the software remains secure and continuously enhanced.
In summary, CapsLockX aims to make computer interaction more efficient, ergonomic, and customized to individual workflows, helping users operate like a **hacker** in movies, quickly achieving their tasks without breaking concentration.
## Beginner's Quick Start Tutorial 📖 Tutorial
### Simple Quick Start Tutorial (Completion of this section is considered the beginning of mastering CapsLockX)
CapsLockX has four core functions: **window management**, **mouse emulation**, **arrow key emulation**, and application-specific hotkeys. This beginner tutorial will teach you the first three core functions.
First, get CapsLockX: download this zip file: [Download JSDelivrCDN - Release Package.zip](https://cdn.jsdelivr.net/gh/snolab/CapsLockX@gh-pages/CapsLockX-latest.zip)
After unzipping, open `CapsLockX.exe` within the CapsLockX folder, get past the simple beginner tutorial, and then try out the following functions in the left and right-hand feature areas to understand the capabilities of CapsLockX.
Once CapsLockX is started, it will **not affect** the functionality of other keys on your keyboard. The following features are triggered only when you press `CapsLockX + combination keys`.
Left-hand feature area:
- Window management: `CapsLockX + 1234567890` switches to the `n`th virtual desktop, `CapsLockX + ZXCV` for window operations (window switching, window closing, window arranging, transparency top-most).
- Mouse emulation function: Press `CapsLockX + WASD` to move the mouse (as simple as moving a character while playing a game), press `CapsLockX + QE` for left and right mouse clicks, `CapsLockX + RF` for scrolling up and down.
Right-hand feature area:
- Arrow key emulation: Open any text editor (such as Notepad), press `HJKL` to move the cursor, `YOUI` to move the page
After familiarizing yourself with the basic features, consult the quick reference guide below for more advanced functionalities.
---
## Advanced Reference Manual 🦽 Manual
### Installation and Use 🛠 Installation
#### Portable Program Package (for beginners, stable version) 📦 Packaged Bins
The source code package is the software itself, no need to compile, just unzip and use the green portable software. Source code + program package, the first one is recommended (the fastest).
1. [Download JSDelivrCDN - Release Package.zip](https://cdn.jsdelivr.net/gh/snolab/CapsLockX@gh-pages/CapsLockX-latest.zip)
2. [Alternative Download CloudFlareCDN - Release Package.zip](https://capslockx.snomiao.com/CapsLockX-latest.zip)
3. [Alternative Download GitHub - Release Package.zip](https://github.com/snolab/CapsLockX/raw/gh-pages/CapsLockX-latest.zip)
4. [Alternative Download GitHub - Repository Program Package.zip](https://github.com/snolab/CapsLockX/archive/master.zip)
5. [Alternative Download BitBucket - Repository Program Package.zip](https://bitbucket.org/snomiao/capslockx/get/master.zip)
6. [Alternative Download for Mainland China Users - Gitee - Repository Program Package.zip (login required)](https://gitee.com/snomiao/CapslockX/repository/archive/master.zip)
You can use it after unzipping. Methods to start and set to auto-start: Double-click `CapsLockX.exe` to start the script. To add a startup item, enter shell:startup in the start menu - run, then create a shortcut for this program, and throw it in.
#### Command Line Installation (recommended for advanced users, can be updated automatically) 🖥️ Install by command
Choose any of the following, the 4th one is recommended for users in mainland China
1. `npx capslockx@latest`, -- Directly run with NPX, always run the latest version, recommended (requires installation of NodeJS)
2. `choco update capslockx && capslockx` -- Use [Chocolatey](https://community.chocolatey.org/packages/CapsLockX/) to install and use cup for automatic updates, recommended
3. `npm i -g capslockx && npx capslockx` -- npm global installation
4. `git clone https://gitee.com/snomiao/CapslockX && .\CapsLockX\CapsLockX.exe` -- Mainland China source code package (green software package) unzip and use, recommended for mainland China users
5. `git clone https://github.com/snolab/CapsLockX && .\CapsLockX\CapsLockX.exe` -- GitHub source code package (green software package) unzip and use
6. `winget capslockx` -- TODO #40
7. `scoop capslockx` -- TODO #41
## User Manual 📖 - Usage Manual
### Basic Operations
- Hold down `CapsLockX` to enter CapsLockX mode, at which point your keyboard will become a functional keyboard like the default mode of Vim (see key positions below).
- Press `CapsLockX+Space` at the same time to lock `CLX` mode, where `CLX` will be maintained until `CapsLockX` is pressed again next time. [Origin of Function](https://github.com/snolab/CapsLockX/issues/21)
### Module Description
CapsLockX by default loads some commonly used modules. The features and how to use them are listed below.
If you don't need certain modules, you can also directly delete the `.ahk` files in the `./Modules` directory, and then press `Ctrl + Alt + \` to reload.
You can also write your own `my-ahk.user.ahk` and put it in the `./User/` directory, and CapsLockX will automatically recognize and load them.
### Nightmares of Multitasking
#### Virtual Desktop Overview: Scenario Modes, Work Desks, Entertainment Desks, Project Categories...
Typically, a set of tasks a user is currently performing will include multiple windows. These windows combined can constitute a usage scenario, while multiple scenarios are likely to run at the same time, and some of them will run for a long time, without interference. This will involve a lot of window arrangement and virtual desktop switching operations, in these aspects, using CLX to manage your windows will bring a terrifying efficiency improvement.
Below are some examples of scenario combinations: Suppose you can study, work on several different jobs, chat with friends, play games, listen to BGM in the background, and have a paused movie ready to watch with family in the evening.
- Virtual desktop 1: Planning scenario: Schedule window + Multi-platform sync notes, e.g.: Google Calendar + Notion + Gmail.
- Virtual desktop 2: Learning scenario: Book reading window, note-taking window, e.g.: OneNote + Calibre, etc.
- Virtual desktop 3: Work scenario 1 (Front-end Development): Code editing + Documentation querying + Browser, e.g.: Chrome(dev) + VSCode + [stackoverflow](https://stackoverflow.com), etc.
- Virtual desktop 4: Work scenario 2 (Back-end Development): Code editing + Documentation querying + Backend terminal + Database browser, e.g.: DBeaver + VSCode(+bash) + [stackoverflow](https://stackoverflow.com), etc.
- Virtual desktop 5: Work scenario 3 (Script Development): Code editing + Documentation querying + Script target, e.g.: VSCode(+bash) + [stackoverflow](https://stackoverflow.com) etc.
- Virtual desktop 6: Work scenario 4 (3D Modeling and Rendering): 3D modeling software + Material searching, e.g.: Blender + Chrome.
- Virtual desktop 7: Work scenario 5 (3D Printing Slicing): Slicing software + Model searching window, e.g.: Cura + [thingiverse](https://thingiverse.com)
- Virtual desktop 7: Work scenario 6 (Video Processing): Editing + Material management, e.g.: PR + Everything.
- Virtual desktop 7: Work scenario 7 (Video Processing): Post-production + Documentation tutorial, e.g.: AE + Chrome.
- Virtual desktop 8: Writing scenario: Writing window, material referencing window, e.g.: Obsidian + Chrome (Google Scholar Index), etc.
- Virtual desktop 9: Communication scenario 1: Casual chats, e.g.: Telegram + Reddit + .
- Virtual desktop 9: Communication scenario 2: Work communication, e.g.: Slack + Skype + Gmail.
- Virtual desktop 9: Communication scenario 3: Presentation, e.g.: Google Meeting + (Vscode | Page application | Requirements document | Feedback document).
- Virtual desktop 0: Entertainment scenario 1: Playing games, e.g.: Age of Empires, Minecraft, Skyrim, Overcooked 2, etc.
- Virtual desktop 0: Entertainment scenario 3: Watching movies, listening to songs, e.g.: PotPlayer, Youtube Music, etc...
- ... More examples are welcome. Provide Issues or PRs for supplementation.
Snowstar does not recommend you handle too many tasks at the same time, but CapsLockX can save your thinking environment, greatly reducing the mental cost you incur during task switching, that is, saving you a lot of time rearranging windows and the resulting loss of attention.
(Note: If you like to handle many tasks at the same time, you might need not only a computer with not a small amount of memory but also a brain of significant capacity :D )
#### Enhancing the User Experience of Windows Window Switching - Win+Tab
When switching windows with Alt+Tab, if there are too many windows, a two-dimensional window pre-arrangement display will show up.
Generally speaking, Alt+Tab and Alt+Shift+Tab are purely left-handed keystrokes. If the user wants to select the window in the next line, they will instinctively press Alt+Tab many times.
However, the directional keys used for two-dimensional operations are often ignored because the right hand is usually on the mouse or on the J key.
Also, users will continue to hold down the Alt key after releasing the Tab key to browse the windows and select the target window to switch to.
In CLX, Alt+WASD will be used instead of the arrow keys to perform multiline window switching directly with the left hand, so there is no need to press Shift to go back to the left.
Moreover, if a user needs to clean up or close multiple windows, they simply press Alt+X to batch clean multiple target windows while remaining within the window browsing interface.
In CLX, these features greatly improve the usability of Alt+Tab.
## TODO-Docs
Click to expand TODO-docs
#### Focus count: Active window, default active window, …
Each desktop has only one active focus window, and the virtual desktop can achieve automatic switching to the focus window of that virtual desktop when switching to it, achieving multiple task focuses (i.e., active windows).
#### Utilizing Multiple Screens - Multi-screening
#### Window Arrangement in the Era of 4K - Window arrange with 4k screen
Default window arrangement limitations in Windows 10:
1. Not applicable to multiple desktops.
2. Unnecessary window gaps are too large.
##### Window Management on Linux and Mac - Window Manager in Linux and mac
TODO: i3 Window Management
##### Window Management on Android and iOS - Window Manage in android
Two system-level solutions: Left-right top-bottom split screen, floating windows; Application level: floating components,
### Troubles with Editing Operations
#### The Distance Between the Typing Area and Editing Control Area
TODO Discussion on ThinkPad and Mac arrow keys, inspiration from VIM,
### Human Perception of Speed
TODO: World perception of exponential growth, focus, auditory, visual, tactile, VS conventional linear operations
### Troubles with the Graphical User Interface
TODO: Document: Introduction to mouse simulation function, movement in RPG games
### Shortcut Deficiencies in Software
TODO: Application enhancement module introduction
### The Usability of Portable Keyboards
TODO: FN key, arrow keys, editing operations, 61-key layout vs 87-key layout,
#### The Concept of Chording
TODO Various types of chording
TODO Calculation of information quantity increase with chording
## Module Helps
### Help Module
If you want to learn how to develop plugins for CapsLockX, please:
1. Open `Modules/@Help.ahk`, where you can learn about the basic format of a CapsLockX plugin
2. Make a copy of it and name it as your own plugin
3. Change its original functions to the ones you need, and your plugin development is complete!
#### Features of this module are as follows
| Applied to | Key | Function |
| ---------- | ------------------ | --------------------------------------------- |
| Global | CapsLockX + / | Temporarily display hotkey hints |
| Global | CapsLockX + Alt + /| 🔗 Open the complete CapsLockX documentation page |
| Global | CapsLockX + Shift + / | 🕷 Submit bugs, suggestions, etc. |
### Anki Enhancement Module
Enhanced Anki Operations
#### Common Features
1. Use WASD or HJKL to quickly and continuously (and with the ability to undo) switch flashcards.
2. Create a word list in Excel with 2 columns, select all and copy, then press Alt + i in Anki to quickly import the word list.
3. Simplify the 4 options to 3 direction keys: left-easy, down-medium, right-hard, up-undo.
4. Can be used with a game controller by configuring the joystick to map to direction keys using XPadder. For effects, see bilibili [Chuunibyou Xue Xing's Word Memorization with a Game Controller!](https://www.bilibili.com/video/av8456838/)
#### Instructions
| Mode | Anki Enhancement Module | Description |
| --------------------- | :---------------------: | ------------------------------------------------------------ |
| In Anki-Learning Interface | `w or k or ↑`
### OneNote 2016 - 2019 Enhancement
Enhance keyboard operations for OneNote 2016 - 2019 simply, conveniently using the keyboard to: change pens, create links, organize pages, adjust views...
#### Common Features by Snow Star
1. When logging, first add a date tag to the note title on the note page with `Alt + T` (for future search), then globally `Win + Shift + N` to search all notes with today's tag in OneNote, for easy retrieval of today's: love diary, training log, daily book list, project daily report... In short, writing diaries in OneNote is very convenient, just one press, no need to search XD
2. Select a word and press `Alt + K`, which will list links to all related pages below this word, to make an index directory and weave your OneNote into a web.
3. Create a new note and rename it "My Clipboard," then when copying text or images, CLX will automatically append it to this note for easy gathering of materials or excerpting articles.
4. Alt + 1234567 level folding, easily switch between different levels of abstraction in thinking.
#### Key Distribution Design (under development)
| Key Description | Function | Note |
| ------------------------ | ---------------------------- | ---------- |
| `All OneNote Built-in Hotkeys` | Original function | |
| `Press Alt then something else` | Trigger OneNote original menu function | |
| `Alt + 1234567` | Outline folding to levels 1-7| |
| `Alt + qwe asd r` | Tools, change pen, view | |
| `Alt + f` | Search tags | |
| `Alt + -=` | Formula-related | |
| `Alt + m` |
### iFlytek Input Method Floating Window Plugin
#### Usage
| Applied To | Key Combo | Function Description |
| ---------- | :---------------: | ----------------------- |
| Global | Win + Alt + H | Launch/Switch iFlytek Voice Input |
#### Notes
1. If iFlytek Voice is not installed, it will automatically prompt whether to guide for download and installation.
#### Effect shown in the image below
### CLX - Brainstorm Cerebral Storm
Anytime, in any input box, press `CLX+b` to start using AI-assisted input.
#### Key Distribution (In Development)
| Key Description | Function | Notes |
| ---------------- | ----------------------------------------------------- | ----- |
| CLX + b | Automatically copies the currently selected content, enters commands, allowing AI to assist your input | |
| CLX + Alt + b | Configure activation code (currently only a free plan, more features may be added in the future) | |
| CLX + Shift + b | Check usage quota | |
#### Protips:
##### Organize Meeting Notes Anytime
1. In any input box, use Win+H to bring up voice input, then say what you want to type. Don't worry about the accuracy of the voice input, just convey the general idea.
2. Then select all, press `CLX+b`, and input `List key points and tasks`, and AI will automatically help you organize the key points and tasks.
##### Translate Any Language to Any Language Anytime
1. In any input box, select the text you want to translate
2. Then select all, press `CLX+b`, and enter `to chinese:` and AI will automatically help you translate into Chinese.
### CLX - Brainstorm Cerebral Storm
Anytime, in any input box, press `CLX+b` to start using AI-assisted input.
#### Key Distribution (In Development)
| Key Description | Function | Notes |
| ---------------- | ----------------------------------------------------- | ----- |
| CLX + b | Automatically copies the currently selected content, enters commands, allowing AI to assist your input | |
| CLX + Alt + b | Configure activation code (currently only a free plan, more features may be added in the future) | |
| CLX + Shift + b | Check usage quota | |
#### Protips:
##### Organize Meeting Notes Anytime
1. In any input box, use Win+H to bring up voice input, then say what you want to type. Don't worry about the accuracy of the voice input, just convey the general idea.
2. Then select all, press `CLX+b`, and input `List key points and tasks`, and AI will automatically help you organize the key points and tasks.
##### Translate Any Language to Any Language Anytime
1. In any input box, select the text you want to translate
2. Then select all, press `CLX+b`, and enter `to chinese:` and AI will automatically help you translate into Chinese.
### Edit Enhancement Plugin (TG YUIO HJKL) 🌟
Is there anything better in this world than moving the cursor with Vim mode's HJKL? There must be! That's the acceleration-enhanced smooth editing experience with HJKL! Want to try making your cursor perform high-end moves around a gutter? Install it!
| Scope | Edit Module | Description |
| ----------- | --------------------- | -------------------------------- |
| Global(Basic) | `CapsLockX + h j k l` | Arrow keys for up, down, left, right |
| Global(Basic) | `CapsLockX + y o` | Home End |
| Global(Basic) | `CapsLockX + u i` | PageUp PageDown |
| Global(Basic) | `CapsLockX + [ ]` | Shift+Tab and Tab |
| Global(Basic) | `CapsLockX + g` | Enter |
| Global(Advanced) | `CapsLockX + t` | Delete |
| Global(Advanced) | `CapsLockX + hl` | Pressing hl together selects the current word |
| Global(Advanced) | `CapsLockX + kj` | Pressing kj together selects the current line |
| Global(Advanced) | `CapsLockX + h + t` | Shift then Delete: can replace Backspace in most cases |
### Surface Notebook Extended Function Keys
Specially designed for all types of broken laptop keyboards
1. No right Ctrl key? Merge Menu and right Ctrl keys, use Menu as Ctrl or Ctrl as Menu.
2. No Pause key? Win + Alt + P can also open the system settings information.
3. To be supplemented
| Mode | Key | Function |
| ---------------- | :------------------------------------ | ---------------------------------- |
| Global | Win + Alt + P | Equivalent to Win + Pause, customized for laptops |
| Global | Right Ctrl pressed once | Will press Menu to pop up the menu |
| Global | Hold the right Menu | Will hold Ctrl, can be combined with other keys |
| After enabling Win key simulation | Hold ] and press [ | Equivalent to pressing Win key |
| After enabling Win key simulation | RAlt+\| Equivalent to pressing Alt+Tab but on the right hand |
| Applied to | Media Key Module | Description |
| ---------- | ------------------- | --------------------------------------------------- |
| Global | `CapsLockX + F1` | Open: My Computer |
| Global | `CapsLockX + F2` | Open: Calculator |
| Global | `CapsLockX + F3` | Open: Browser Home Page |
| Global | `CapsLockX + F4` | Open: Media Library (default is Windows Media Player) |
| Global | `CapsLockX + F5` | Play: Pause/Play |
| Global | `CapsLockX + F6` | Play: Previous Track |
| Global | `CapsLockX + F7` | Play: Next Track |
| Global | `CapsLockX + F8` | Play: Stop |
| Global | `CapsLockX + F9` | Volume Up |
| Global | `CapsLockX + F10` | Volume Down |
| Global | `CapsLockX + F11` | Mute |
### Simulate Mouse Plugin (WASD QERF)
> I have always considered myself a keyboard enthusiast, probably starting from when I injured my finger joints while making models and became a heavy keyboard user. I actively remember various shortcut keys using all sorts of keyboard acceleration tools, striving to use the mouse less, even learning vim and emacs. However, many times the mouse is irreplaceable, especially when graphical interfaces prevail.
—— The above is a statement by the author of [SimClick simulation click](https://github.com/rywiki/simclick), a work that simulates the mouse through grid subdivision, and can complement this project
—— Recommended by [Qin Jinwei](http://rsytes.coding-pages.com/)
#### Features
- This module uses the key area: CapsLockX + QWER ASDF
- Use WASD QE RF to comfortably simulate a [complete] mouse function. Trust me, once you try this feel, you will love it.
- The pointer will automatically snap to various buttons and hyperlinks while moving. The exponential growth acceleration scrolling mechanism of the wheel makes you no longer fear super long articles and web pages.
- The effect is as shown in the picture:
#### Usage is as follows
| Apply to | Key | Description |
| -------- | --------------------------------------- | ----------------------------------------- |
| Global | `CapsLockX + w a s d` | Mouse movement (up, down, left, right) |
| Global | `CapsLockX + ad` | Switch HJKL keys to scroll wheel mode (up, down, left, right scroll) |
| Global | `CapsLockX + r f` | Vertical scroll wheel (up, down) |
| Global | `CapsLockX + Shift + r f` | Horizontal scroll wheel (left, right) |
| Global | `CapsLockX + Ctrl + Alt +
| Applies to | Key | Effect |
| ---------- | ---------------- | ------------------------------------------ |
| Global | `CapsLockX + -` | Evaluate selected JavaScript expression and replace |
| Global | `CapsLockX + =` | Evaluate selected JavaScript expression and replace |
### Window Enhancement Plugin (CLX + 1234567890 ZXCV)
#### Brief Overview
Utilize the luxurious configuration of Win 10's 10 built-in virtual desktops, automatic window arrangement for multiple displays, semi-transparent topmost windows. (Note: Taskbar and AltTab related features are temporarily incompatible with Win11, window arrangement functions normally.)
1. Window Switch: `CapsLockX + [Shift] + Z`
2. Window Close: `CapsLockX + [Shift] + X`
3. Window Arrangement: `CapsLockX + [Shift] + C`
4. Window Topmost: `CapsLockX + [Shift] + V`
5. Left-hand window management: Use `WASD` to switch windows, `X` to close windows in the `Alt + Tab` interface.
6. Efficient use of virtual desktops: `CapsLockX + 0123456789` to switch, add or remove virtual desktops, use `Shift` to transfer the current window.
7. Quick detach from virtual machine and remote desktop: double-click left `Shift + Ctrl + Alt`.
#### Example Images
- Alt + Tab enhanced window management
- CapsLockX + C one-click window arrangement (This GIF was recorded with an older version and appears laggy; the newest version has optimized the API and it's smooth.)
#### Usage (Alt+Tab and CapsLockX)
| Scope | Window Enhancement Module | Description |
| ------------ | ------------------------------------- | --------------------------------------------- |
| Alt
| Mode | Quick Input | Description |
| ----- | ----------- | --------------------------------------------------- |
| Global| `#D#` | Date input: `(20220217)` |
| Global| `#T#` | Time input: `(20220217.220717)` |
| Global| `#DT#` | Date and time input: `2022-02-17 22:07:33` |
| Global| `#NPW#` | Random input of numeric password like: `7500331260229289` |
| Global| `#PW#` | Random input of alphanumeric password like: `yyCTCNYodECTLr2h` |
| Global| `#WPW#` | Random input of alphanumeric password like: `FtD5BB1m5H98eY7Y` |
| Global| `#SPW#` | Random input of alphanumeric-symbol password like: `/})y+xK]z~>XKQ+p` |
### Pomodoro Timer
25-minute fixed cycle break reminder.
Use `CapsLockX + ,` to open the configuration, then modify EnableScheduleTasks=1 to enable this plugin.
- Use the Pomodoro time announcement (plays a work ringtone at 00 and 30 minutes, and plays a break ringtone at 25 and 55 minutes) (scheduling tasks need to be enabled first)
```ini
UseTomatoLife=1
```
- Automatically switch desktops when using the Pomodoro time announcement (rest desktop is 1, work desktop is 2)
```ini
UseTomatoLifeSwitchVirtualDesktop=1
```
Note: If you only need sound without automatic desktop switching, you can try this Chrome plugin [Tomato Life - Chrome Web Store](https://chrome.google.com/webstore/detail/25min-tomato-life/kkacpbmkhbljebmpcopjlgfgbgeokbhn)
Note: This plugin has been separated into an independent project. If you like the Pomodoro Technique, you can refer to the snow star's tomato-life project: [snomiao/tomato-life](https://github.com/snomiao/tomato-life)
### Auto Screen Off When Locked
Press Win + L to lock the screen and immediately turn off the display, suitable for turning off the computer screen automatically when preparing to sleep, so it won't be glaring while sleeping…
Press Win + Alt + L to immediately turn off the display, suitable for turning off the computer screen when preparing to sleep, so it won't be glaring while sleeping…
## Past and Future 🛰
### Production Background (Autumn of 2017) 🍁 Background
> I often write code…
> At first, I was used to using the mouse with my right hand... later I found it a bit far to put the mouse on the right... so I switched to using the mouse with my left hand.
> After switching to the left hand, I realized I still had to take it off the keyboard... so I made a script that simulates the mouse with the WASD keys. (Then I could keep playing with the computer with my right hand under my chin)
> Later I wrote more and more scripts and put some of the common ones together to load...
### Development RoadMap 🛰️ RoadMap
The core philosophy of CapsLockX is to simplify system operation logic, improve operation efficiency, and not conflict with existing habitual key positions.
1. [x] Press CapsLockX + - key to display corresponding help (the current display style is quite rough)
2. [ ] i18n (eh this really should exist)
3. [ ] Auto-update (although git pull is also fine)
4. [ ] Tutorial for first-time users (this is a bit simple now...)
5. [ ] Plugin manager (although the file system could handle it too)
6. [ ] Auto-sync of configuration (though throwing it in OneDrive is usually enough)
7. [ ] A user-friendly options configuration UI (though changing ini isn't that hard)
8. [ ] Execute external code (Python, Nodejs, external AHK, Bash, …) (although running a script isn't much trouble)
If you have any ideas or suggestions, please propose them here:
[Issues · snomiao/CapslockX](https://github.com/snolab/CapsLockX/issues)
### Key Combination Meaning Design ⌨ Chore Design
Win + series are generally used for operating system functions, desktop window application process management, input method, output device (display, multiple screens) management.
Alt + series typically denote invocation of application internal functions, their meanings should be equivalent to pressing the same function button, or jumping to a specific function interface.
Ctrl + series as above, but used more frequently and it's very likely that there is no button with the same function.
Ctrl + Alt + same as above, but generally for global hotkeys.
The Shift key is used to slightly change the meaning of the above functions (such as reverse operations like Shift+Alt+Tab, or extended function range like Shift+Arrow keys to adjust the selection, etc.)
## Compares
### CapsLockX vs. Similar Projects Function Comparison ⚔ Feat Compare Matrix
Updated (20200627) The information may become outdated over time
| Feature\Project | [CapsLockX](https://github.com/snolab/CapsLockX) | [Vonng/CapsLock](https://github.com/Vonng/CapsLock) | [coralsw/CapsEz](https://github.com/coralsw/CapsEz) | [CapsLock+](https://capslox.com/capslock-plus/) |
| :------------------------------ | :----------------------------------------------- | :-------------------------------------------------- | :-------------------------------------------------- | :---------------------------------------------- |
| Mouse Simulation | ✅ Smooth and complete | ✅ No scroll wheel | 🈚 None | 🈚 None |
| Expression Calculation | ✅ Nodejs or JScript | 🈚 None | 🈚 None | ✅ TabScript (Snippet + Javascript) |
| Window Management | ✅ Strong | ✅ Available | ✅ Available | ✅ Strong |
| Virtual Desktop Management | ✅ Available | 🈚 None | 🈚 None | 🈚 None |
| Editing Enhancement | ✅ Available (parabolic model) | ✅ Available | ✅ Available | ✅ Very comprehensive |
| Portable (No Install) | ✅ Yes | ✅ Yes | ✅ Yes | ✅ Yes |
| Enhanced Media Keys | Not all | ✅ All | 🈚 None | 🈚 None |
| Enhanced Clipboard | Weak | 🈚 None | 🈚 None | ✅ Available |
| Quick Application Launch | ✅ Plugins | ✅ Available | ✅ Available | ✅ Available |
| Application Feature Enhancement | ✅ Rich | 🈚 None | ✅ Available | 🈚 None |
| Bash Control | 🈚 None | ✅ Available | 🈚 None | 🈚 None |
| Quick Start Voice Input | ✅ iFLYTEK | 🈚 None | 🈚 None | 🈚 None |
| Quick Input of Time and Date | ✅ Available | | ✅ Available | |
| Bind Window to Hotkey | 🈚 None | 🈚 None | 🈚 None | ✅ Available |
| Quick Screen Rotation | ✅ Available | 🈚 None | 🈚 None | 🈚 None |
| Secondary Development | ✅ Documentation friendly | ✅ Possible | ✅ Possible | ✅ Possible |
| Memory Usage | ✅ About 2~3M | | | |
| Modularization | ✅ | 🈚 None | 🈚 None | 🈚 None |
| System | Win | Mac (main), Win (secondary) | Win | Win, [Mac](https://capslox.com/) |
| Supported Languages | English / Chinese / Any Language (by ChatGPT) | Chinese / English | Chinese | Chinese / English |
### CapsLockX Address 🔗 Project Urls
The following repositories are updated synchronously:
- GitHub: [https://github.com/snolab/CapsLockX](https://github.com/snolab/CapsLockX)
- Gitee: [https://gitee.com/snomiao/CapslockX](https://gitee.com/snomiao/CapslockX)
- Bitbucket: [https://bitbucket.org/snomiao/capslockx](https://bitbucket.org/snomiao/capslockx)
- Gitlab: [https://gitlab.com/snomiao/CapsLockX/](https://gitlab.com/snomiao/CapsLockX/)
Document Address 📄
- Automatic Translation Document Netlify CDN: [https://capslockx.netlify.com](https://capslockx.netlify.com)
- Automatic Translation Document CloudFlare CDN: [https://capslockx.snomiao.com](https://capslockx.snomiao.com)
Star Chart ⭐️
- [](https://starchart.cc/snolab/CapsLockX)
### Similar Project Addresses 🔗 Similar Projects
- [Star Historys](https://star-history.t9t.io/#snolab/CapsLockX&wo52616111/capslock-plus&coralsw/CapsEz&Vonng/CapsLock)
- Source: [Vonng/CapsLock: Make CapsLock Great Again!](https://github.com/Vonng/CapsLock)
Design: [Capslock/design.md at master · Vonng/Capslock](https://github.com/Vonng/Capslock/blob/master/design.md)
- [coralsw/CapsEz: KeyMouse Tools](https://github.com/coralsw/CapsEz)
- [CapsLock+](https://capslox.com/CapsLock-plus/)
- [Capslox](https://capslox.com/cn/)
- CapsLock++ [matrix1001/CapsLock-plus-plus: ⌨Amazing, extendable, readable autohotkey scripts framework utilized by CapsLock.](https://github.com/matrix1001/CapsLock-plus-plus)
- [Power Keys | Liberate Computer Usage Efficiency](https://powerkeys.github.io/)
## Questions and Answers ❓ Questions
Related Communities:
- [CapsLockX's issues (can be used as a forum)](https://github.com/snolab/CapsLockX/issues) ✉️
- CapsLockX User Telegram Group: [t.me/CLX_users](https://t.me/CLX_users)📱
- CapsLockX User QQ Group 🐧: [100949388](https://jq.qq.com/?_wv=1027&k=56lsK8ko)
- QZ/VimD/TC/AHK QQ Group 🐧: 271105729
- AHK Advanced QQ Group 🐧: 717947647
- The Little Red Dot mechanical keyboard group 🐧: 199606725
For questions related to CapsLockX, you can directly join the group [@雪星](tencent://message?uin=997596439) or ask privately.
### Privacy and Security 🔒 Privacy
Considering that any software that can obtain administrative rights is quite dangerous to a user's operating system, CapsLockX must and is currently adopting an open-source approach. This allows the community to freely and arbitrarily inspect any part of the CapsLockX code that may be involved, to ensure that the security of all users' operating systems is not compromised by this software.
## Support ⭐️ Supports
How to help CapsLockX survive? If CapsLockX has been helpful to you:
1. ⭐️ Please star CapsLockX on Github Star
2. 🔗 Please share it with your friends.
3. 🌐 Welcome to help translate this documentation into different languages.
4. 🐞 Welcome to submit bugs and suggestions for improvement [issues](https://github.com/snolab/CapsLockX/issues)
5. Code PR submissions are welcome, even just to correct a typo ～
6. Welcome to create works about this software, such as recording tutorial videos to post on Youtube or Bilibili, Xue Xing will like your video.
7. 💰 Welcome to donate to the development of CapsLockX, each donation will be recorded in the list below:
- Aifadian ⚡️：[https://afdian.net/@snomiao](https://afdian.net/@snomiao)
- PAYPAL: [https://paypal.me/snomiao](https://paypal.me/snomiao)
- Alipay donation [[email protected] （click to view QR code）](./docs/支付宝捐助.png)
- Wise donation [[email protected]](https://wise.com/pay/r/vPlWg3Mh4zhabUk)
- [CapsLockX - Open Collective](https://opencollective.com/capslockx)
- ETH： [0xdc2eece11a9e09c8db921989e54b30375446e49e](https://etherscan.io/address/0xdc2eece11a9e09c8db921989e54b30375446e49e)
- [Development Roadmap](#发展路线-roadmap)
### Donation Records (as of 20210821) 📄 Donate Records
| Donation Date | Name | Channel | Amount | Comment |
| ------------- | -------------------------------- | --------------- | ----------- | -------------------------------------------------------------- |
| 2021-06-19 | \*\*Yu | Alipay QR | +50.00 CNY | A little support, in favor of independent developers |
| 2023-05-12 | Karawen | WeChat Transfer | +200.00 CNY | 🫡 (Salute) |
| 2023-06-09 | [@andriasw](github.com/andriasw) | Alipay Transfer | +66.66 CNY | for CapsLockX-mac, 66.66 is good (https://github.com/andriasw) |
| 2023-12-19 | Huidan | QQ Red Packet | +45.00 CNY | Buy the developer a coffee |
### Acknowledgements 🙏🏻 Thanks
- Thank you for the financial support from the above donors.
- Thanks to [Qin Jinwei](http://rsytes.coding-pages.com/) for the citation recommendation article and development suggestions: [2020-02-23 When Keyboard Simulates Mouse - Jianshu](https://www.jianshu.com/p/f757f56a7de6)
- Thanks to @He Xuren for helping with the dissemination: [CapsLockX – Operate the computer like a hacker! 【Xue Xing】 – AutoAHK](https://www.autoahk.com/archives/34996)
- Thank you to those who asked questions in the issues and in the group and helped to improve CapsLockX.
### Related Topics for References
- [秦金伟](http://rsytes.coding-pages.com/)
- [2020-02-23 当键盘模拟鼠标 - qwertc](https://mp.weixin.qq.com/s?__biz=MzIzNzczOTkzMw==&mid=2247483745&idx=1&sn=16f16c1fa02e1ef386a83f3023fb109d&chksm=e8c54b93dfb2c285e49fa8045d2380b20810768e3be043f364be146a598faf5f363bbb2623e7&scene=21#wechat_redirect)
- [2020-10-26 键盘模拟鼠标 2 - qwertc](https://mp.weixin.qq.com/s?__biz=MzIzNzczOTkzMw==&mid=2247484272&idx=1&sn=0ed1ff91bee008fc5c01dc0fe20e53ba&chksm=e8c54982dfb2c09493c88a0f7847ffb0b508598e0756ddd7e8ad94d1f31f65490388d6cff7a4&scene=21#wechat_redirect)
- [2021-03-11 capslockX-治愈鼠标手 - qwertc](https://mp.weixin.qq.com/s?__biz=MzIzNzczOTkzMw==&mid=2247484478&idx=1&sn=1518d7ec4dc08c1a72c08fcaff98550e&chksm=e8c54eccdfb2c7daed0ad9b8c03395e4211e029199374f4bc0dbdc9a8403c2dae86b740c95c5&scene=21#wechat_redirect)
- 2021 年 11 月，键盘模拟鼠标 3
- [2022-08-21 t0820 复制后匹配-siyuan-clx-截图 - qwertc](https://mp.weixin.qq.com/s?__biz=MzIzNzczOTkzMw==&mid=2247485441&idx=1&sn=848d5e6f3fb7c1e7b14100615ca7d0db&chksm=e8c542f3dfb2cbe5770fe19bb8b5c81935e52a4a686154e69104bc403ab6ce960d1b6ae429a9&scene=21#wechat_redirect)
- [2024-01-06 t0106 OpenAI 加持的 CapslockX - qwertc](https://mp.weixin.qq.com/s?__biz=MzIzNzczOTkzMw==&mid=2247485707&idx=1&sn=d40eea9f0b5bb81e3387ec592def4ed0&chksm=e8c543f9dfb2caef90939e2fafcb324fd757949c79399c55adfbab0940e70efd753fb6bf3837&token=1464360155&lang=zh_CN#rd)
- V2EX:
- [有没有办法将 Chrome OS 中的快捷键实现到 Windows 10 中 - V2EX](https://www.v2ex.com/t/778967)
- [推荐一下我的键位映射工具 MyKeymap - V2EX](https://v2ex.com/t/844432)
- [有多少人会把键盘上的 CapsLock 和 Backspace 对调？ - V2EX](https://www.v2ex.com/t/855901)
- [分享一个用 CapsLock+H/J/K/L 模拟方向键的小工具 - V2EX](https://www.v2ex.com/t/318182)
- [推荐一个适合程序员的效率工具 AltPlus，左边大拇指按下 Alt 键,就可以像使用 vim 一样编程了. - V2EX](https://www.v2ex.com/t/800721)
- [CapsLockX - 像黑客一样操作电脑 - V2EX](https://v2ex.com/t/772052#reply1)
- Zhihu:
- [如何将电脑桌面划分为独立的两半？ - 知乎](https://www.zhihu.com/questionz/23443944/answer/1670521971)
- [有哪位残友用的是单手键盘？ - 知乎](https://www.zhihu.com/question/50621709/answer/1681247637)
- [怎么样才能只用键盘不用鼠标，包括任何指针触控设备，并优雅地使用电脑？ - 知乎](https://www.zhihu.com/question/21281518/answer/1770669886)
- [如何将电脑桌面划分为独立的两半？ - 知乎](https://www.zhihu.com/question/23443944/answer/1670521971)
- [我是职场达人，AutoHotKey 让我成为职场超人 - 知乎](https://zhuanlan.zhihu.com/p/60372361)
- [为什么知乎上这么多人推荐 HHKB，却不反复强调说该键盘不适合大多数程序员？ - 知乎](https://www.zhihu.com/question/33690121/answer/3495460336)
- AutoAHK:
- [AutoHotKey 中文网专栏 - 知乎](https://www.zhihu.com/column/autoahk)
- [我是职场达人，AutoHotKey 让我成为职场超人 – AutoAHK](https://www.autoahk.com/archives/14636)
- [脱胎于 CapslockX 的雪星鼠标-键盘模拟鼠标 – AutoAHK](https://www.autoahk.com/archives/44126)
- [QZ——Arrary – AutoAHK](https://www.autoahk.com/archives/4133)
- [CapsLockX - 像黑客一样操作电脑！ - AutoHotkey Community](https://www.autohotkey.com/boards/viewtopic.php?f=28&t=88593)
- [(10) What are some good career alternatives for a computer programmer with RSI? - Quora](https://www.quora.com/Repetitive-Strain-Injury-RSI/What-are-some-good-career-alternatives-for-a-computer-programmer-with-RSI)
- [simple internationalization function - Scripts and Functions - AutoHotkey Community](https://www.autohotkey.com/board/topic/50131-simple-internationalization-function/)
## Footer Catalog - Table of Contents
- [CapsLockX - 💻 Get Hacker's Keyboard. Operate your computer like a **hacker**](#capslockx----get-hackers-keyboard-operate-your-computer-like-a-hacker)
- [Version Wall - Badge Wall 📛 Badges](#version-wall---badge-wall--badges)
- [Beginner's Quick Start Tutorial 📖 Tutorial](#beginners-quick-start-tutorial--tutorial)
- [Simple Introduction Tutorial (Once you read this section, you're considered to have started using CapsLockX)](#simple-introduction-tutorial-once-you-read-this-section-youre-considered-to-have-started-using-capslockx-)
- [Advanced Reference Manual 🦽 Manual](#advanced-reference-manual--manual)
- [Installation and Usage 🛠 Installation](#installation-and-usage--installation)
- [Green Portable Package (Suitable for beginners, stable version) 📦 Packaged Bins](#green-portable-package-suitable-for-beginners-stable-version--packaged-bins)
- [Command Line Installation (Recommended for advanced users, supports auto-update)🖥️ Install by command](#command-line-installation-recommended-for-advanced-users-supports-auto-update️-install-by-command)
- [Usage Manual 📖 - Usage Manual](#usage-manual----usage-manual)
- [Basic Operations](#basic-operations)
- [Module Descriptions](#module-descriptions)
- [Nightmares of Multitasking](#nightmares-of-multitasking)
- [Virtual Desktop Overview: Scenarios Mode, Work Desktop, Entertainment Desktop, Project Categorization...](#virtual-desktop-overview-scenarios-mode-work-desktop-entertainment-desktop-project-categorization)
- [Improvement of User Experience in Windows Window Switching - Win+tab](#improvement-of-user-experience-in-windows-window-switching---wintab)
- [TODO-Docs](#todo-docs)
- [Focus Amount: Active Window, Default Active Window,...](#focus-amount-active-window-default-active-window)
- [Utilization of Multiple Screens - Multi-screening](#utilization-of-multiple-screens---multi-screening)
- [Window Arrangement in the 4K Era - Window arrange with 4k screen](#window-arrangement-in-the-4k-era---window-arrange-with-4k-screen)
- [Window Management in Linux and Mac - Window Manager in Linux and Mac](#window-management-in-linux-and-mac---window-manager-in-linux-and-mac)
- [Window Management in Android and iOS - Window Management in Android](#window-management-in-android-and-ios---window-management-in-android)
- [Troubles with Edit Operations](#troubles-with-edit-operations)
- [Estrangement between Typing Area and Editing Control Area](#estrangement-between-typing-area-and-editing-control-area)
- [The Concept of Chording](#the-concept-of-chording)
- [Troubles with Graphic User Interface](#troubles-with-graphic-user-interface)
- [Human Perception of Speed](#human-perception-of-speed)
- [Hotkey Flaws of Software](#hotkey-flaws-of-software)
- [Usability of Portable Keyboards](#usability-of-portable-keyboards)
- [Help Module](#help-module)
- [Functions of this module as follows](#functions-of-this-module-as-follows)
- [Anki Enhancement Module](#anki-enhancement-module)
- [Common Features/Characteristics](#common-featurescharacteristics)
- [Explanations](#explanations)
- [Figma Enhanced](#figma-enhanced)
- [Common Features/Characteristics](#common-featurescharacteristics-1)
- [Explanations](#explanations-1)
- [OneNote 2016 - 2019 Enhancement](#onenote-2016---2019-enhancement)
- [Common Features Used by XuexingMiao](#common-features-used-by-xuexingmiao)
- [Key Distribution Design (Under Development)](#key-distribution-design-under-development)
- [Detailed Key Table / CheatSheet](#detailed-key-table--cheatsheet)
- [Editing Enhancement Plugin (TG YUIO HJKL) 🌟](#editing-enhancement-plugin-tg-yuio-hjkl--)
- [Expanded Function Keys for Surface Laptops](#expanded-function-keys-for-surface-laptops)
- [Media Key Module](#media-key-module)
- [Mouse Simulation Plugin (WASD QERF)](#mouse-simulation-plugin-wasd-qerf-)
- [Features](#features)
- [How to Use as follows](#how-to-use-as-follows)
- [Operational Details](#operational-details)
- [JavaScript Calculation (Installation of NodeJS Recommended)](#javascript-calculation-installation-of-nodejs-recommended-)
- [Window Enhancement Plugin (CLX + 1234567890 ZXCV)](#window-enhancement-plugin-clx--1234567890-zxcv)
- [Brief Description of the Features](#brief-description-of-the-features)
- [Effect Pictures](#effect-pictures)
- [How to Use as follows (Alt+Tab and CapsLockX)](#how-to-use-as-follows-alttab-and-capslockx-)
- [Quick Input](#quick-input)
- [Pomodoro Timer](#pomodoro-timer)
- [Auto Screen Off when Locking Screen](#auto-screen-off-when-locking-screen)
- [Past and Future 🛰](#past-and-future-)
- [Creation Background (Autumn 2017) 🍁 Background](#creation-background-autumn-2017--background)
- [Development Path 🛰️ RoadMap](#development-path-️-roadmap)
- [Combination Key Meaning Design ⌨ Chore Design](#combination-key-meaning-design--chore-design)
- [Feature Comparison of CapsLockX and Similar Projects ⚔ Feat Compare Matrix](#feature-comparison-of-capslockx-and-similar-projects--feat-compare-matrix)
- [CapsLockX Project Urls 🔗 Project Urls](#capslockx-project-urls--project-urls)
- [Urls of Similar Projects 🔗 Similar Projects](#urls-of-similar-projects--similar-projects)
- [FAQs Related ❓ Questions](#faqs-related--questions)
- [Privacy and Security 🔒 Privacy](#privacy-and-security--privacy)
- [Support ⭐️ Supports](#support-️-supports)
- [Donation Records (Up to 20210821) 📄 Donate Records](#donation-records-up-to-20210821--donate-records)
- [Acknowledgements 🙏🏻 Thanks](#acknowledgements--thanks)
- [Related Topics](#related-topics)
- [Footer Catalog - Table of Contents](#footer-catalog---table-of-contents)
---