skip to navigation
skip to content

Not Logged In

pynote 0.1b2

Manage notes on the commandline.

Package Documentation

Latest Version: 0.2.2

pynote is a project to manage your notes on the commandline. It is entirely written in Python 3 and provides a very handy cmd-interface.

The project is not stable yet! So be careful!

You can browse the source code in cgit. A github mirror is also available. Please do not use any of these cool github pull requests because they will mess up the git history (see CONTRIBUTING file)!


  • create, delete, update, list and read notes
  • list deleted notes in 'trash'
  • everything is stored in human readable JSON files
  • nice meta data for every note including creation time, updating time, deletion time, uuid, tags


  • version control (diff revisions, revert revisions)
  • trash to ensure you do not loose any data
  • export module
  • syntax highlighting using pygments for managing code snippets
  • tags and filters

basic usage

At first you have to create the configfile noterc and the data directory ~/.note. There is a script included to do this.:

$ note-init

create a new note

$ note new "spam"

Your editor (e.g. nano) will open and you can type in your content.

list notes

$ note list
| id | title | updated          |
| 1  | spam  | 2013-12-09 10:59 |

edit note

$ note edit 1

Your editor opens with the content of the note. After saving your modifications she revision number is incremented.

delete note

$ note delete 1

read a note

$ note show 1
| title:    spam
| created:  2013-12-09 10:59
| updated:  2013-12-09 10:59
| revision: 1
| uuid:     188fcae5-86cf-4e5a-b955-35b38694bb43

Spam, Spam, Spam, lovely Spam
Wonderful Spam, Lovely Spam.
Spam, Spam, Spam, magnificent Spam,
Superlative Spam.
Spam, Spam, Spam, wonderous Spam,
Surgical Spam, splendiferous Spam.
Spam, Spam, Spam, Spaaam!

show trash

$ note trash
| id | title  | deleted          |
| 1  | spam   | 2013-12-09 13:05 |
| 0  | spam2  | 2013-12-09 13:04 |


In Arch Linux you can use the PKGBUILD in AUR. Otherwise use (add --pre for dev releases):

$ pip install pynote
File Type Py Version Uploaded on Size
pynote-0.1b2.tar.gz (md5, pgp) Source 2013-12-10 5KB
  • Downloads (All Versions):
  • 14 downloads in the last day
  • 130 downloads in the last week
  • 808 downloads in the last month