Need help with terminal_velocity?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

126 Stars 62 Forks GNU General Public License v3.0 102 Commits 34 Opened issues


A fast note-taking app for the UNIX terminal

Services available


Need anything else?

Contributors list

This is my unmaintained archived copy of Terminal Velocity.

Development has moved to Vincent Perricone's fork, you should use this instead:

Terminal Velocity (seanh's archived copy)

Terminal Velocity
is a fast note-taking app for the UNIX terminal, that focuses on letting you create or find a note as quickly and easily as possible, then uses your
to open and edit the note. It is heavily inspired by the OS X app
Notational Velocity 
. For screenshots and features, see the `Terminal Velocity website <>`_.

To install Terminal Velocity, run::

pip install terminal_velocity

Then to launch it just run::


To use a different notes directory, run::

terminal_velocity path/to/your/notes/dir

To see all the command-line options, run::

terminal_velocity -h

To quit the app, press


To upgrade Terminal Velocity to the latest version, run::

pip install --upgrade terminal_velocity

To uninstall it, run::

pip uninstall terminal_velocity

To make a bug report or feature request, use

GitHub Issues 

To contribute documentation, use

the wiki 

To contribute code to Terminal Velocity, see



To release a new version of Terminal Velocity:

  1. Increment the version number in the file 
    , add an entry te the
    , commit both changes to git and push them to github. For example, see
  2. Upload the new release to

    the terminal_velocity package on pypi 
    _: run
    python sdist upload -r pypi

For more information see

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.