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"
.
win-vind supports a variety of installation methods.
$ choco install win-vind
$ winget install win-vind
This has been added to Scoop Extras thanks to contributors and is automatically updated by the autoupdate feature of scoop.
$ scoop bucket add extras
$ scoop install win-vind
Usage 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.
The file is located at C:\Users\[USERNAME]\.win-vind\.vindrc
" Choose the version of {tiny, small, normal, big, huge}.
version normal
" Change parameters
set shell = cmd
set cmd_fontsize = 14
set cmd_fontname = Consolas
set easyclick_bgcolor=E67E22
set easyclick_fontcolor=34495E
" Map capslock to ctrl.
imap <capslock> {<ctrl>}
" Define useful shortcuts
inoremap <ctrl-shift-f> <easyclick><click_left>
inoremap <ctrl-shift-m> <gridmove><click_left>
inoremap <ctrl-shift-s> <switch_window><easyclick><click_left>
" Register application launchers
noremap <ctrl-1> :! gvim<cr>
noremap <ctrl-2> :e http://example.com<cr>
" Define macros like Vim
enoremap t ggyyGp
" Apply auto-commands
autocmd AppLeave * <to_insert>
autocmd AppEnter,EdiNormalEnter vim.exe <to_resident>
win-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 from the keyboard (e.g., GridMove and EasyClick). 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 disable Use smart paragraph selection
.
All you have to do is install cmake, Visual Sudio and Windows SDK, then do the following.
$ cmake -B build
$ cmake --build build
$ ./build/Debug/win-vind.exe
If you want to build with MinGW or create an installer, see here.
Tests can be run using ctest and python.
Run source code level tests.
$ cd tests
$ cmake -B build unit
$ cmake --build build
$ ctest -C Debug --test-dir build --output-on-failure
$ cd ..
Runtime tests check the behavior of the built binaries.
$ cd tests
$ python runtime/test.py "../bin_64/win-vind/win-vind.exe" # Specifies the binary for release.
$ cd ..
See this document for details.
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.