https://github.com/alex35mil/NeoHub

Instance manager for Neovide
https://github.com/alex35mil/NeoHub

neovide neovim

Last synced: 2 months ago
JSON representation

Instance manager for Neovide

• Host: GitHub
• URL: https://github.com/alex35mil/NeoHub
• Owner: alex35mil
• Created: 2023-11-05T16:11:28.000Z (11 months ago)
• Default Branch: main
• Last Pushed: 2024-05-05T12:36:09.000Z (5 months ago)
• Last Synced: 2024-07-03T14:54:08.341Z (3 months ago)
• Topics: neovide, neovim
• Language: Swift
• Homepage:
• Size: 1.11 MB
• Stars: 36
• Watchers: 4
• Forks: 6
• Open Issues: 6
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md

Awesome Lists containing this project

README

        
NeoHub




    



## Why?

[Neovide](https://neovide.dev/) is a sweeeeet GUI for [Neovim](https://neovim.io/), but I had two annoying issues.

1. When multiple instances are running, it is hard to switch between them as each instance is a separate macOS process, and all the processes are named `neovide` in the `⌘ ⇥` list.

2. Often, I accidentally run a project that is already running, resulting in a Neovim error related to existing swap files.

## Features

So, what NeoHub offers?

1. Global hotkey to show a switcher between Neovide instances. You can hit this hotkey from anywhere and activate a project you need.

2. Global hotkey to activate last used editor, if there are mulitple.

3. Hotkey to restart current editor.

4. CLI, which executes new Neovide instances, and if an instance at the current path is already running, it activates it instead of spawning a new one.

## Requirements

- `macOS 13+`.

- Administrative privileges to install the CLI.

- `neovide` available in your `PATH`.

## Download

Get it from the [Releases](https://github.com/alex35mil/NeoHub/releases).

## Installation

This a macOS app. Unzip the `NeoHub.zip` and move `NeoHub.app` to the `Applications` folder.

On the very first launch, you will be asked to install the CLI. You will need to enter an administrative password. 

## Usage

### CLI

Once installed, the `neohub` command should become available in your shell. This is the only way to launch a Neovide through the NeoHub, so use `neohub` instead of `neovide` to launch editors. Otherwise, things won't work.

See `neovide --help` for available options.

### App

Hit `⌘ ⌃ N` (`Command + Control + N`) to open the editor switcher.

Hit `⌘ ⌃ Z` (`Command + Control + Z`) to activate last active editor.

All hotkeys are configurable.

When in the switcher, you can quit all editors at once by pressing `⌘ Q`, or just a selected one with `⌘ ⌫`. Also, you can use `⇥` (`Tab`) to cycle through the editors in the list.

You can set a hotkey to restart current editor in the Settings. Keep in mind, that if you updated env vars and restart the editor - it won't pick up the new env. In this case, you need to shut down the editor and relaunch it from the CLI.

P.S. When you press the editor switcher hotkey and there is only one Neovide instance is running, NeoHub will activate it instead of showing the switcher.

## Credits

App icon is by [u/danbee](https://www.reddit.com/user/danbee/).

## License

MIT.