Skip to content

Commit

Permalink
built for 4.0.0
Browse files Browse the repository at this point in the history
  • Loading branch information
pit-ray committed Jun 18, 2021
1 parent 8cc8b23 commit 5312858
Show file tree
Hide file tree
Showing 9 changed files with 168 additions and 343 deletions.
1 change: 1 addition & 0 deletions .gitignore
Original file line number Diff line number Diff line change
Expand Up @@ -16,3 +16,4 @@ temp
replace.vim
win32gui
venv
compile_flags.txt
280 changes: 112 additions & 168 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,168 +1,112 @@
<h1 align="center">win-vind</h1>

<p align="center">
<img src="https://github.com/pit-ray/pit-ray.github.io/blob/master/win-vind/imgs/win-vind-icon.png?raw=true" width="150" height="150" />
<p align="center"><b>Vim Key Binder for Windows</b></p>
</p>

<table align="center">
<tr>
<th colspan="2">Code status</th>
<th colspan="2">Build status</th>
<th colspan="2">Test status</th>
</tr>
<tr align="center">
<td>Coverity</td>
<td>Codacy</td>
<td>MinGW-w64</td>
<td>Visual Studio 2019</td>
<td>Windows</td>
</tr>
<tr>
<td align="center">
<a href="https://scan.coverity.com/projects/pit-ray-win-vind"><img alt="Coverity Scan Build Status" src="https://scan.coverity.com/projects/22417/badge.svg"/></a>
</td>
<td align="center">
<a href="https://www.codacy.com/gh/pit-ray/win-vind/dashboard?utm_source=github.com&amp;utm_medium=referral&amp;utm_content=pit-ray/win-vind&amp;utm_campaign=Badge_Grade"><img src="https://app.codacy.com/project/badge/Grade/8f2e6f2826904efd82019f5888574327" /></a>
</td>
<td align="center">
<a href="https://travis-ci.org/pit-ray/win-vind"><img src="https://travis-ci.org/pit-ray/win-vind.svg?branch=master" /></a>
</td>
<td align="center">
<a href="https://github.com/pit-ray/win-vind/actions/workflows/msvc.yml"><img src="https://github.com/pit-ray/win-vind/actions/workflows/msvc.yml/badge.svg"></a>
</td>
<td align="center">
<a href="https://github.com/pit-ray/win-vind/actions/workflows/test.yml"><img src="https://github.com/pit-ray/win-vind/actions/workflows/test.yml/badge.svg"></a>
</td>
</tr>
</table>

<br>


<br>

## Notice
### We will release 4.x with a major update in June.
### We released 4.0.0-perview. Try it!
- [new README](README_4xx.md)

## Description
**win-vind** provides the lightweight hybrid UI system of CUI and GUI. Its core idea is to add a new mode layer to operate GUI when you want to transition from Vim to other windows for a short while.

There are five main features.

#### 1. GUI Operation like Vim
You can operate windows, a mouse cursor , virtual desktops, GUI-objects with key-bindings like Vim.

<img src="https://github.com/pit-ray/pit-ray.github.io/blob/master/win-vind/imgs/window_ctrl_demo_min.gif?raw=true" title="WindowControl-demo" width=600 >

#### 2. Vim emulation everywhere
It enables to emulate Vim when using general text editors (e.g.`notepad.exe`, `Microsoft Office Word`).

**Demo**
<img src="https://github.com/pit-ray/pit-ray.github.io/blob/master/win-vind/imgs/msword-demo.gif?raw=true" width=400/>


#### 3. Mode Management like Vim
There are two main modes: **GUI Mode** for GUI operation and **Editor Mode** for Vim emulation.

<img src="https://github.com/pit-ray/pit-ray.github.io/blob/master/win-vind/imgs/mode_overview_2.jpg?raw=true" width=700 />

#### 4. Process Control
If you register `notepad.exe` as `notepad`, could launch it by typing `:!notepad` like below.

**Demo**
<img src="https://github.com/pit-ray/pit-ray.github.io/blob/master/win-vind/imgs/cmd-demo.gif?raw=true" width=400 title="cmd-demo">

#### 5. Using from command line
You can operate win-vind from command lines.

**Example**
```sh
$ ./win-vind.exe --func change_to_normal
```
Therefore, it enables to make Vim link to GUI or use from AutoHotKey.

If you add next scripts into .vimrc, you can switch a mode to operate GUI with `:GUINormal`.
```Vim
Plug 'skywind3000/asyncrun.vim'
command! GUINormal :AsyncRun win-vind -f change_to_normal
```

If you add next scripts into AHK Script, you can call each function.
```AHK
#f::Run, win-vind -f easy_click_left
#a::Run, win-vind -f arrange_windows
```

Refer to <a href="https://pit-ray.github.io/win-vind/cheat_sheet/link_with_vim/">Link With Vim - win-vind</a>. If you want to know the details, refer to <a href="https://pit-ray.github.io/win-vind/cheat_sheet/">Cheat Sheet - win-vind</a>.

## Download
### 3.3.0 (Latest Version)
Date: 2021/5/9

#### 32bit
- <a href="https://github.com/pit-ray/win-vind/releases/download/v3.3.0/setup_win-vind_3.3.0_32bit.exe.zip">setup_win-vind_3.3.0_32bit.exe</a>
- <a href="https://github.com/pit-ray/win-vind/releases/download/v3.3.0/win-vind_3.3.0_32bit.zip">win-vind_3.3.0_32bit.zip</a>

#### 64bit
- <a href="https://github.com/pit-ray/win-vind/releases/download/v3.3.0/setup_win-vind_3.3.0_64bit.exe.zip">setup_win-vind_3.3.0_64bit.exe</a>
- <a href="https://github.com/pit-ray/win-vind/releases/download/v3.3.0/win-vind_3.3.0_64bit.zip">win-vind_3.3.0_64bit.zip</a>


## Related Pages
- <a href="https://www.pit-ray.com/archive/category/win-vind">Description Blog of Author in Japanese</a>
- <a href="https://www.reddit.com/user/pit-ray/posts/">Posts of reddit</a>


## Usage
Please refer to <a href="https://pit-ray.github.io/win-vind/cheat_sheet/">CheatSheet</a> about the default bindings.

You can call a pre-defined function with favorite keybindings. The above-stated mode management has the following features, and all modes can have functions to switch to each mode with your keybindings. All modes have presets of keybindings.

|Mode&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;|Features|
|:-----|:---|
|GUI Normal, Edi Normal|All keys except hotkeys will be disabled. Therefore, recommended to include functions to transit to Insert Mode.|
|GUI Insert, Edi Insert|Inputted keys will not be disabled and are transmitted normally to other applications. When the commands are detected, a function will be called.|
|GUI Visual|It holds right-click.|
|Edi Visual, Edi Visual Line|Each function works on the assumption you hold down a shift key.|
|Command|This is shared Editor mode and GUI mode. A virtual command line is launched, and Enter is available to decide and BackSpace is available to erase. You can move the history with Up and Down.|

Please visit <a href="https://pit-ray.github.io/win-vind/how_to_use/">How to use - win-vind</a> for details.

**Demo**
You can change default bindings.
<a href="https://github.com/pit-ray/win-vind/discussions/7"><img src="https://github.com/pit-ray/pit-ray.github.io/blob/master/win-vind/imgs/video_preview_customizing_mp4.png?raw=true" width="500"></a>


## How to contribute

Please read its architecture at <a href="devdocs/README.md">devdocs</a>.

### Quick Start for Build
If you have already installed MinGW-w64 or Visual Studio 2019, all you need is the next steps.

**1.** Install needed libraries into a root directory of win-vind.
```bash
$ ./scripts/setup_libs.bat [-mingw/-msvc] [32/64]
```
**2.** Build its project.
```bash
$ ./build.bat [-debug/-release] [-mingw/-msvc] [32/64]
```
**3.** Finish!

If you want to contribute, please visit <a href="https://pit-ray.github.io/win-vind/how_to_contribute/">How to contribute - win-vind</a>.

You can refer to ToDo in <a href="https://github.com/pit-ray/win-vind/projects/2">Projects/win-vind</a>

## License

This software is provided by **MIT License**.

## Author

- pit-ray
[E-mail] pit-ray(at)outlook.com
<h1 align="center">win-vind</h1>

<p align="center">
<img src="https://github.com/pit-ray/pit-ray.github.io/blob/master/win-vind/imgs/win-vind-icon.png?raw=true" width="150" height="150" />
<p align="center"><b>Vim Key Binder for Windows</b></p>
</p>

<table align="center">
<tr>
<th colspan="2">Code status</th>
<th colspan="2">Build status</th>
<th colspan="2">Test status</th>
</tr>
<tr align="center">
<td>Coverity</td>
<td>Codacy</td>
<td>MinGW-w64</td>
<td>Visual Studio 2019</td>
<td>Windows</td>
</tr>
<tr>
<td align="center">
<a href="https://scan.coverity.com/projects/pit-ray-win-vind"><img alt="Coverity Scan Build Status" src="https://scan.coverity.com/projects/22417/badge.svg"/></a>
</td>
<td align="center">
<a href="https://www.codacy.com/gh/pit-ray/win-vind/dashboard?utm_source=github.com&amp;utm_medium=referral&amp;utm_content=pit-ray/win-vind&amp;utm_campaign=Badge_Grade"><img src="https://app.codacy.com/project/badge/Grade/8f2e6f2826904efd82019f5888574327" /></a>
</td>
<td align="center">
<a href="https://travis-ci.org/pit-ray/win-vind"><img src="https://travis-ci.org/pit-ray/win-vind.svg?branch=master" /></a>
</td>
<td align="center">
<a href="https://github.com/pit-ray/win-vind/actions/workflows/msvc.yml"><img src="https://github.com/pit-ray/win-vind/actions/workflows/msvc.yml/badge.svg"></a>
</td>
<td align="center">
<a href="https://github.com/pit-ray/win-vind/actions/workflows/test.yml"><img src="https://github.com/pit-ray/win-vind/actions/workflows/test.yml/badge.svg"></a>
</td>
</tr>
</table>


## Description
**win-vind** provides the lightweight hybrid UI system of CUI and GUI for Windows.

### Features
- Fast Binding System
- Vim-like Mode Manegement
- GUI Operation without Mouse
- Vim Emulation Everywhere
- Process Control like `:!gvim ~/.vimrc` or `:e ~/.vimrc`
- Vim-like Configuration Syntax with `.vindrc`
- Low-level key mapping (e.g. `imap <Capslock> <Ctrl>`)
- Running in User Permission
- Oneshot Use for Vim or AHK

If you want to know the details, refer to <a href="https://pit-ray.github.io/win-vind/cheat_sheet/">Cheat Sheet - win-vind</a>.

## Demo

<img src="https://github.com/pit-ray/win-vind/blob/gh-pages/imgs/4xxdemo.gif?raw=true" title="Demo" >

<br>

## Download
### 4.0.0 (Latest Version)
Date: 2021/6/18

#### 32bit
- <a href="https://github.com/pit-ray/win-vind/releases/download/v4.0.0/setup_win-vind_4.0.0_32bit.exe.zip">setup_win-vind_4.0.0_32bit.exe</a>
- <a href="https://github.com/pit-ray/win-vind/releases/download/v4.0.0/win-vind_4.0.0_32bit.zip">win-vind_4.0.0_32bit.zip</a>

#### 64bit
- <a href="https://github.com/pit-ray/win-vind/releases/download/v4.0.0/setup_win-vind_4.0.0_64bit.exe.zip">setup_win-vind_4.0.0_64bit.exe</a>
- <a href="https://github.com/pit-ray/win-vind/releases/download/v4.0.0/win-vind_4.0.0_64bit.zip">win-vind_4.0.0_64bit.zip</a>

## Usage
You can refer to the installation and quick tutorial in [Usage - win-vind](https://pit-ray.github.io/win-vind/usage/).

<br>

## Related Pages
- <a href="https://www.pit-ray.com/archive/category/win-vind">Description Blog of Author in Japanese</a>
- <a href="https://www.reddit.com/user/pit-ray/posts/">Posts of reddit</a>

## To Contribute

Please read its architecture at <a href="devdocs/README.md">devdocs</a>.

### Quick Start for Build
If you have already installed **MinGW-w64** or **Visual Studio 2019**, all you need is the next steps.

**1.** Install needed libraries into a root directory of win-vind.
```bash
$ ./scripts/setup_libs.bat [-mingw/-msvc] [32/64]
```
**2.** Build its project.
```bash
$ ./build.bat [-debug/-release] [-mingw/-msvc] [32/64]
```
**3.** Finish!

You can refer to ToDo in <a href="https://github.com/pit-ray/win-vind/projects/2">Projects/win-vind</a>

Pull requests are welcome!

## License

This software is provided by **MIT License**.

## Author

- pit-ray
[E-mail] pit-ray(at)outlook.com
112 changes: 0 additions & 112 deletions README_4xx.md

This file was deleted.

Loading

0 comments on commit 5312858

Please sign in to comment.