This repository has been archived by the owner. It is now read-only.
Live browser interaction for VIM.
Vim script
Switch branches/tags
Nothing to show
Clone or download
Latest commit 1b2038f Mar 3, 2013
Failed to load latest commit information.
plugin don't start the server automatically on Windows Mar 3, 2013
server add windows start script Mar 3, 2013
.gitignore initial commit Mar 2, 2013
LICENSE add README and LICENSE Mar 2, 2013 update README Mar 3, 2013

This plugin implements a VIM interface for browser-connect-server in order to provide a live coding environment similar to the one currently available in LightTable.

If you would like to see it in action, a (very crude) demo video is available here.


Use pathogen (or Vundle) and clone this repository into your ~/.vim/bundle directory. That's it, you're good to go.


Copy the following code snippet into your template and open it inside of a (modern) browser. Make sure that you have VIM running before you do so.

<script src="http://localhost:9001/ws"></script>

After doing so, you should be able to evaluate CSS buffers and JS buffers using <LocalLeader>be as well as selections of JS. The changes should be instantly reflected in your browser. Whenever you save a JS file or an HTML page, the template will be fully refreshed, you can also refresh the template without having to save the file using <LocalLeader>br.


If you installed the plugin someplace other than ~/.vim/bundle/browser-connect.vim you will have to paste the following snippet into your .vimrc file and update the path to reflect the actual location of the browser-connect.vim folder.

let g:bc_server_path = "/home/me/.vim/bundle/browser-connect.vim/server"

To disable the plugin from setting its own mappings, paste the following into your .vimrc file:

let g:bc_no_mappings = 1

You can set your LocalLeader key to be , by doing:

let maplocalleader = ","

If you would like to map your own keys to evaluate buffers, map them to the following commands:

vmap <silent><LocalLeader>be :BCEvaluateSelection<CR>
nmap <silent><LocalLeader>be :BCEvaluateBuffer<CR>
nmap <silent><LocalLeader>br :BCReloadPage<CR>

To disable automatic behavior on save add the following to your .vimrc file:

let g:bc_no_au = 1


To run the plugin on Windows you must start the server yourself by going into the browser-connect.vim/server folder and running the following command: start.bat "-Dhttp.port=9001".


  • VIM 7.0+ compiled with +python
  • Python 2.6+
  • Java 7+