Support via Liberapay

org-velocity.el — something like Notational Velocity for Org

1. General

org-velocity implements an interface for Org inspired by the minimalist notetaking program Notational Velocity. The idea is to allow you to amass and access brief notes on many subjects with minimal fuss.

2. How to use it

Org-velocity can be used in two ways: to store and access notes from anywhere in a universal bucket file; or to navigate any Org file.

2.1. The interface

The central command, org-velocity-read, prompts for search terms. The result is a list of all entries where those search terms appear, either in the heading or in the text.

If there is only one result, org-velocity offers to visit that entry in an indirect buffer.

If there are no results, org-velocity offers to create a new entry using org-rememember and supplies the search terms to the Remember buffer as its heading.

If there is more than one result, org-velocity displays a buffer with the headings of all matching entries. An entry is selected either by clicking on it or typing the hint character beside it. Once selected the entry is visited in an indirect buffer.

2.1.1. Navigating Org files

The easiest way to try org-velocity is in an existing Org file. First load it, then run:

M-x org-velocity-read

2.1.2. Using a bucket file

You can set a bucket file with:

M-x customize-variable RET org-velocity-bucket RET 

Org-velocity will then use the bucket file as its target whenever it is called outside of Org.

2.2. Configuration

To configure org-velocity, do:

M-x customize-group RET org-velocity RET

You may also want to bind org-velocity-read to a key. Add a line like this to your .emacs:

(global-set-key (kbd "C-c v") 'org-velocity-read)

2.3. Loading it (No surprises here)

The easiest way is by

M-x customize-apropos org-modules

Check the line for velocity. This will cause it to be loaded every time you start org-mode.

You'll still have to load it manually the first time.

Of course, you can also just try it out by loading it manually.

If you prefer to manually customize your emacs then make sure that the path to org's contrib directory is in your load-path and add the following to your .emacs.

(require 'org-velocity)

3. Credits

Paul M. Rodriguez wrote org-velocity incorporating suggestions from Carsten Dominik and Bastien Guerry.

Documentation from the website (either in its HTML format or in its Org format) is licensed under the GNU Free Documentation License version 1.3 or later. The code examples and css stylesheets are licensed under the GNU General Public License v3 or later.