Skip to main content
Donate to the Python Software Foundation or Purchase a PyCharm License to Benefit the PSF! Donate Now

NextCloud Notes Command Line Interface

Project description

nncli is a Python application that gives you access to your NextCloud Notes account via the command line. It’s a “hard” fork of sncli. You can access your notes via a customizable console GUI that implements vi-like keybinds or via a simple command line interface that you can script.

Notes can be viewed/created/edited in both an online and offline mode. All changes are saved to a local cache on disk and automatically sync’ed when nncli is brought online.

More detailed documentation can be found at the homepage.



  • Via pip (latest release):
    • pip3 install nncli
  • Manually:
    • If you don’t already have it, install Flit: pip3 install flit
    • Clone this repository to your hard disk: git clone
    • Install nncli: flit install --deps production
  • Development:
    • Clone the repo
    • Install Pipenv: pip3 install pipenv
    • Stand up development virtualenv: pipenv install --dev


  • Console GUI
    • full two-way sync with NextCloud Notes performed dynamically in the background
    • all actions logged and easily reviewed
    • list note titles (configurable format w/ title, date, flags, category, keys, etc)
    • sort notes by date, alpha by title, category, favorite on top
    • search for notes using a Google style search pattern or Regular Expression
    • view note contents and meta data
    • pipe note contents to external command
    • create and edit notes (using your editor)
    • edit note category
    • delete notes
    • favorite/unfavorite notes
    • vi-like keybinds (fully configurable)
    • Colors! (fully configurable)
  • Command Line (scripting)
    • force a full two-way sync with NextCloud Notes
    • all actions logged and easily reviewed
    • list note titles and keys
    • search for notes using a Google style search pattern or Regular Expression
    • dump note contents
    • create a new note (via stdin or editor)
    • import a note with raw json data (stdin or editor)
    • edit a note (via editor)
    • delete a note
    • favorite/unfavorite a note
    • view and edit note category


Pull requests are welcome, preferably via emailed output of git request-pull sent to the maintainer (see here for more information). Bug reports should also be directed to the maintainer via email.

If you aren’t hosting a fork anywhere online, you can also send patches using git format-patch (again, see the official documentation ).


Release tags will always be signed with the maintainer’s PGP key (also available on any public keyserver). PGP-signed versions of release tarballs and pre-built wheel packages are available on PyPI, with the signature files living alongside the corresponding artifact (simply append an .asc extension). Because the maintainers of PyPI do not consider PGP signatures to be a user-facing feature, the extension must be added manually in your browser’s URL bar in order to download the signature files.


nncli is a fork of sncli by Eric Davis. This application further pulls in and uses modified versions of the module by Daniel Schauenberg and the module from nvpy by Charl P. Botha.

Project details

Download files

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

Filename, size & hash SHA256 hash help File type Python version Upload date
nncli-0.3.4-py3-none-any.whl (159.0 kB) Copy SHA256 hash SHA256 Wheel py3
nncli-0.3.4.tar.gz (52.7 kB) Copy SHA256 hash SHA256 Source None

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