win-vind provides a lightweight hybrid UI system of CUI and GUI for Windows.
By installing this tool, you will be able to control the Windows GUI in the same way as Vim.
All configuration methods and mode concepts are derived from Vim, allowing for Vim-like UI operation.
Vim users only need to understand win-vind's macro features and additional mode concepts with little learning cost.
You don't have to worry about complicated scripts and dependencies like with traditional key binding tools.
You can freely create user-defined commands by combining low-level optimized built-in commands.
win-vind is a small single binary with no dependencies that runs with user permissions.
It is also available from the command line as a command for UI operations like $ win-vind -c "ggyyGp".
demo.mp4
The v5 has many changes from v4, so please read the migration guide.
We support a variety of installation methods.
$ choco install win-vind$ winget install win-vindUsage is mainly described in easy-to-read documentation pages with plenty of diagrams. Here, only a sample .vindrc is shown below. As you can see, it is Vim user-friendly.
" Choose the version of {tiny, small, normal, big, huge}.
version normal
" options
set shell = cmd
set cmd_fontsize = 14
set cmd_fontname = Consolas
set blockstylecaret
set blockstylecaret_mode = solid
" bindings
imap <capslock> {<ctrl>}
inoremap <alt><alt> <easy_click_left>
inoremap <win-enter> <window_resizer>
noremap <ctrl-1> :! gvim<cr>
noremap <ctrl-2> :e http://example.com<cr>
enoremap t ggyyGpwin-vind has many features, but you can use a simpler one for your purposes by putting the version command at the beginning of your .vindrc.
If you want to use tiny version, write the following. It is important to note that nothing but comments can be written before the version command.
If you do not write the version command, huge will be loaded.
" Only comments can be written in here.
version tiny
" Any command can be written from.
" For example
set shell = cmd| Tier | Supported Features |
|---|---|
| tiny | +mouse +syscmd |
| small | +mouse +syscmd +window +process |
| normal | +mouse +syscmd +window +process +vimemu |
| big | +mouse +syscmd +window +process +vimemu +hotkey +gvmode |
| huge | +mouse +syscmd +window +process +vimemu +hotkey +gvmode +experimental |
Following Vim, there are five tiers. tiny has minimal commands for mouse moving and clicking, including EasyClick and GridMove. small allows more flexible handling of window controls and process launches, etc. normal has Vim emulation mappings and allows text editing in text areas, etc. big adds several hotkeys that redefine some of the shortcut keys in Windows to operate Windows with more Vim-like ways. It also provides GUI Visual Mode (+gvmode), which allows for holding down the mouse. huge allows win-vind to have experimental features for more complex operations.
For more information on default mappings, please visit our website.
-
EasyClick does not seem to work properly for some applications on older Windows 10 before 1803. The cause is not known, but we have confirmed that it works after 1909. (#11)
-
Windows 10/11 Single Language does not seem to be able to map toggle keys such as
<Capslock>. (#40) -
If you want to use word motion (e.g.
w,B,e) in MS Office Word, it is recommended to disableUse smart paragraph selection.
The dependencies required for the build are installed locally in the project directory. The system is not affected.
$ ./tools/setup_libs.bat -msvc 64$ cmake -B debug -G "Visual Studio 16 2019" .
$ cmake --build debug
$ ./debug/Debug/win-vind.exe$ cmake -B release -DCMAKE_BUILD_TYPE=Release -G "Visual Studio 16 2019" .
$ cmake --build release --config Release
$ ./debug/Release/win-vind.exeIf you want to build with MinGW or create an installer, see here.
If you would like to contribute to win-vind, see CONTRIBUTING.md.
The project is managed with GitHub Projects.
This software is provided by pit-ray under the MIT License.