<div align="center"> <img src="img/banner-rounded.png" style="width: 700px; height: auto;" > <!-- https://github.com/user-attachments/assets/c9eeaf74-6649-4810-b420-e2c4ad4bd365 --> <br>

| :exclamation: | This project is part of the FadSec Lab suite. <br> Discover our focus on ad-free, privacy-first applications and stay updated on future releases! | | ------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

---

<img src="img/icon.png" style="width: 100px; height: auto;" >

>_ FadCrypt

Advanced and elegant cross-platform encryption tool – files, folders, and applications all protected with military-grade AES-256-GCM encryption. Open-source, completely free, no telemetry!

</div>

>_ 🎯 What is FadCrypt?

FadCrypt is a comprehensive dual-mode security solution that protects both your files and your applications:

🖥️ GUI Mode: Application Locking

Protect your installed applications (Firefox, Chrome, Brave, VS Code, etc.) with encrypted password locks. Once locked, the app cannot be launched without your master password. FadCrypt continuously monitors your system in the background and:

• Scans for running processes matching your protected applications (e.g., firefox.exe, chrome.exe, brave.exe)
• Terminates processes instantly if an app is launched without permission
• Auto-locks after inactivity: Once you unlock an app and provide the correct password, it stays unlocked for 10 seconds of inactivity, then automatically re-locks for security
• Logs all access attempts and lock/unlock events for your activity dashboard

💾 CLI Mode: File & Folder Encryption

Encrypt and lock sensitive files and folders using military-grade AES-256-GCM encryption. All data is encrypted before storage:

• Encryption Process: Master password → PBKDF2 key derivation (100,000 iterations) → AES-256-GCM encryption → .fadcrypt file
• Decryption Process: Provide password → Derive key from stored salt → Verify authentication tag → Decrypt data → Restore original file
• File Protection: Windows uses ACL (Access Control Lists), Linux uses chmod + immutability flags
• Perfect for protecting documents, photos, archives, source code, and other sensitive data

Key Highlights:

• Cross-Platform: Windows and Linux desktop platforms with unified CLI and separate optimized GUIs
• Military-Grade Encryption: AES-256-GCM with PBKDF2 key derivation (100,000 iterations)
• Fully Encrypted: Configuration, passwords, and recovery codes are all encrypted
• • No External Dependencies: Open-source and completely free with no cloud sync or telemetry

---

<details> <summary>Expand Table of Contents</summary> <br>

• FadCrypt
  • 🎯 What is FadCrypt?
    • 🖥️ GUI Mode: Application Locking
    • 💾 CLI Mode: File & Folder Encryption
  • 📱 Screenshots
    • 🖥️ GUI Mode - Application Locking
    • 💻 CLI/TUI Mode - File & Folder Encryption
  • How FadCrypt Works:
    • File & Folder Encryption (CLI Mode)
    • Application Locking (GUI Mode)
    • Core Encryption Technology (Both Modes)
    • Platform-Specific Implementation
    • Unified CLI Interface (Both Platforms)
    • Password & Recovery System (Both Platforms)
    • Monitoring Mode (Both Platforms)
    • Security Features (Both Platforms)
  • Password Creation & Setup
  • ⬇️ Installation & Setup
    • Windows
    • Linux
    • ℹ️ Linux-Specific Details
  • Features:
  • Command-Line Interface (CLI)
    • Usage Examples
    • CLI Features
    • Tamper-Proof Protection Control
  • Performance
  • Featured On
  • Join Community
  • Support
  • Contributions
    • How to Contribute
  • Install Dependencies & Build
    • 📦 Build Instructions (Windows & Linux)
  • Reset Password

</details>

---

>_ 📱 Screenshots

🖥️ GUI Mode - Application Locking

<table> <tr> <td align="center"><img src="img/demo/gui/hometab.png" width="300"><br><em><strong>Home Tab</strong> - Dashboard with overview</em></td> <td align="center"><img src="img/demo/gui/applicationstab.png" width="300"><br><em><strong>Applications Tab</strong> - Lock and manage apps/software</em></td> </tr> <tr> <td align="center"><img src="img/demo/gui/filesandfolderstab.png" width="300"><br><em><strong>Files & Folders Tab</strong> - View encrypted files</em></td> <td align="center"><img src="img/demo/gui/activitytab.png" width="300"><br><em><strong>Activity Tab</strong> - Track events and access</em></td> </tr> <tr> <td align="center"><img src="img/demo/gui/settingstab.png" width="300"><br><em><strong>Settings Tab</strong> - Recovery codes & preferences</em></td> <td align="center"><img src="img/demo/gui/windows_contextmenu.png" width="300"><br><em><strong>Context Menu</strong> - Right-click lock/unlock *(Windows)*</em></td> </tr> <tr> <td align="center"><img src="img/demo/gui/configtab.png" width="300"><br><em><strong>Config Tab</strong> - Application configuration</em></td> <td align="center"><img src="img/demo/gui/statswindow.png" width="300"><br><em><strong>Statistics Window</strong> - Activity & uptime</em></td> </tr> <tr> <td align="center"><img src="img/demo/gui/fadguidetab1.png" width="300"><br><em><strong>FadGuide Tab 1</strong> - Interactive tutorial</em></td> <td align="center"><img src="img/demo/gui/fadguidetab2.png" width="300"><br><em><strong>FadGuide Tab 2</strong> - More information</em></td> </tr> <tr> <td align="center"><img src="img/preview1.png" width="300"><br><em><strong>Password Dialog</strong> - Secure entry prompt</em></td> <td align="center"><img src="img/preview2.png" width="300"><br><em><strong>Password Fullscreen</strong> - With wallpaper</em></td> </tr> <tr> <td align="center"><img src="img/demo/gui/readme.png" width="300"><br><em><strong>README Info</strong> - Documentation display</em></td> <td align="center"><img src="img/demo/gui/passrecovery.png" width="300"><br><em><strong>Password Recovery</strong> - Recovery codes</em></td> </tr> <tr> <td align="center" colspan="2"><img src="img/legacy/snake.png" width="300"><br><em><strong>Snake Game</strong> - Entertainment feature on home tab</em></td> </tr> </table>

💻 CLI/TUI Mode - File & Folder Encryption

<table> <tr> <td align="center"><img src="img/demo/cli/fadcryptcli_mainmenu.png" width="300"><br><em><strong>Main Menu</strong> - Terminal UI with animations</em></td> <td align="center"><img src="img/demo/cli/lockscreen.png" width="300"><br><em><strong>Lock Screen</strong> - Select files to encrypt</em></td> </tr> <tr> <td align="center"><img src="img/demo/cli/passwordprompt.png" width="300"><br><em><strong>Password Prompt</strong> - Secure entry</em></td> <td align="center"><img src="img/demo/cli/lock-confirmation.png" width="300"><br><em><strong>Lock Confirmation</strong> - Review & confirm</em></td> </tr> <tr> <td align="center"><img src="img/demo/cli/locked-items-list.png" width="300"><br><em><strong>Locked Items List</strong> - View encrypted files</em></td> <td align="center"><img src="img/demo/cli/unlockscreen.png" width="300"><br><em><strong>Unlock Screen</strong> - Decrypt files</em></td> </tr> </table> <!-- <details> <summary><strong>More Screenshots</strong></summary> <img src="/img/3.png" style="width: 700px; height: auto;" > <br> <img src="/img/4.png" style="width: 700px; height: auto;" > <br> <img src="/img/5.png" style="width: 700px; height: auto;" > </details> -->

>_ How FadCrypt Works:

<details> <summary><strong>📚 Technical Deep Dive (Click to expand)</strong></summary> <br>

File & Folder Encryption (CLI Mode)

Encryption Process:

1. You provide a file/folder path and your master password via the CLI (fadcrypt --lock <path>)
2. FadCrypt derives a unique encryption key from your password using PBKDF2-SHA256 (100,000 iterations)
3. The file content is encrypted using AES-256-GCM (authenticated encryption)
4. The encrypted data is written to a new .fadcrypt file with metadata and authentication tag
5. Original file is securely overwritten and deleted
6. File protection rules are applied (Windows ACL or Linux chmod/chattr) to prevent unauthorized access

Decryption Process:

1. You run fadcrypt --unlock <path.fadcrypt> and provide your master password
2. FadCrypt derives the same encryption key from your password using the stored salt
3. The authentication tag is verified to ensure file integrity and authenticity
4. AES-256-GCM decrypts the file