Skip to main content

The offline authenticated note-taking app for the terminal.

Project description

Nott

The offline authenticated NOte-Taking app for the Terminal.

Since Nott is completely offline, you can securely store your data locally with no possible interception. Even if the database is directly accessed, it shows only encrypted body content. Things such as title, tags, and datetime values are all stored in plaintext.

Installation

Nott is available from PyPI:

pip install nott

Commands

[!NOTE] The following commands and examples are a quick overview of everything, but there is also a --help argument that lists everything for you when using the application.

Command Description Quick Link
nott init Initialize the environment for Nott nott init
nott login Create a local cached session key nott login
nott logout Remove local session key nott logout
nott add Add a new note to the local database nott add
nott list List all available notes based on title and/or tag nott list
nott show Show the contents of the note, if authenticated nott show
nott edit Edit the note in your default $EDITOR nott edit
nott update-title Update the title of the note after creation nott update-title
nott set-tags Update the tags associated with the note after creation nott set-tags
nott search Search the contents of the file (does not show the contents) nott search
nott rm Delete the note permanently nott rm
nott change-pass Change the stored password in the database and config nott change-pass
nott export Export all notes in Markdown to a designated directory nott export

nott init

Usage

nott init

nott login

Usage

nott login

nott logout

Usage

nott logout

nott add

Argument Description
title The title of the note being added
--tags Comma-separated tags for the note
--body The contents of the note

Usage

nott add "Title" --tags "tag1,tag2,tag3" --body "Encrypted body content stored within the note"

nott list

Argument Description
--tag Filter by a specific tag
--query Filter the title by substring
--limit The number of notes to query

Usage

nott list --tag "tag1" --query "Title" --limit 10

nott show

Argument Description
id The ID of the note you want to access

Usage

NOTE: This is just an example ID. Use nott list to see your local notes or nott add to create one.

nott show "b27cfd56-c3b4-4343-ac90-87ecd806d31c"

nott edit

Argument Description
id The ID of the note you want to access

Usage

NOTE: This is just an example ID. Use nott list to see your local notes or nott add to create one.

nott edit "b27cfd56-c3b4-4343-ac90-87ecd806d31c"

nott update-title

Argument Description
id The ID of the note you want to access
--title The new title for the note

Usage

NOTE: This is just an example ID. Use nott list to see your local notes or nott add to create one.

nott update-title "b27cfd56-c3b4-4343-ac90-87ecd806d31c" --title "New Title"

nott set-tags

Argument Description
id The ID of the note you want to access
--tags Comma-separated tags for the note

Usage

NOTE: This is just an example ID. Use nott list to see your local notes or nott add to create one.

nott set-tags "b27cfd56-c3b4-4343-ac90-87ecd806d31c" --tags "Tag1, Tag2, Tag3"

nott search

Argument Description
term Searches the bodies of all notes (does not show the contents, decrypts-on-the-fly)

Usage

NOTE: This is very similar to how grep operates if you're familiar with it.

nott search "Secret value within body"

nott rm

Argument Description
id The ID of the note you want to access
--yes Skip the confirmation

Usage

NOTE: This is just an example ID. Use nott list to see your local notes or nott add to create one.

nott rm "b27cfd56-c3b4-4343-ac90-87ecd806d31c"

nott change-pass

Usage

nott change-pass

nott export

Argument Description
--path The directory to export Markdown files to

Usage

nott export --path "export_dir"

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

nott-0.1.0.tar.gz (509.4 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

nott-0.1.0-py3-none-any.whl (9.7 kB view details)

Uploaded Python 3

File details

Details for the file nott-0.1.0.tar.gz.

File metadata

  • Download URL: nott-0.1.0.tar.gz
  • Upload date:
  • Size: 509.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.7

File hashes

Hashes for nott-0.1.0.tar.gz
Algorithm Hash digest
SHA256 1f1b624cf8051027affd079b6550025508086748dadc7b33a5aa54af1d59cfa9
MD5 35ebecfc8a91c7761e4fddf83a2d2330
BLAKE2b-256 c28cf2152e7588eab4c314277539ff58a4b796ba35f210b2d3e845fadf479257

See more details on using hashes here.

File details

Details for the file nott-0.1.0-py3-none-any.whl.

File metadata

  • Download URL: nott-0.1.0-py3-none-any.whl
  • Upload date:
  • Size: 9.7 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.7

File hashes

Hashes for nott-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 dd5700a6643d1ad0be9e935671269ff74856b723382c14d14a69316368aef086
MD5 67fbbe7f1546db1e6249ecbc9b1b37db
BLAKE2b-256 91cdc42de797640eff6b57684b764ca47f16635da6c861014c2aa12bbdf691b9

See more details on using hashes here.

Supported by

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