Skip to content

V.1.0.0

Pre-release
Pre-release
Compare
Choose a tag to compare
@Royhtml Royhtml released this 14 May 08:24
· 10 commits to main since this release
e74110f

Release: Python File Protector v1.0.0

Tag Name: v1.0.0 (Follows Semantic Versioning)
Publisher: Royhtml
Release Date: 14/05/2025 15:30 Development


πŸ” Overview

Python File Protector is a robust security tool designed to safeguard sensitive files against unauthorized access, tampering, or deletion. Ideal for both personal and enterprise use, it combines military-grade encryption with intuitive access controls.

UI Screenshot
(Caption: User-friendly interface with encryption/decryption options.)


✨ Key Features

1. Military-Grade Encryption

  • Algorithm: AES-256 (FIPS 197 certified)
  • Modes: CBC (Cipher Block Chaining) with PKCS7 padding
  • Key Derivation: PBKDF2-HMAC-SHA512 (100,000 iterations)
  • File Types: Supports all formats (.txt, .pdf, .docx, images, etc.)

2. Access Control

  • Permission Management:
    • Read-only mode
    • Write protection (prevent modifications)
    • Execute restrictions (for scripts)
  • User Whitelisting: Authorize specific users/system processes.

3. Cross-Platform Compatibility

  • OS Support:
    • Windows 10/11 (x64)
    • Linux (Debian/Ubuntu, RHEL)
    • macOS (12.0+)
  • CLI & GUI: Choose between command-line or graphical interface.

4. Integrity Verification

  • Checksums: SHA-256 hashes for all encrypted files.
  • Tamper Detection: Alerts if files are modified post-encryption.

πŸ“₯ Installation

Option 1: PIP (Python Package Index)

pip install python-file-protector --upgrade

Prerequisites:

  • Python 3.8+
  • pip v22.0+

Option 2: Standalone Executables

  • Windows: Download .EXE | SHA-256: [INSERT_CHECKSUM]
    Get-FileHash PythonFileProtector_v1.0.0.exe
  • Linux (Debian):
    sudo dpkg -i PythonFileProtector_v1.0.0.deb

βš™οΈ System Requirements

Component Minimum Spec Recommended
OS Windows 10/x64 Windows 11
RAM 2 GB 4 GB
Storage 50 MB free 200 MB SSD
Python 3.8+ 3.10+

πŸ›  Usage Examples

Encrypt a File

from file_protector import encrypt_file  
encrypt_file("secret.docx", password="YourStrongPassword", output="secret.enc")  

Decrypt a File

python -m file_protector --decrypt --input secret.enc --output secret.docx  

πŸ“œ License & Legal

  • License: Proprietary (Β© 2025 Python File Protector Team)
  • Warranty: No liability for data loss. Use at your own risk.
  • Compliance: GDPR-ready (EU), supports data sovereignty policies.

πŸ› Known Issues

  • Issue #42: Large files (>4GB) may slow encryption on HDDs.
  • Workaround: Use SSD storage or split files.

πŸ”— Links


GitHub Release Workflow

  1. Create Tag:
    git tag -a v1.0.0 -m "Stable release with AES-256 and GUI"
    git push origin v1.0.0
  2. Upload Assets: Attach .exe, .deb, and checksums manually via GitHub UI.
  3. Publish: Mark as "Latest Release" if stable.

Note to Maintainers:

  • Always sign releases with GPG (-s flag in git tag).
  • Update checksums in the release notes post-upload.