incandescentman/terminal_velocity

Currently in Maintence Mode - A fast note-taking app for the UNIX terminal

Terminal Velocity

Terminal Velocity is currently in maintenance mode. Python pip installs are still supported and the software is stable for day-to-day use with Python 2. The software is being moved into maintenance mode because both authors no longer use Terminal Velocity. Life happens, and finding the time to maintain it is difficult. We hope you understand.

If you find a true bug and need help, please reach out via email to Vincent. You can find my email in my profile here.

Forked Version for Python 3

This fork of Terminal Velocity is an attempt to get it running with Python 3. Please note that I am still learning and might need help to get everything fully functional.

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 $EDITOR 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.

Installation

Pip - python package manager

To install Terminal Velocity, run:

pip install terminal_velocity

Then to launch it just run:

terminal_velocity

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 ctrl-c or ctrl-x.

To upgrade Terminal Velocity to the latest version, run:

pip install --upgrade terminal_velocity

To uninstall it, run:

pip uninstall terminal_velocity

From Source

Ensure Python modules urwid, setuptools, and chardet are installed. Also, ensure that Python development headers are installed.

apt install python3-setuptools python3-chardet python3-urwid python3-dev

Clone the repository from:

[email protected]:yourusername/terminal_velocity.git
or
https://github.com/yourusername/terminal_velocity.git

Move into the terminal_velocity directory you just cloned and run the following:

sudo python3 setup.py install

Releasing to PyPi

To release a new version of Terminal Velocity:

1. Make sure you have set up your ~/.pypirc file for PyPi uploading.
2. Increment the version number in the setup.py file, add an entry to the changelog, commit both changes to git, and push them to GitHub. For example, see aae87b.
3. Upload the new release to the terminal_velocity package on PyPi: run python3 setup.py sdist upload -r pypi.

For more information, see https://packaging.python.org/.

To contribute code to Terminal Velocity, see CONTRIBUTING.