floobits

https://github.com/Floobits/floobits-emacs.git


    git clone 'git://github.com/Floobits/floobits-emacs.git'

★57

Floobits plugin for Emacs

Real-time collaborative editing. Think Etherpad, but with native editors. This is the plugin for Emacs. We also have plugins for Sublime Text, Vim, and IntelliJ.

Development status: Reasonably stable. We've tested it on Emacs 24 and later. Earlier versions probably won't work. This plugin requires Python 2.7 or later.

Installation

MELPA

If you have MELPA, simply M-x package-install <RET> floobits <RET>

el-get

If you have el-get, simply M-x el-get-install <RET> floobits <RET>. To keep everything up to date, you can add the following line to your ~/.emacs:

(el-get-update-all 1)

Manual installation

cd ~/.emacs.d/
git clone https://github.com/Floobits/floobits-emacs.git floobits
Add Floobits to your ~/.emacs: (load "~/.emacs.d/floobits/floobits.el")

Initial set-up

Create a Floobits account or sign in with GitHub.
Set up your ~/.floorc.json. You can find a personalized ~/.floorc.json 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"
    }
  }
}

Usage

All commands are documented in apropos-command <RET> floobits

M-x floobits-join-workspace <RET> https://floobits.com/owner/workspace/ <RET> Join an existing floobits workspace.
M-x floobits-share-dir-private <RET> DIR <RET> Create a workspace and populate it with the contents of the directory, DIR (or make it).
M-x floobits-share-dir-public <RET> DIR <RET> Create a workspace and populate it with the contents of the directory, DIR (or make it).
M-x floobits-leave-workspace <RET> Leave the current workspace.
M-x floobits-summon <RET> Summon everyone in the workspace to your cursor position.
M-x floobits-follow-mode-toggle <RET> Toggle following of recent changes.
M-x floobits-clear-highlights <RET> Clears all mirrored highlights.

Help

If you have trouble setting up or using this plugin, please contact us.