Skip to content


Switch branches/tags


Failed to load latest commit information.
Latest commit message
Commit time

Floobits NeoVim Plugin

Floobits Status

Real-time collaborative editing. Think Etherpad, but with native editors. This is the plugin for NeoVim which replaces our Vim plugin. We also have plugins for Emacs, Sublime Text, and IntelliJ, as well as a web-based editor that supports video chat and screen sharing.

Development status: fairly stable, should work.


Install the plugin in one of the ways described below and then run :UpdateRemotePlugins in Neovim. For the next step please restart neovim. You will need to rerun this command whenever there are updates for the Floobits plugin. Please see :he remote-plugin for more information.


Python is required, please see he: nvim-python for instructions.



Using Vundle, add this to your Vundle section in ~/.config/nvim/init.vim:

Plugin 'floobits/floobits-neovim'

Consult the Vundle Readme for how to set up Vundle.

Please make sure your Vundle is up to date!

Manual (Not recommended)


cd ~/.config/nvim/rplugin
git clone

Move or symlink the rplugin/python directory contents and plugin directories into your ~/.nvim directory. You will not get updates this way. You should use vundle. You could symlink these files but then if we add new files or directories you would have problems.

Setting up the plugin

  "auth": {
    "": {
      "username": "your_username",
      "api_key": "your_api_key",
      "secret": "your_api_secret_not_your_password"


  • :FlooShareDirPublic /path/to/files. Share a directory with others. This will create a new workspace, populate it with the files in that directory, and open the workspace's settings in your browser.
  • :FlooShareDirPrivate /path/to/files. Share a directory with others. This will create a new workspace, populate it with the files in that directory, and open the workspace's settings in your browser.
  • :FlooJoinWorkspace Join a Floobits workspace. Workspace URLs are the same as what you see in the web editor.
  • :FlooLeaveWorkspace. Leave the workspace.
  • :FlooToggleFollowMode. Toggle follow mode. Follow mode will follow the most recent changes to buffers.
  • :FlooSummon. Make everyone in the workspace jump to your cursor.
  • :FlooDeleteBuf. Delete the current buffer from the workspace.
  • :FlooAddBuf. Add a buffer to the workspace. If no buffer is specified, the current buffer is used.
  • :FlooRefreshWorkspace. Scan local workspace copy for changes and prompt to overwrite local/remote if files differ. Useful after switching branches in git.

Typical workflow goes something like this:

  1. Either create a workspace or join one (:FlooShareDir... or :FlooJoinWorkspace)

  2. If you're joining and your local files differ from the workspace, you'll be asked which copy you want to keep.

  3. As you pair, occasionally you'll want to show your colleague some code in another file. Use FlooSummon for this.

  4. Unfortunately, neither Vim nor Neovim has hooks for when new files are created. You'll have to add new files to the workspace manually, either by saving them (:w) or with :FlooAddBuf.

  5. When you're done pairing, you can leave the workspace with :FlooLeaveWorkspace or by quitting your editor.


If you experience problems, try disabling other plugins before submitting a bug report. You can also get a hold of us using IRC, Twitter, or e-mail.

Removing the plugin

After removing the plugin from vundle you must again call :UpdateRemotePlugins. The plugin may generate the following files and directories:


You may wish to delete these after removing this plugin.


Floobits plugin for NeoVim







No packages published