aesus 0.1.0

A lean, secure AES-256 encryption tool with a CLI.
aesus-0.1.0 is not a library.
Visit the last successful build: aesus-0.4.0

AESus πŸ”βœοΈπŸ‘Ή

Because your secrets deserve more than earthly protection.


🧿 What is This?

AESus is a lean, word-based AES-256 encryption tool written in Rust, with just a hint of divine mischief. It turns memorable passphrases into strong encryption keys, helping you lock up your messages and files without resorting to arcane keyfiles or 32-character gibberish.

It’s built for privacy nerds, terminal romantics, and anyone who prefers encryption with a little style.


✨ Features

  • πŸ”‘ Word-based passphrases β†’ SHA-256 β†’ AES-256 key (easy to remember, hard to brute force)
  • πŸ” AES-256-CBC encryption/decryption with IV embedding
  • πŸ“ File encryption/decryption support with .aesus extension
  • 🎲 Diceware-style passphrase generator
  • βš™οΈ Clean and simple CLI built with clap
  • πŸ¦€ Fast, safe, zero-bullshit Rust implementation

πŸ“¦ Usage

βœ… Install (locally)

cargo install --path .

Or install globally from crates.io (after publishing):

cargo install aesus

πŸ” Encrypt a message:

aesus encrypt --key "scythe-raven-lemon-halo" "Confess nothing"

πŸ”“ Decrypt a hex blob:

aesus decrypt --key "scythe-raven-lemon-halo" --hex "1a221634c2c8bd5fe99325ffd320acba" --iv "529ded313a437c067d29893ec4772195"

πŸ“ Encrypt a file:

aesus encrypt --key "pancake-prophet-echo-oxide" --file secret.txt

Creates: secret.txt.aesus

πŸ“‚ Decrypt a file:

aesus decrypt --key "pancake-prophet-echo-oxide" --file secret.txt.aesus

🎲 Generate a passphrase:

aesus generate --words 6

Example output:

nightcore-jungle-toast-absinthe-flame-honey

Strong. Memorable. Weirdly poetic.


πŸ›  Roadmap

  • CLI using clap β€” built with clean flags and minimal ceremony
  • File encryption/decryption β€” lock up your data with confidence
  • Diceware-style passphrase generator β€” passwords that sound like spells
  • .aesus config and secret storage β€” coming soon for local persistence
  • Cross-platform builds β€” Windows deserves privacy too, apparently
  • GUI web companion β€” for those who click before they type
  • Whispered Latin chants on success β€” a joke... unless?

πŸ“œ Disclaimer

AESus is not divine. It won’t protect you from forgetting your passphrase or encrypting the wrong file. It does one thing well: turning words into keys, and data into secrets.

Use responsibly. Backup often. Don’t test AES with your only copy of anything.


🩸 License

MIT. Free as in open source, and as in β€œopen to unusual use cases.”


πŸ•³οΈ Contact

Made by Andrew Garcia Bug reports welcome. Feedback encouraged. Incantations optional.