Skip to content

zuorn/win-vind

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Coverity Scan Build Status

What is this?

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.

1. Vim-user friendly.

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.

2. There are many useful built-in commands.

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.

3. Very portable and fully open source.

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".

Top Feature Demo

demo.mp4


Migration from v4 to v5

The v5 has many changes from v4, so please read the migration guide.

Installation

We support a variety of installation methods.

$ choco install win-vind
$ winget install win-vind

Executable Installer

Portable Zip

Usage

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.

.vindrc sample

" 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 ggyyGp

Known Issues

  • 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.

How to build

Preparation

The dependencies required for the build are installed locally in the project directory. The system is not affected.

$ ./tools/setup_libs.bat -msvc 64

Debug

$ cmake -B debug -G "Visual Studio 16 2019" .
$ cmake --build debug
$ ./debug/Debug/win-vind.exe

Release

$ cmake -B release -DCMAKE_BUILD_TYPE=Release -G "Visual Studio 16 2019" .
$ cmake --build release --config Release
$ ./debug/Release/win-vind.exe

If you want to build with MinGW or create an installer, see here.

Contribute

If you would like to contribute to win-vind, see CONTRIBUTING.md.

The project is managed with GitHub Projects.

Similar Projects

License

This software is provided by pit-ray under the MIT License.

About

You can operate Windows with key bindings like Vim.

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • C++ 83.0%
  • C 14.2%
  • Python 1.5%
  • Other 1.3%