NOTICE: the project is not under maintenance by authors but is open for development by the open-source community.

Geeknote is a command line client for Evernote that can be use on Linux, FreeBSD and OS X. It allows you to:

• create notes in your Evernote account;
• create tags, notebooks;
• use Evernote search in console with different filters;
• edit notes directly in console using any editor: nano, vim, emacs, mcedit;
• sync your local files, directories with Evernote;
• use Evernote with cron or any scripts.

Geeknote is written in Python, so you can use the open source package anywhere you have Python, even in Windows if you like.

Here we have documentation for Geeknote. We'll show basic commands how to work with notes, notebooks and tags in Evernote using Geeknote, also we'll show how to use search to find notes you want and give you some examples.

Installation

You can install Geeknote as a python script.

Downloading and installing from source

# Install dependencies. (This example for Debian-based systems):
$ [sudo] apt-get update; [sudo] apt-get -y install python-setuptools
# Download the repository.
$ git clone git://github.com/VitaliyRodnenko/geeknote.git
$ cd geeknote
# Installation
$ [sudo] python[2] setup.py install
# Launch Geeknote and go through login procedure.
$ geeknote login

Development

Run tests

$ python[2] setup.py test
# or for to run tests with `tox`
$ tox

Settings

Geeknote has some settings that you should know.

Authorization in Evernote

First thing we have to do after installation Geeknote is authorization. To authorize your Geeknote in Evernote launch the command login:

$ geeknote login

This will start the authorization process. Geeknote will ask you to enter your credentials just once to generate access token, which will be saved in local database. Re-authorization is not required, if you won't decide to change user. After authorization you can start to work with Geeknote.

Logout and change user

If you want to change Evernote user you should launch logout command:

$ geeknote logout

And after you can repeat authorization step.

###Look your settings

$ geeknote settings
Geeknote
******************************
Version: 0.1
App dir: /Users/username/.geeknote
Error log: /Users/username/.geeknote/error.log
Current editor: vim
******************************
Username: username
Id: 11111111
Email: example@gmail.com

Set up the default editor

Geeknote allows to edit notes right in console editors in markdown format. We will show it a later in documentation.

And you can setup the default editor you want to use. To check which editor is now set up as a default call:

$ geeknote settings --editor

To change the default editor call:

$ geeknote settings --editor vim

Example

$ geeknote settings --editor
  Current editor is: nano
$ geeknote settings --editor vim
  Editor successfully saved
$ geeknote settings --editor
  Current editor is: vim

Creating notes

The main functionality that we need is creating notes in Evernote.

Synopsis