Skip to main content

A cross-platform simplenote-syncing note-taking app inspired by nvALT.

Project description


nvpy is a simplenote-syncing note-taking tool inspired by nvALT (OS X) and ResophNotes (Windows). It is significantly uglier, but it is cross-platform. Yes, you heard right, you can run this on Linux (tested), Windows (tested) and OS X (in theory).

It was written by Charl Botha, who needed a simplenote client on Linux and doesn’t mind ugliness (that much).


If nvpy blows up your computer, loses your job or just deletes all your notes, I am NOT liable for anything. Also see the liability clause at the end of the new BSD licence text in the COPYRIGHT file.

That being said, I use nvpy daily on my own precious notes database and it hasn’t disappointed me (yet).


This is what nvpy looked like on Windows on May 23, 2012. Search bar at the top showing a regular expression, notes are sorted last modified first, continuously updated markdown preview in chrome behind the nvpy window:


Here’s a screenshot showing the automatic hyperlinking on Linux:



To get the latest version from github, do:

pip install git+

I’ll upload this to pypi soon.

How to run for the first time

Create a file called .nvpy.cfg in your home directory that looks like the following:

[default] sn_username = your_simplenote_username sn_password = your_simplenote_password

If you installed this via pip install, you should now be able to start the application by typing “nvpy”. The first time you run it, it will take a while as it downloads all of your simplenote notes. Subsequest runs are much faster as it uses the database it stores in your home directory.

The [example nvpy.cfg][ex_nvpycfg] shows how you can configure the font family and size.


  • Syncs with simplenote.
  • Partial syncs (whilst notes are being edited) are done by a background thread so you can keep on working at light speed.
  • Can be used offline, also without simplenote account.
  • Search box does realtime regular expression searching in all your notes.
  • Markdown rendering to browser.
  • Continuous rendering mode: If you activate this before starting the markdown rendering, nvpy will render new html of the currently open note every few seconds. Due to the refresh tag in the generated HTML, the browser will refresh every few seconds. MAGIC UPDATES!
  • Automatic hyperlink highlighting in text widget.
  • KickAss(tm) inter-note linking with [[note name]]. If note name is not found in current list of notes, assumes it’s a regular expression and sets it in the search bar. See the [screencast][inl_screencast].

Planned features

  • Undo / redo.
  • Full(ish) screen mode.
  • Full syncs also in background thread. At the moment does a full sync at startup, which can take a while. nvpy already does background thread saving and syncing while you work, so everything you type is backed up within a few seconds of you typing it.
  • Tag support.

Bugs and feedback

  • Report bugs with [the github issue tracker](
  • It’s an even better idea to clone, fix and then send me a pull request.
  • If you have questions, or would like to discuss nvpy-related matters, please do so via the [nvpy google discussion group / mailing list](!forum/nvpy)
  • If you really like nvpy, you could make me and you even happier by [tipping me with paypal][paypal]!


  • nvpy uses the [fantastic library by mrtazz][snpy]
  • The brilliant application icon, a blue mini car (not as fast as the notational velocity rocket, get it?), is by [Cemagraphics][cg]

[ex_nvpycfg]: [inl_screencast]: [paypal]: [snpy]: [cg]:

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for nvpy, version 0.1
Filename, size File type Python version Upload date Hashes
Filename, size nvpy-0.1.tar.gz (49.0 kB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page