mirror of
https://github.com/qvacua/vimr.git
synced 2024-09-17 12:07:08 +03:00
71 lines
2.6 KiB
Markdown
71 lines
2.6 KiB
Markdown
# VimR — Neovim GUI for macOS
|
|
|
|
[Download](https://github.com/qvacua/vimr/releases) • [Documentation](https://github.com/qvacua/vimr/wiki)
|
|
|
|
|
|
|
|
|
|
## About
|
|
|
|
Project VimR is a Neovim GUI for macOS written in Swift.
|
|
|
|
The goal is to build an editor that uses Neovim inside with many of the convenience
|
|
GUI features similar to those present in modern editors. We mainly use Swift,
|
|
but also use C/Objective-C when where appropriate.
|
|
|
|
There are other Neovim GUIs for macOS, see the [list](https://github.com/neovim/neovim/wiki/Related-projects#gui), so why?
|
|
|
|
- Play around with [Neovim](https://github.com/qvacua/neovim),
|
|
- play around with Swift (and especially with [RxSwift](https://github.com/ReactiveX/RxSwift)),
|
|
- Play around with the main idea of Redux architecture, and
|
|
- (most importantly) have fun!
|
|
|
|
If you feel chatty, there is a chat room: <https://matrix.to/#/#vimr:matrix.org>
|
|
|
|
If you want to support VimR financially, use [Github's Sponsor](https://github.com/sponsors/qvacua).
|
|
|
|
## Download
|
|
|
|
Pre-built Universal signed and notarized binaries can be found under [Releases](https://github.com/qvacua/vimr/releases).
|
|
|
|
## Reusable Components
|
|
|
|
* [RxMsgpackRpc](https://github.com/qvacua/vimr/blob/develop/RxPack/RxMsgpackRpc.swift): Implementation of MsgpackRpc using RxSwift.
|
|
* [RxNeovimApi](https://github.com/qvacua/vimr/blob/develop/RxPack/RxNeovimApi.swift): RxSwift wrapper of Neovim API.
|
|
* [NvimView](https://github.com/qvacua/vimr/tree/develop/NvimView): SwiftPM module containing an NSView which bundles everything, e.g., Neovim binary and its `runtime`-files, needed to embed Neovim in a Cocoa App.
|
|
|
|
## Some Features
|
|
|
|
* Markdown preview
|
|
* Generic HTML preview (retains the scroll position when reloading)
|
|
* Fuzzy file finder a la Xcode's "Open Quickly..."
|
|
* Trackpad support: Pinching for zooming and two-finger scrolling.
|
|
* Ligatures: Turned off by default. Turn it on in the Preferences.
|
|
* Command line tool.
|
|
* (Simple) File browser
|
|
* Flexible workspace model a la JetBrain's IDEs
|
|
|
|
## How to Build
|
|
|
|
Clone this repository. Install `homebrew`, then in the project root:
|
|
|
|
```bash
|
|
git submodule init
|
|
git submodule update
|
|
|
|
xcode-select --install # install the Xcode command line tools, if you haven't already
|
|
brew bundle
|
|
|
|
clean=true notarize=false ./bin/build_vimr.sh
|
|
# VimR.app will be placed in ./build/Build/Products/Release/
|
|
```
|
|
|
|
## Development
|
|
|
|
See [DEVELOP.md](DEVELOP.md).
|
|
|
|
## License
|
|
|
|
[MIT](https://github.com/qvacua/vimr/blob/master/LICENSE)
|
|
|