{"id":25695425,"url":"https://github.com/john0n1/zippy","last_synced_at":"2025-04-28T11:11:02.353Z","repository":{"id":274806993,"uuid":"924129481","full_name":"John0n1/ZIPPY","owner":"John0n1","description":"Archive file Repair/Recovery and Brute Force toolkit.","archived":false,"fork":false,"pushed_at":"2025-04-26T06:07:53.000Z","size":90,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-26T07:20:34.950Z","etag":null,"topics":["archive","archive-extractor","archives","gzip","recovery","repair-tool","tar","targz","tgz","zip","zip-extraction","zipfile"],"latest_commit_sha":null,"homepage":"https://github.com/John0n1/ZIPsnip","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/John0n1.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,"zenodo":null}},"created_at":"2025-01-29T13:22:08.000Z","updated_at":"2025-04-26T06:07:49.000Z","dependencies_parsed_at":"2025-04-26T07:18:51.178Z","dependency_job_id":"a066ea7f-ca5a-49a9-ada0-68753185fd5b","html_url":"https://github.com/John0n1/ZIPPY","commit_stats":null,"previous_names":["john0n1/zipsnip","john0n1/zipsnipp"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/John0n1%2FZIPPY","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/John0n1%2FZIPPY/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/John0n1%2FZIPPY/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/John0n1%2FZIPPY/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/John0n1","download_url":"https://codeload.github.com/John0n1/ZIPPY/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":251302783,"owners_count":21567601,"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":["archive","archive-extractor","archives","gzip","recovery","repair-tool","tar","targz","tgz","zip","zip-extraction","zipfile"],"created_at":"2025-02-25T00:43:31.770Z","updated_at":"2025-04-28T11:11:02.348Z","avatar_url":"https://github.com/John0n1.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# John0n1/ZIPPY\n\nZIPPY is a robust, production-ready command-line archive utility toolkit that provides extraction, archive creation, listing, integrity testing, password unlocking, and experimental archive repair functionalities. It supports multiple archive formats such as ZIP, TAR, TAR.GZ, and GZIP.\n\n## Features\n\n- Extract archives in various formats.\n- Create new archives and add multiple files/directories.\n- List contents of an archive.\n- Test archive integrity.\n- Unlock password-protected ZIP archives using a provided password or a dictionary attack.\n- Create password-protected (locked) ZIP archives.\n- Experimental archive repair with salvage extraction for corrupted archives.\n- Animated loading indicator with an option to disable it.\n- Save and load configuration settings via JSON files.\n- Command-line auto-completion using Python’s readline module.\n\n### Requirements\n\n- Python 3.12+\n- [python-dotenv](https://pypi.org/project/python-dotenv/)\n\n### Install dependencies using:\n\n```bash\npip install -r requirements.txt\n```\n## Installation\n\nClone the repository and navigate to the project directory:\n\n```bash\ngit clone https://github.com/John0n1/ZIPPY.git\ncd ZIPPY\n```\n\n## Usage\n\nZIPPY is operated through the command line. Below are some examples:\n\n### Extract an Archive\n```python\npython zippy.py extract myarchive.zip -o extracted_files\n```\n### Create a New Archive\n```python\npython zippy.py create new_archive.zip -f file1.txt,dir1,file2.jpg\n```\n### List Archive Contents\n```python\npython zippy.py list myarchive.tar.gz\n```\n### Test Archive Integrity\n```python\npython zippy.py test myarchive.zip\n```\n### Unlock a Password-Protected Archive\n```python\npython zippy.py unlock protected.zip -d passwords.txt\n```\n### Create a Password-Protected Archive\n```python\npython zippy.py lock secure_archive.zip -f documents,images -p SecurePass\n```\n### Repair a Corrupted Archive (Experimental)\n```python\npython zippy.py repair corrupted.zip --repair-mode remove_corrupted\n```\n### Show Help\n```python\npython zippy.py help\n```\n### Display Version\n```python\npython zippy.py version\n```\n## Configuration\n\nYou can save and load configuration settings using JSON files.\n\n### Save Configuration:\n```python\npython zippy.py \u003ccommand\u003e \u003carchive_file\u003e [options] --save-config your_config.json\n```\n### Load Configuration:\n```python\npython zippy.py \u003ccommand\u003e \u003carchive_file\u003e [options] --load-config your_config.json\n```\n\n# Supported Archive Formats\n\nZIP\n\nTAR\n\nTAR.GZ / TGZ\n\nGZIP (single file only)\n\n\n# Auto-Completion\n\nZIPPY sets up basic auto-completion for commands using Python’s readline module. This feature is automatically enabled when running the script.\n\n## License\n\nThis project is licensed under the MIT License. See the LICENSE file for details.\n\n## Contributing\n\nContributions are welcome! Please fork the repository and submit a pull request with any improvements or bug fixes.\n\n## Disclaimer\n\nZIPPY is provided \"as is\" without warranty of any kind. Use at your own risk. Always keep backups of important archives.\n\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjohn0n1%2Fzippy","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjohn0n1%2Fzippy","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjohn0n1%2Fzippy/lists"}