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.
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.
Recommended
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!
Clone:
cd ~/.config/nvim/rplugin
git clone https://github.com/Floobits/floobits-neovim.git
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.
~/.floorc.json
. You can find your API secret on your settings page. A typical ~/.floorc.json
looks like this:{
"auth": {
"floobits.com": {
"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 https://floobits.com/owner/workspace_name
. 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:
Either create a workspace or join one (:FlooShareDir...
or :FlooJoinWorkspace
)
If you're joining and your local files differ from the workspace, you'll be asked which copy you want to keep.
As you pair, occasionally you'll want to show your colleague some code in another file. Use FlooSummon
for this.
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
.
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.
After removing the plugin from vundle you must again call :UpdateRemotePlugins
. The plugin may generate the following files and directories:
~/.floorc.json
~/floobits
You may wish to delete these after removing this plugin.