Skip to content

KyrilosKamal/PassCrypt

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

19 Commits
 
 
 
 
 
 
 
 

Repository files navigation

PassCrypt

PassCrypt is a lightweight file encryption and decryption tool built with Python. It uses AES encryption in CTR mode and derives the encryption key directly from a user-provided password using PBKDF2 and SHA256.
No external key files or salt storage — just your password.


Features

  • AES-CTR encryption for secure stream-based file handling
  • Key derivation via PBKDF2 with SHA256
  • No need to store or manage key files or salt
  • Simple CLI interface for encryption and decryption
  • Works with any file type (text, binary, media, etc.)
  • Linux-friendly: can be installed system-wide as a CLI tool

Installation

Option 1: Manual Setup (Linux)

  1. Clone the repository:
git clone https://github.com/KyrilosKamal/PassCrypt.git
cd PassCrypt

2. Make the script executable:

chmod +x setup.sh

3. Install using setup.sh:

./setup.sh

4. Run the tool:

passcrypt.py

Option 2: Global CLI Installation

Use the provided installer script to make PassCrypt available system-wide:

1. Run the setup script:

chmod +x setup.sh
./setup.sh

2. After installation, you can run PassCrypt from anywhere:

passcrypt

Usage

Once the script is running:

  • Choose 1 to encrypt or 2 to decrypt
  • Enter the full file path (e.g., /home/user/file.txt)
  • Enter your password

Important: The password is the only way to decrypt the file. If you forget it, the data cannot be recovered.

Notes

  • AES-CTR mode is symmetric: encryption and decryption use the same logic.
  • Salt is derived from the password hash to avoid external storage.
  • This tool modifies the file in-place. Make backups if needed.
  • Works on Linux, Windows, and macOS with Python 3 installed

Author

Kyrillos Kamal — IT Specialist Engineer, and Cybersecurity Trainee. Crafted with clarity, persistence, and branded elegance.

About

No keys. No files. Just your passphrase

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published