{"id":25395867,"url":"https://github.com/trinetra110/chronocrypt","last_synced_at":"2025-07-25T02:09:07.194Z","repository":{"id":277656506,"uuid":"933117145","full_name":"trinetra110/ChronoCrypt","owner":"trinetra110","description":"ChronoCrypt is a powerful CLI-based encryption tool that allows users to create time-locked secure notes that self-destruct after a specified duration. It uses AES-256 encryption (CBC mode) to securely store sensitive information, ensuring that notes are unreadable beyond their expiry time.","archived":false,"fork":false,"pushed_at":"2025-02-15T07:21:50.000Z","size":5,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-02-15T08:25:56.913Z","etag":null,"topics":["cryptography","cybersecurity-tools","secure-delete"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/trinetra110.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2025-02-15T07:19:46.000Z","updated_at":"2025-02-15T07:37:19.000Z","dependencies_parsed_at":"2025-02-15T08:36:20.633Z","dependency_job_id":null,"html_url":"https://github.com/trinetra110/ChronoCrypt","commit_stats":null,"previous_names":["trinetra110/chronocrypt"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/trinetra110%2FChronoCrypt","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/trinetra110%2FChronoCrypt/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/trinetra110%2FChronoCrypt/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/trinetra110%2FChronoCrypt/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/trinetra110","download_url":"https://codeload.github.com/trinetra110/ChronoCrypt/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248259617,"owners_count":21074163,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cryptography","cybersecurity-tools","secure-delete"],"created_at":"2025-02-15T20:38:44.975Z","updated_at":"2025-04-10T16:58:59.175Z","avatar_url":"https://github.com/trinetra110.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# **ChronoCrypt: Time-Locked Secure Notes with Self-Destruct** 🔐⏳\n\n\u003cimg src=\"https://readme-typing-svg.herokuapp.com?color=45ffaa\u0026size=40\u0026width=900\u0026height=80\u0026lines=Welcome-to-ChronoCrypt\"/\u003e\n\n**ChronoCrypt** is a powerful CLI-based encryption tool that allows users to create **time-locked secure notes** that self-destruct after a specified duration. It uses **AES-256 encryption (CBC mode)** to securely store sensitive information, ensuring that notes are unreadable beyond their expiry time.\n\n🔹 **AES-256 Encryption for Maximum Security**  \n🔹 **Self-Destructing Notes After Expiry**  \n🔹 **User-Friendly Command-Line Interface**  \n🔹 **Supports Expiry Times in Minutes, Hours, or Days**  \n\n## 🚀 Features  \n✅ **AES-256 Encryption**: Strong encryption using SHA-256 derived keys.  \n✅ **Time-Locked Access**: Notes can only be read before expiry.  \n✅ **Automatic Secure Deletion**: Notes are irreversibly deleted after expiry.  \n✅ **User-Friendly CLI**: Simple commands for encryption \u0026 decryption.  \n✅ **Supports Expiry Formats**: Set time in minutes (m), hours (h), or days (d).  \n\n## 🛠️ Tech Stack  \n| **Technology**  | **Description**              |\n|---------------|--------------------------|\n| **🐍 Python**  | Programming Language       |\n| **🔐 PyCryptodome**  | AES-256 Encryption Library   |\n| **📂 OS**      | File Handling \u0026 Secure Deletion    |\n\n## 📌 Prerequisites  \n\n- **Python 3.x** (Download: [Python.org](https://www.python.org/downloads/))  \n\n## ⚡ Installation \u0026 Usage  \n\n### **1️⃣ Clone the Repository**  \n```bash\ngit clone https://github.com/trinetra110/ChronoCrypt.git\ncd ChronoCrypt  \n```\n\n### **2️⃣ Install Dependencies**  \n```bash\npip install -r requirements.txt  \n```\n\n### **3️⃣ Encrypt a Secure Note**  \n```bash\npython main.py encrypt \"Your Secret Message\" \"YourPassword\" -t 30m -f my_secret.sec  \n```\n- **Your Secret Message** → The message to encrypt  \n- **YourPassword** → The password for encryption/decryption  \n- **-t 30m** → (Optional) The note will self-destruct in 30 minutes (supports `m`, `h`, `d`) (default: 1h).  \n- **-f my_secret.sec** → (Optional) Save the note to a custom file (binary like .sec) (default: sec_note.sec).  \n\n### **4️⃣ Decrypt \u0026 Read a Note (Before Expiry)**  \n```bash\npython main.py decrypt my_secret.sec \"YourPassword\"  \n```\n- If the note is **not expired**, the decrypted message will be displayed.  \n- If the note **is expired**, it will be securely deleted automatically.  \n\n## 🎯 How It Works  \n1️⃣ **Encryption**:  \n   - The message is encrypted using **AES-256 (CBC mode)**.  \n   - A time-lock mechanism ensures notes are valid only until expiry.  \n   - The encrypted note is saved in a `.sec` file.  \n\n2️⃣ **Decryption \u0026 Expiry Check**:  \n   - When attempting to decrypt, the expiry timestamp is checked.  \n   - If **not expired**, the message is decrypted and displayed.  \n   - If **expired**, the note is securely deleted to prevent access.  \n\n3️⃣ **Secure Deletion**:  \n   - The file is **overwritten with random bytes** before deletion.  \n   - This prevents forensic recovery of the note.  \n\n## 🏆 Why Use ChronoCrypt?  \n🔹 **Store Temporary Secrets**: Ideal for one-time secure message sharing.  \n🔹 **Automated Data Expiry**: No need to manually delete expired notes.  \n🔹 **Lightweight \u0026 Fast**: CLI-based tool, no additional setup required.  \n🔹 **Bulletproof Security**: AES-256 encryption with automatic secure deletion.  \n\n## 📜 License  \nThis project is licensed under the **MIT License**.  \n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftrinetra110%2Fchronocrypt","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftrinetra110%2Fchronocrypt","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftrinetra110%2Fchronocrypt/lists"}