Skip to main content

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.

Installation

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.

Features

  • 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

Acknowledgements

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

Release files for nncli 0.3.8

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for nncli 0.3.8
File Size Uploaded
nncli-0.3.8.tar.gz 29.8 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for nncli 0.3.8
File Interpreter ABI Platform
nncli-0.3.8-py3-none-any.whl Python 3 none any Details

Total release size: 64.6 kB

Release files / nncli-0.3.8.tar.gz

Download URL nncli-0.3.8.tar.gz
Size 29.8 kB
Tags Source
SHA-256 checksum
How to use checksums
950049ff1de45795273d0597cd0b90395c974a45ca17e1ba22c4f27f56c0186e
BLAKE2b-256 checksum
How to use checksums
0d9f05792d46f7c5c915a2a3152e2ac208c19cf3cd0c130500502bf79985dee9
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/5.0.0 CPython/3.12.4

Release files / nncli-0.3.8-py3-none-any.whl

Download URL nncli-0.3.8-py3-none-any.whl
Size 34.8 kB
Tags Python 3
SHA-256 checksum
How to use checksums
51c9c642743a92904aee1fec00fb6ddc37a1cb6f92637d79ffc82c76fb9a685e
BLAKE2b-256 checksum
How to use checksums
5487a34867d2edc1480138ed9161835423ff939e1c12e9bf22d4f27030636ab9
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/5.0.0 CPython/3.12.4

Release history Release notifications | RSS feed

This release

0.3.8 This release

2 release files

0.3.7

2 release files

0.3.6

2 release files

0.3.5

2 release files

0.3.4

2 release files

0.3.2

2 release files

0.3.1

2 release files

0.3.0

2 release files

0.2.0

2 release files

0.1.2

2 release files

0.1.1

2 release files

0.1.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page