Skip to main content

Hyper-secure Quantum-Ready CLI file encryptor: AES-256-GCM + Argon2id with opaque steganographic headers

Project description

cli-encrypt-txt — Quantum-ready File Encryption


A minimal CLI to encrypt/decrypt files with:

  • AES-256-GCM for confidentiality + integrity
  • Password mode using Argon2id (memory-hard, replaces PBKDF2)
  • Opaque/steganographic headers to thwart foreign decryption scripts
  • Memory, Iteration, and Parallelism modification support for hardware customization

AES-256 remains safe vs. Grover’s algorithm.


Purpose

The goal is to ensure security of personal data on cloud platforms instead of a dedicated password manager. This allows those who do not wish to depend on others for their security to take it into their own hands. Additionally, once the file is encrypted, it can be saved on the cloud. Decryption even with Quantum Technology should not be possible, even with people who can access this software and inspect the code. Your data will always be safe and secured even when saved insecurely (email, google drive/OneDrive, dropbox). Additionally, those with powerful processors can make those with limited powerful compute access from being able to decrypt the file, since this is stored in the headers. Furthermore, headers are opaque to further complicate decryption.


Install

Python 3.9+ recommended.

Password mode only

#Windows
python -m venv .venv
.venv/scripts/activate 
pip install cli-encrypt-txt==3.2.0

# Encrypt
cli-encrypt-txt encrypt secret.pdf -p "strong pass" \
  --m-kib 524288 --t-cost 3 --parallelism 4

# Decrypt
cli-encrypt-txt decrypt secret.pdf.enc

# Encrypt with extreme Argon2id settings into a JPEG cover:
python -m cli_encrypt_txt encrypt secret.txt \
  --m-kib 1048576 \
  --t-cost 6 \
  --parallelism 8 \
  --cover cover.jpg
# -> outputs: secret.txt.enc.jpg

# Decrypt (prompts for password; writes secret.txt.enc.dec or strips .enc if present):
python -m cli_encrypt_txt decrypt secret.txt.enc.jpg

No need to keep file name or file extension consistent after encryption. This adds to the security!! The only thing that must be consistent is the password which will be prompted.

Links

Please view the project at PyPI: https://pypi.org/project/cli-encrypt-txt/

Table

Customizations Purpose
--m-kib Sets the memory cost in KiB (used in Argon2id hashing). Higher values increase resistance to brute-force attacks but require more RAM.
--t-cost Sets the time cost (number of iterations) in Argon2id. More iterations = slower password hashing = harder for attackers.
--parallelism Number of threads/lanes to use in Argon2id. Improves performance on multicore CPUs while maintaining security.
--cover Enables steganographic mode, hiding encrypted text inside a cover file (like an image) so the ciphertext doesn’t look suspicious.

Acknowledgements

Thank you to the users!!! I really hope this tool can help improve your system's security and keep unwanted nosy actors out of your personal data! If this project helped please share the repository and let me know what you think! Cheers!

License

MIT License © 2025 Adityakrishna SreeRamachandrarao

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

cli_encrypt_txt-3.2.0.tar.gz (6.7 kB view details)

Uploaded Source

Built Distribution

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

cli_encrypt_txt-3.2.0-py3-none-any.whl (7.3 kB view details)

Uploaded Python 3

File details

Details for the file cli_encrypt_txt-3.2.0.tar.gz.

File metadata

  • Download URL: cli_encrypt_txt-3.2.0.tar.gz
  • Upload date:
  • Size: 6.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.12.0

File hashes

Hashes for cli_encrypt_txt-3.2.0.tar.gz
Algorithm Hash digest
SHA256 6553b815d6e48a2e189e0a330385f8f32991f45feb98753bd3345570b43aa51d
MD5 bdd126b2695b5b79699ffbaa6e86f28a
BLAKE2b-256 84ac432c2b1d5e9c996b8afcfc48ad05eca5e7f6c4baf709938e5e2248555bd4

See more details on using hashes here.

File details

Details for the file cli_encrypt_txt-3.2.0-py3-none-any.whl.

File metadata

File hashes

Hashes for cli_encrypt_txt-3.2.0-py3-none-any.whl
Algorithm Hash digest
SHA256 d7a51aeee8ddd6bb322ba1214566a2a75f3524a348f9d3f960117ce179de7460
MD5 0bc604a3acb90b6e10bb574f0c823398
BLAKE2b-256 1981c476a7f246a2df5b2b3f96778f75e16d87c61950f425998044346ab8d7c8

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