evernote-note-graph

EvernoteNoteGraph

A small Go program that generates a graph of all linked notes a user has created in Evernote.

EvernoteNoteGraph uses the Evernote API to retrieve all notes and generates a note graph in GraphML format based on the Note Links detected across all notes. Technically speaking the generated note graph is a directed disconnected multigraph.

The note graph in GraphML format can then be loaded into a graph editor such as yEd, Gephi, or Cytoscape for layouting, exploration, and analysis.

All nodes in the graph have URLs to the Evernote note allowing the respective note to be looked up easily.

Inspiration

EvernoteNoteGraph is inspired by the way Roam and Obsidian visually display linked notes as a graph.

Prerequisites

In order to use EvernoteNoteGraph you have to request a DeveloperToken for your Evernote account. You may need to contact Evernote support to get the feature enabled for your account.

Installation

To use EvernoteNoteGraph download the evernote-note-cloud Git repository from GitHub and use Go to build the binary for your platform.

    $ wget https://github.com/qpanda/evernote-note-graph/archive/master.zip
    $ unzip evernote-note-graph-master.zip
    $ cd evernote-note-graph-master
    $ go build

Using EvernoteTagCloud

Run evernote-note-graph -h to get usage information. All parameters except for -edamAuthToken (Evernote Developer Token / API Key) are optional.

$ evernote-note-graph -h
Usage of evernote-note-graph:
-edamAuthToken string        
        Evernote API auth token
-graphMLFilename string
        GraphML output filename (default "notegraph.graphml")
-linkedNotes
        Include only linked Notes (default true)
-noteURL string
        WebLink or AppLink for Note URLs (default "WebLink")
-sandbox
        Use sandbox.evernote.com
-v    Verbose output

Examples

examples/EvernoteNoteGraph.png is an example note graph created from an Evernote account containing 1,500+ notes with 461 linked notes (nodes) and 636 note links (edges).

The note graph has been created by executing the following commands.

    $ evernote-note-graph -edamAuthToken=<evernoteAuthToken> >notegraph.log
    $ java -jar saxon-he-10.1.jar notegraph.graphml notegraph-yed.xslt >notegraph-yed.graphml

The resulting notegraph-yed.graphml was then loaded into yEd 3.20 for layouting (Layout > Organic), removing node labels (Edit > Select All, Edit > Properties > Label > Visible), and exporting to PNG (File > Export...).

To open the Evernote note represented by a node in the graph right-click on the node and select Go to URL. URLs are being retained when exporting to SVG.

License

EvernoteNoteGraph is licensed under the MIT license.