{"id":23406969,"url":"https://github.com/arpan404/ziply","last_synced_at":"2026-02-03T10:32:18.036Z","repository":{"id":268634790,"uuid":"894748496","full_name":"arpan404/ziply","owner":"arpan404","description":"Ziply is a tool that converts files into video format, supporting various resolutions and offering encryption for secure conversion, ensuring easy restoration and data protection.","archived":false,"fork":false,"pushed_at":"2024-12-18T02:14:13.000Z","size":59146,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-09T00:07:19.035Z","etag":null,"topics":["cpp","encryption-decryption","open-source","opencv","video-processing"],"latest_commit_sha":null,"homepage":"","language":"C++","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/arpan404.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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":"2024-11-26T23:13:06.000Z","updated_at":"2025-01-21T05:52:17.000Z","dependencies_parsed_at":null,"dependency_job_id":"ed8b5b0c-f841-48c0-b0d3-87881ec98f71","html_url":"https://github.com/arpan404/ziply","commit_stats":null,"previous_names":["arpan404/ziply"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/arpan404/ziply","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/arpan404%2Fziply","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/arpan404%2Fziply/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/arpan404%2Fziply/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/arpan404%2Fziply/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/arpan404","download_url":"https://codeload.github.com/arpan404/ziply/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/arpan404%2Fziply/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29041347,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-03T10:09:22.136Z","status":"ssl_error","status_checked_at":"2026-02-03T10:09:16.814Z","response_time":96,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":["cpp","encryption-decryption","open-source","opencv","video-processing"],"created_at":"2024-12-22T14:16:30.481Z","updated_at":"2026-02-03T10:32:18.021Z","avatar_url":"https://github.com/arpan404.png","language":"C++","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Ziply\n\nZiply is a powerful tool designed to convert any file into a video format, allowing for easy restoration later. It supports various resolutions, ensuring that your output meets your desired quality. Additionally, Ziply offers encryption options to secure your files during the conversion process, providing peace of mind for sensitive data.\n\n---\n\n## ⚙️ Installation and Compilation\n\n### Prerequisites\n\n- CMake\n- C++ Compiler (g++, Visual Studio, or MinGW)\n- ffmpeg\n- **Additional Libraries**:\n  - OpenCV (4.5.0 or later)\n  - OpenSSL (1.1.1 or later)\n  - LibLZMA (5.2.0 or later)\n\n### Library Installation\n\n#### Linux (Ubuntu/Debian)\n\n```bash\nsudo apt-get update\nsudo apt-get install -y \\\n    cmake g++ \\\n    libopencv-dev \\\n    libssl-dev \\\n    liblzma-dev\n```\n\n#### macOS (via Homebrew)\n\n```bash\nbrew install \\\n    cmake \\\n    opencv \\\n    openssl \\\n    xz\n```\n\n#### Windows\n\n1. **Manual Library Installation**:\n\n   - Download and install [OpenCV](https://opencv.org/releases/)\n   - Download [OpenSSL](https://slproweb.com/products/Win32OpenSSL.html)\n   - Download [LibLZMA](https://tukaani.org/xz/)\n\n   **Recommended**: Use vcpkg for easier dependency management\n\n   ```bash\n   vcpkg install opencv\n   vcpkg install openssl\n   vcpkg install liblzma\n   ```\n\n### Compilation Steps\n\n#### Linux (Ubuntu)\n\n1. **Clone the Repository**:\n\n```bash\ngit clone https://github.com/your-username/ziply.git\ncd ziply\n```\n\n2. **Create a Build Directory**:\n\n```bash\nmkdir build\ncd build\n```\n\n3. **Run CMake**:\n\n```bash\ncmake -DCMAKE_PREFIX_PATH=\"/usr/local/lib;/usr/lib\" ..\n```\n\n4. **Compile the Code**:\n\n```bash\nmake\n```\n\n5. **Run the Application**:\n\n```bash\n./ziply\n```\n\n#### macOS (via Homebrew)\n\n1. **Clone the Repository**:\n\n```bash\ngit clone https://github.com/your-username/ziply.git\ncd ziply\n```\n\n2. **Create a Build Directory**:\n\n```bash\nmkdir build\ncd build\n```\n\n3. **Run CMake**:\n\n```bash\ncmake -DCMAKE_PREFIX_PATH=\"/usr/local/opt/opencv;/usr/local/opt/openssl;/usr/local/opt/xz\" ..\n```\n\n4. **Compile the Code**:\n\n```bash\nmake\n```\n\n5. **Run the Application**:\n\n```bash\n./ziply\n```\n\n#### Windows\n\n1. **Clone the Repository**:\n\n```bash\ngit clone https://github.com/your-username/ziply.git\ncd ziply\n```\n\n2. **Create a Build Directory**:\n\n```bash\nmkdir build\ncd build\n```\n\n3. **Run CMake**:\n   - For Visual Studio (with vcpkg):\n     ```bash\n     cmake -DCMAKE_TOOLCHAIN_FILE=[vcpkg-root]/scripts/buildsystems/vcpkg.cmake ..\n     ```\n   - For MinGW:\n     ```bash\n     cmake -G \"MinGW Makefiles\" ..\n     ```\n4. **Compile the Code**:\n   - For Visual Studio: Open the generated `.sln` file and build the solution\n   - For MinGW:\n     ```bash\n     mingw32-make\n     ```\n5. **Run the Application**:\n\n```bash\nziply.exe\n```\n\n### Optional: System-wide Installation\n\n#### Linux/macOS\n\n```bash\nsudo mv ziply /usr/local/bin/\n```\n\n#### Windows\n\nAdd the directory containing `ziply.exe` to the system PATH environment variable.\n\n## Additional Notes\n\n- Ensure you have the latest versions of CMake and required libraries\n- Check system compatibility before installation\n- Verify library dependencies are correctly linked\n- Report any compilation or dependency issues on the project's GitHub repository\n\n## Troubleshooting\n\n- If CMake cannot find libraries, manually specify library paths using:\n  ```bash\n  cmake -DCMAKE_PREFIX_PATH=\"/path/to/libraries\" ..\n  ```\n- Ensure all prerequisite libraries are installed with development headers\n\n---\n\n## 🚀 Usage\n\nThe general syntax for the tool is as follows:\n\n```bash\nziply \u003ccommand\u003e [options]\n```\n\n---\n\n## 📝 Commands\n\nZiply supports the following commands:\n\n### 1. **`create`**\n\nCreate a Ziply video file from an input file.\n\n#### Syntax:\n\n```bash\nziply create -f \u003cinput_file\u003e [-o \u003coutput_file\u003e] [-r \u003cresolution\u003e] [-p \u003cpassword\u003e]\n```\n\n#### Options:\n\n- `-f \u003cinput_file\u003e` : Path or name of the input file to convert (mandatory).\n- `-o \u003coutput_file\u003e` : Path or name of the output file. The extension is ignored if provided (optional).\n- `-r \u003cresolution\u003e` : Output video resolution.\n  **Options**: `360p`, `480p`, `720p`, `1080p` (default), `1440p`, `4k`.\n- `-p \u003cpassword\u003e` : Set a password for encryption or protection (optional).\n\n#### Example:\n\n```bash\nziply create -f input.mp4 -o output_video -r 1080p -p MySecretKey\n```\n\n### 2. **`restore`**\n\nRestore data from a Ziply video file.\n\n#### Syntax:\n\n```bash\nziply restore -f \u003cinput_file\u003e [-o \u003coutput_file\u003e] [-p \u003cpassword\u003e]\n```\n\n#### Options:\n\n- `-f \u003cinput_file\u003e` : Path or name of the input Ziply file (mandatory).\n- `-o \u003coutput_file\u003e` : Path or name of the restored output file (optional).\n- `-p \u003cpassword\u003e` : Password for restoring the file, if encryption was used (optional).\n\n#### Example:\n\n```bash\nziply restore -f output_video.ziply -o restored_file -p MySecretKey\n```\n\n### 3. **`--help`**\n\nDisplay help text with all available commands and options.\n\n#### Syntax:\n\n```bash\nziply --help\n```\n\n#### Example:\n\n```bash\nziply --help\n```\n\n---\n\n## ❗ Error Handling\n\nZiply provides detailed error messages to help troubleshoot issues. Examples include:\n\n- Missing mandatory arguments\n- Invalid commands or options\n- Unsupported resolutions\n\nFor example:\n\n```bash\nziply create\n# Error: \"Invalid argument set to create a zipled file...\"\n```\n\nTo resolve such errors, refer to the help text using `ziply --help`.\n\n---\n\n## 🌟 Examples of Usage\n\n1. **Create a video with default resolution:**\n\n```bash\nziply create -f input.ext\n```\n\n2. **Create a video with 720p resolution and a password:**\n\n```bash\nziply create -f input.ext -o my_video -r 720p -p Secret123\n```\n\n3. **Restore a file with a password:**\n\n```bash\nziply restore -f my_video.mp4 -o restored_file -p Secret123\n```\n\n4. **View the help text:**\n\n```bash\nziply --help\n```\n\n---\n\n## 🛠️ Support\n\nIf you encounter any issues, feel free to open a support ticket or\nconsult the `--help` documentation for more guidance.\n\n---\n\n## 📄 License\n\nThis project is licensed under the MIT License.\n\n### License Summary\n\nThe MIT License is a permissive free software license that allows you to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of this software, as long as you include the original copyright and permission notice in all copies or substantial portions of the software.\n\n### MIT License\n\n**Copyright (c) 2024 Arpan Bhandari**\n\nPermission is hereby granted, free of charge, to any person obtaining a copy of this software and its associated documentation (the \"Software\"), to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit others to whom the Software is provided to do so, subject to the following conditions:\n\n- The above copyright notice and this permission notice must be included in all copies or substantial portions of the Software.\n\n**Disclaimer:**\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, AND NON-INFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES, OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT, OR OTHERWISE, ARISING FROM, OUT OF, OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.\n\n## 🤝 Contributing to Ziply\n\nWe welcome contributions from the community! Here's how you can help:\n\n### Ways to Contribute\n\n1. **Reporting Bugs**\n\n   - Use GitHub Issues to report any bugs you find\n   - Include detailed information about your environment\n   - Provide steps to reproduce the issue\n\n2. **Suggesting Enhancements**\n\n   - Open an issue to discuss new features\n   - Provide clear use cases and potential implementation approaches\n\n3. **Code Contributions**\n   - Fork the repository\n   - Create a new branch for your feature or bugfix\n   - Ensure your code follows the project's coding standards\n   - Write tests for new functionality\n   - Submit a pull request with a clear description of changes\n\n### Contribution Guidelines\n\n- Follow existing code style and formatting\n- Write clear, concise commit messages\n- Update documentation when making changes\n- Ensure to test the program ans format it according to '.clang-format' before submitting a pull request\n- Be respectful and constructive in all communications\n\n### Development Setup\n\n1. Clone the repository\n2. Install all dependencies\n3. Compile and test the setup before commiting changes\n\n```bash\ncmake . \u0026\u0026 make\n```\n\n### Code of Conduct\n\n- Be inclusive and respectful\n- Constructive feedback is encouraged\n- No harassment or discriminatory language will be tolerated\n\n### Reporting Security Issues\n\nFor security vulnerabilities, please contact [@arpan404](https://github.com/arpan404) instead of creating a public issue.\n\n---\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Farpan404%2Fziply","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Farpan404%2Fziply","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Farpan404%2Fziply/lists"}