What is powdernote?

Powdernote is a note-taking, cloud-based application for the terminal.

Why powdernote?

Because we never leave the terminal, not even to read our notes or create new ones.

This tool is for busy engineers, developers, power users, devops, ...

Our target is to have an un-cluttered, distraction-free application to solve the simple task of taking notes and having them available everywhere (storage is on the cloud)!

Main functions

Get it and try it

powdernote is just a client application, you can grab it and install it easily, but then you need an OpenStack Swift backend as your cloud storage.

For this you have three options:

  1. Deploy your own Swift backend
  2. Use our scripts to get a Swift all-in-one VM (see below)
  3. Ask us for a free, no-sla, no-guarantees, test account from one of our clouds (see below)

Client installation

  1. Download the repository (clone or get the archive)
  2. Cd to the powdernote folder
  3. Run the two commands below (note, you need pip and python 2.7):
    python setup.py sdist
    sudo pip install dist/powdernote-1.0.tar.gz
  4. Copy the sample configuration to your home directory and fill-in your credentials:
    cp powdernoterc_sample.txt ~/.powdernoterc
    vim ~/.powdernoterc
  5. Now go ahead and use it:
    powdernote -h

If you get this error:

      Auth versions 2.0 and 3 require python-keystoneclient, install it or use Auth
      version 1.0 which requires ST_AUTH, ST_USER, and ST_KEY environment
      variables to be set or overridden with -A, -U, or -K.
try sudo –H pip uninstall six and sudo –H easy_install six and everything should work again.

Get a all-in-one OpenStack Swift VM as storage back-end

If you want to create your own local VM for powdernote, then go into the Vagrant folder inside the powdernote repo.

Edit the user.sh file to set your username and password, then just run vagrant up and the machine will start up and configure itself. Now you only have to change your credentials in the .powdernoterc file.

The [Auth] section of the file will look like this (update username, password and container name):


In case you shut down your VM with vagrant halt, don't worry. There is a script in the Vagrant folder that will boot your storage environment safely, just run ./reinstallSwift.sh. It opens a screen session that can be closed with ctrl+a, d. Your powdernote storage is now accessible again.

Get some object storage from us (ICCLab)

We can give you some Swift storage for powdernote, send us an email and we will give you the credentials (you can then change your password with powdernote pwd).

This service comes for free, but with no warranties: we are happy to give you a bit of our clouds, but if you choose so you will not consider us responsible for any loss or damage derived from the use of our service (e.g., loss of data, downtimes, data exposure, ...).

The bottom line is: do not use our Swift service for content-sensitive notes and frequently export your notes to files :). To emphasize this, you will receive an HTTP (not HTTPS) endpoint for Swift.

Contacts: anke at zhaw dot ch or piiv at zhaw dot ch

Made by