{"id":27156712,"url":"https://github.com/0xzorro/zfileprotect","last_synced_at":"2025-04-10T02:19:12.213Z","repository":{"id":286690192,"uuid":"962230228","full_name":"0xZorro/zfileprotect","owner":"0xZorro","description":"zfileprotect is a Python tool for protecting Word, PDF, and Excel files with a password. It supports both manual and automatic password generation, and can process individual files or entire directories.","archived":false,"fork":false,"pushed_at":"2025-04-09T19:59:34.000Z","size":18,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-10T02:19:05.689Z","etag":null,"topics":["cybersecurity","opensource","password-protection","python"],"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/0xZorro.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-04-07T21:04:09.000Z","updated_at":"2025-04-09T19:59:37.000Z","dependencies_parsed_at":"2025-04-07T22:33:00.315Z","dependency_job_id":null,"html_url":"https://github.com/0xZorro/zfileprotect","commit_stats":null,"previous_names":["0xzorro/zfileprotect"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/0xZorro%2Fzfileprotect","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/0xZorro%2Fzfileprotect/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/0xZorro%2Fzfileprotect/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/0xZorro%2Fzfileprotect/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/0xZorro","download_url":"https://codeload.github.com/0xZorro/zfileprotect/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248142906,"owners_count":21054672,"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":["cybersecurity","opensource","password-protection","python"],"created_at":"2025-04-08T20:32:45.870Z","updated_at":"2025-04-10T02:19:12.203Z","avatar_url":"https://github.com/0xZorro.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# zfileprotect\n\n**zfileprotect** is a Python tool designed to protect Word, PDF, and Excel files with a password. It supports both manual password input and automatic password generation. This tool also allows you to process multiple files and entire directories in one go.\n\n## Features\n\n- Protect Word (`.docx`), PDF (`.pdf`), and Excel (`.xlsx`) files with a password.\n- Automatically generate a strong password with the `-p` flag.\n- Support for multiple files and directories.\n- Simple command-line interface using `argparse`.\n\n## Motivation\n\nThis project was created as a learning exercise in **cybersecurity**. Inspired by a **cybersecurity textbook**, the goal was to practice building practical tools that enhance data security, specifically focusing on **file encryption** and **password protection**.\n\n## Requirements\n\n- Python 3.x\n- `pywin32` (for Word and Excel protection)\n- `PyPDF2` (for PDF protection)\n\n### Installation\n\nTo install the required libraries, you can use `pip`:\n\n```bash\npip install pywin32 PyPDF2\n```\n\n## Usage\n\n### Protect a file with a manually provided password:\n\n```bash\npython zfileprotect.py \"Test.pdf\" --pwd=yourpassword\n```\n\n### Protect multiple files with a manually provided password:\n\n```bash\npython zfileprotect.py \"file1.pdf\" \"file2.docx\" \"file3.xlsx\" --pwd=yourpassword\n```\n\n### Automatically generate a password and protect files:\n\n```bash\npython zfileprotect.py \"Test.pdf\" -p\n```\n\n### Process all files in a directory:\n\n```bash\npython zfileprotect.py \"C:\\path\\to\\directory\" -p\n```\n\nThe tool will automatically process all supported files in the directory and protect them with a generated password.\n\n## License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n## Disclaimer\n\n**zfileprotect** is a tool for educational and personal use only. By using this tool, you agree not to use it for any illegal activities. You should only protect files you own or have explicit permission to protect. **The author is not responsible for any misuse or damage caused by this tool.**\n\n---\n\n## Contributing\n\nFeel free to contribute to this project by forking it, making changes, and creating a pull request. \n\nPlease ensure that any contributions follow the code of conduct and project standards.\n\n---\n\n## Author\n\n**0xZorro**  \nCybersecurity Learner | Python \u0026 C++ Tools  \nTryHackMe: [https://tryhackme.com/p/0xZorro](https://tryhackme.com/p/0xZorro)  \nContact: zorro.jose@gmx.de\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F0xzorro%2Fzfileprotect","html_url":"https://awesome.ecosyste.ms/projects/github.com%2F0xzorro%2Fzfileprotect","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F0xzorro%2Fzfileprotect/lists"}