How do I install VimR on macOS?

Download the pre-built, signed binary from the GitHub releases page for quick installation. For development, clone the repo and run the build scripts with Xcode and homebrew, as detailed in the README.

VimR vs terminal Neovim: which is better?

VimR adds GUI features like previews and trackpad support for a native macOS experience, but terminal Neovim is more lightweight and cross-platform, so choose based on your workflow and OS needs.

Can I use my Vim plugins with VimR?

Yes, since VimR embeds Neovim, most standard Neovim plugins should work, but GUI-specific integrations might require additional configuration or may not be supported.

How to customize VimR with my Neovim config?

Place your Neovim configuration files (e.g., init.vim) in the appropriate directory; VimR will load them, but check the wiki for any GUI-specific settings or limitations.

Is VimR good for web development?

With HTML and Markdown previews, it's useful for front-end work, but it lacks built-in tools like live servers or extensive frameworks support found in dedicated web IDEs.

What are VimR's system requirements?

Requires macOS 13.0 or later and Xcode 26 for development, as specified in the README, so ensure your Mac is up-to-date to use or build it.

How does VimR compare to other Neovim GUIs like Goneovim?

VimR is Swift-based and deeply integrated with macOS Cocoa, offering better native performance, while others like Goneovim might be cross-platform but less polished on Apple systems.

Open-Awesome

VimR

MITSwiftv0.66.0-20260827.194249

A Neovim GUI for macOS written in Swift, offering modern editor features while embedding Neovim's core.

Visit Website GitHub

7.0k stars233 forks0 contributors

What is VimR?

VimR is a graphical user interface for Neovim built specifically for macOS, written in Swift. It embeds Neovim as its core editing engine while adding modern GUI features like file browsers, previews, and trackpad support, providing a native macOS experience for Vim users.

Target Audience

macOS developers and power users who prefer Neovim's modal editing but want a polished, native GUI application with additional IDE-like features.

Value Proposition

Developers choose VimR for its seamless integration of Neovim's editing capabilities with a native macOS interface, offering features like Markdown preview, fuzzy file finding, and a flexible workspace model not typically available in terminal-based Vim setups.

Overview

VimR — Neovim GUI for macOS in Swift

Use Cases

Best For

macOS users who want a native Neovim GUI with modern editor features
Vim enthusiasts seeking better trackpad and preview support
Developers looking for a lightweight, customizable IDE alternative
Swift developers interested in embedding Neovim in Cocoa applications
Users who prefer modal editing but want Xcode-like file navigation
Projects requiring Markdown or HTML preview alongside code editing

Not Ideal For

Cross-platform development teams requiring editor consistency across macOS, Windows, and Linux
Users who prefer graphical, non-modal editors without learning Vim's keybindings
Projects needing extensive IDE features like integrated debuggers, database tools, or large plugin ecosystems

Pros & Cons

Pros

Native macOS Integration

Built with Swift and Cocoa, VimR offers seamless trackpad gestures, ligatures, and a polished interface that feels at home on macOS, as highlighted in its features.

Powerful Neovim Core

Embeds Neovim for robust modal editing, allowing users to leverage existing Vim configurations and plugins while adding GUI enhancements.

Modular Swift Components

Independent packages like NvimView and NvimApi enable other developers to embed Neovim in Cocoa apps, fostering reuse beyond VimR itself.

Modern GUI Features

Includes live Markdown/HTML previews, fuzzy file finder, and JetBrains-inspired workspace management, bridging Vim's efficiency with IDE-like convenience.

Cons

macOS-Only Limitation

Exclusive to macOS 13.0+, making it unsuitable for developers on other operating systems or in mixed-OS environments, as stated in requirements.

Complex Build Process

Building from source requires Xcode 26, homebrew, and specific shell scripts like build_vimr.sh, which can be cumbersome compared to simpler installs.

Smaller Ecosystem

While it supports Neovim plugins, VimR-specific GUI integrations and community support are limited compared to editors like VS Code or full IDEs.

Experimental Nature

Serves as a playground for Redux architecture, per the philosophy, which might lead to instability or breaking changes not ideal for production-heavy use.

Frequently Asked Questions

Related Projects

micro

A modern and intuitive terminal-based text editor

Stars29,542

Forks1,360

Last commit7 hours ago

TextMate

TextMate is a graphical text editor for macOS 10.12 or later

Stars14,572

Forks1,751

Last commit2 years ago

Notesnook

A fully open source & end-to-end encrypted note taking alternative to Evernote.

Lightweight Plain Text Editor for macOS

Stars8,448

Forks532