Skip to main content

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.


Assuming your system has both python3 and pip3, you can globally install nncli and its dependencies with pip3 install nncli.

If you are interested in packaging nncli for various distributions, please consult the file CONTRIBUTING.rst in this repository and reach out to the mailing list with any questions.


  • 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


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.

Source Distribution

nncli-0.3.7.tar.gz (76.6 kB view hashes)

Uploaded source

Built Distribution

nncli-0.3.7-py3-none-any.whl (36.5 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page