Skip to content

383494/CoVim

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

CoVim

Collaborative Editing for Vim (One of Vim's most requested features) is finally here! Think Google Docs for Vim.

By: Fred Schott, Sam Haney
Follow @FredKSchott for development news and updates!

Demo Gif

Features

  • Allows multiple users to connect to the same document online
  • Displays collaborators with uniquely colored cursors
  • Works with your existing configuration
  • Easy to set up & use
  • And More!

Installation

CoVim requires a version of Vim compiled with python 3.0+. Visit Troubleshooting if you're having trouble starting Vim. Also note that the Twisted & Argparse libraries can also be installed via apt-get & yum.

Install With Pathogen:

  1. pip3 install twisted argparse service_identity
  2. cd ~/.vim/bundle
  3. git clone git://github.com/FredKSchott/CoVim.git

Install With Vundle:

  1. pip3 install twisted argparse service_identity
  2. Add Plugin 'FredKSchott/CoVim' to your ~/.vimrc
  3. vim +PluginInstall +qall

Install Manually:

  1. pip3 install twisted argparse service_identity
  2. Add CoVimClient.vim & CoVimServer.py to ~/.vim/plugin/

If Vim is having trouble finding modules (twisted, argparse, etc) do the following:

  1. run pip3 show MODULE_NAME and get the Location: path
  2. add the following line to your .vimrc: python3 import sys; sys.path.append("/module/location/path/") using the module path found in step 1.
  3. Repeat until all modules are included in your path

If you're still having trouble, visit the wiki for additional troubleshooting & FAQ

Usage

To start a new CoVim server: :CoVim start [port] [name] (or, from the command line: ./CoVimServer.py [port])
To connect to a running server: :CoVim connect [host address / 'localhost'] [port] [name]
To disconnect: :CoVim disconnect
To quit Vim while CoVim is connected: :CoVim quit or :qall!

Customization

Add any the following to your .vimrc to customize CoVim:

let CoVim_default_name = "YOURNAME"
let CoVim_default_port = "YOURPORT"  

Links

Announcement Post
FAQ
Troubleshooting

Special Thanks

Tufts Professor Ming Chow for leading the Senior Capstone Project that CoVim was born in.

Analytics

Releases

No releases published

Packages

No packages published

Languages

  • Vim Script 70.0%
  • Python 30.0%