Skip to main content

A Secure CLI Note Keeper for Termux Users

Project description

🧠 Termux Remember

Secure CLI Note Keeper for Termux with Tagging & Password Protection


📦 Description

termux-remember is a secure, offline-first, and interactive command-line note-taking assistant built especially for Termux users. It supports:

  • 📝 Multi-line and single-line notes
  • 🔐 Password protection (per-note)
  • 🏷️ Tagging system with powerful tag operations
  • 🔍 Keyword search
  • 🧹 Full interactive input modes
  • 🖥️ Beautiful output with rich
  • 📂 Local-only storage for privacy

⚙️ Installation

Option 1: Clone and Install

git clone https://github.com/mallikmusaddiq1/termux-remember.git
cd termux-remember
pip install .

Option 2: Install via pip

pip install termux-remember

After installation, use the remember command from anywhere in Termux.


🧠 Termux Remember - CLI Reference

An interactive terminal-based assistant to securely store your personal notes, ideas, and tasks. Supports tagging, password-protection, multi-line entries, and keyword-based search.


📁 STORAGE DIRECTORY

  • ~/.termux_remember/user.json → User credentials
  • ~/.termux_remember/memory.json → Saved notes

🔐 USER AUTHENTICATION

--signup           Register with your email and password
--login            Login to your account
--logout           Logout from the current session

📝 NOTE ADDITION & EDITING

--add TEXT         Add a note (single-line)
--add              Launch interactive input mode (multi-line)
--edit-note ID     Edit a specific note by its ID (interactive)
--tag TAG          Add a tag to your note
--password         Protect your note with your login password

📥 INTERACTIVE INPUT MODES

1. Single-line input

remember --add "Today I learned Python!"

2. Multi-line interactive input

remember --add

Then type:

Note: This app is helpful.
It supports password protection.
EOF

✅ Finish with EOF on a new line


🏷️ TAGGING & MANAGEMENT

--retag ID TAG             Change tag of a note
--list-tag                 List all unique tags
--delete-all-tags          Remove all tags
--delete-specific-tag TAG  Remove a specific tag
--rm-note-tag ID           Remove tag from a specific note

📋 LIST & SEARCH

--list             List all saved notes (🔐 = password-protected)
--find KEY         Search notes by keyword
--view-note ID     View full note by ID
--show-tag TAG     Show notes under a specific tag

🗑️ NOTE DELETION

--forget ID        Delete a specific note
--forget-all       Delete all notes (confirmation + password required)

🔐 SECURITY DETAILS

  • Passwords stored securely using SHA-256 hashing
  • Protected notes are hidden unless verified
  • View/delete of protected notes requires confirmation

🧪 USAGE EXAMPLES

remember --signup
remember --login
remember --add "Call mom" --tag "family"
remember --add --tag "diary" --password
remember --edit-note 2
remember --find "milk"
remember --view-note 2
remember --retag 2 "tasks"
remember --list-tag
remember --delete-all-tags
remember --delete-specific-tag "family"
remember --rm-note-tag 2
remember --forget 2
remember --forget-all

🔑 FORGOT PASSWORD?

Just create a new account using --signup


📦 VERSION & META

--version          Show version and author details

👨‍💻 AUTHOR

Mallik Mohammad Musaddiq 📧 Email: mallikmusaddiq1@gmail.com 🌐 GitHub: mallikmusaddiq1


🌐 GITHUB REPOSITORY

https://github.com/mallikmusaddiq1/termux-remember


📄 LICENSE

This project is licensed under the MIT License – see the LICENSE file for details.


Made with ❤️ for Termux users who don’t want to forget little things.

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

termux_remember-1.1.1.tar.gz (10.1 kB view details)

Uploaded Source

Built Distribution

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

termux_remember-1.1.1-py3-none-any.whl (10.9 kB view details)

Uploaded Python 3

File details

Details for the file termux_remember-1.1.1.tar.gz.

File metadata

  • Download URL: termux_remember-1.1.1.tar.gz
  • Upload date:
  • Size: 10.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.12.11

File hashes

Hashes for termux_remember-1.1.1.tar.gz
Algorithm Hash digest
SHA256 6abbbc310100810ecc226fed9fd79bf2e6b7b6c8ad955a76dcf7d111dd86d188
MD5 ed841b0402d987cb6567670fc4fb6dae
BLAKE2b-256 ca24a6f76e06cb88318fbbeabbbabd137ebade130947f8bbe6ce23d9a7f498a9

See more details on using hashes here.

File details

Details for the file termux_remember-1.1.1-py3-none-any.whl.

File metadata

File hashes

Hashes for termux_remember-1.1.1-py3-none-any.whl
Algorithm Hash digest
SHA256 2096d5bce01611c40d9dedc73de01511390b916a333a49484cb53414dffd391f
MD5 7bc54d85a0835e4fd60db087aafda3a3
BLAKE2b-256 806072edfcba69409813d10158b4352dc273e00bfa7f52cfacc1dafeed8337f0

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