Skip to content


Subversion checkout URL

You can clone with
Download ZIP
A Vim plugin for pasting to RefHeap.
Branch: master

Merge pull request #4 from tsion/patch-1

Fix account association docs.
latest commit d6d10a4e1a
@Raynes authored



This is a tiny little Vim plugin for pasting to RefHeap.


The majority of this plugin is written in Python. Because of this, you'll need to have a copy of Vim that is compiled with +python enabled. This plugin also makes use of a Python library for copying text to the system clipboard in a cross platform way called xerox, so you'll need that as well. You can install it like so:

pip install xerox

If you don't have pip:

easy_install xerox

If you're on Linux, version 0.3.0 of xerox doesn't work due to a small syntax error in the Linux part of the library. I've only tested this with 0.3.1.

If you're on Windows, you'll need to install the pywin32 library as well (in the same way you installed xerox).

On Linux, xerox uses xclip, so you'll need to install that if your distro doesn't already have it. On OS X, you'll need pbcopy installed, but it should be installed by default. On Windows, you shouldn't need anything but the pywin32 library.

You'll want to copy plugin/ and autoload/ to ~/.vim. If you're using pathogen, you'll just want to put this whole directory into your pathogen path and it'll do the rest.


This library defines a single command, :Refheap. If you run this command with no visual selection, it will paste the whole file. If you run the command with a visual selection, it'll only paste that specific region. By default, pastes are public. If you want to make them private, pass the -p option to :Refheap.

By default, your pastes will be anonymous. If you want to associate them with an account, add the following to your .vimrc:

let g:refheap_token = 'yourtokenhere'
let g:refheap_username = 'username'

You can get your API token by logging in and navigating to the RefHeap API page. Your username is in the upper right corner next to the 'logout' button.

Something went wrong with that request. Please try again.