{"id":26075982,"url":"https://github.com/opengiver/bridge-zip","last_synced_at":"2025-07-26T20:13:41.990Z","repository":{"id":279420690,"uuid":"938748782","full_name":"opengiver/bridge-zip","owner":"opengiver","description":"A Node.js CLI tool that seamlessly connects zip files between Windows and macOS, enabling cross-platform compatibility and efficient file handling.","archived":false,"fork":false,"pushed_at":"2025-03-09T15:02:48.000Z","size":48,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-25T17:46:27.541Z","etag":null,"topics":["cli","macos","window","zip"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","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/opengiver.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-25T12:48:51.000Z","updated_at":"2025-03-09T15:02:51.000Z","dependencies_parsed_at":"2025-02-25T13:57:14.901Z","dependency_job_id":null,"html_url":"https://github.com/opengiver/bridge-zip","commit_stats":null,"previous_names":["opengiver/bridge-zip"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/opengiver%2Fbridge-zip","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/opengiver%2Fbridge-zip/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/opengiver%2Fbridge-zip/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/opengiver%2Fbridge-zip/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/opengiver","download_url":"https://codeload.github.com/opengiver/bridge-zip/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248483032,"owners_count":21111419,"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":["cli","macos","window","zip"],"created_at":"2025-03-09T01:41:33.052Z","updated_at":"2025-04-11T21:33:04.148Z","avatar_url":"https://github.com/opengiver.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Bridge-Zip\n\n![npm](https://img.shields.io/npm/v/bridge-zip)\n![npm](https://img.shields.io/npm/dt/bridge-zip)\n![npm bundle size](https://img.shields.io/bundlephobia/min/bridge-zip)\n![license](https://img.shields.io/npm/l/bridge-zip)\n\n`Bridge-Zip` is a command-line utility designed to solve compatibility issues between ZIP files created on Windows and macOS systems. It provides seamless conversion of folder names and structures to ensure proper functionality across both operating systems.\n\n\u003cbr\u003e\n\n\u003cimg src=\"https://github.com/user-attachments/assets/1438ad6b-49de-40f7-ba30-e01fc52b2f57\" width=\"640\"\u003e\n\n\u003cbr\u003e\n\n## The Problem\n\nWhen creating ZIP archives on different operating systems, folder structures and encoding issues can arise:\n\n- ZIP files created on Windows may have folder names encoded in a way that's unreadable on macOS\n- ZIP files created on macOS might have folder names that appear incorrectly on Windows\n- Extracting cross-platform ZIP files often results in garbled or unreadable folder names\n\nBridge-Zip solves these issues by providing an easy way to check and convert folder names within ZIP archives.\n\n## Installation\n\n```bash\n# Install globally\nnpm install -g bridge-zip\n\n# Or use with npx\nnpx bridge-zip \u003ccommand\u003e\n```\n\n## Usage\n\nBridge-Zip offers two main commands:\n\n### Check ZIP Contents\n\nExamine the folder names inside a ZIP file:\n\n```bash\nbridge-zip check example.zip\n```\n\nThis will display all folder and file names contained within the archive.\n\n### Convert ZIP File\n\nExtract a ZIP file, rename its main folder, and recompress it:\n\n```bash\nbridge-zip convert example.zip newFolderName\n```\n\nThis command:\n\n1. Extracts the ZIP file\n2. Renames the main folder to the specified name\n3. Recompresses the folder into a new ZIP file\n\n## Examples\n\n**Checking a Windows-created ZIP file on macOS:**\n\n```bash\nbridge-zip check windows_archive.zip\n# Output: Folder names inside the zip: [\"Project_Files/\", \"Project_Files/document.docx\", ...]\n\n```\n\n**Converting a ZIP file for cross-platform compatibility:**\n\n```bash\nbridge-zip convert macos_archive.zip ProjectFiles\n# Output: Conversion complete: /path/to/macos_archive.zip\n```\n\n## Technical Details\n\nBridge-Zip uses:\n\n- `Node.js` for cross-platform compatibility\n- `adm-zip` for ZIP file manipulation\n- `Commander.js` for the command-line interface\n\n## License\n\nMIT\n\n## Author\n\nByungsker\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fopengiver%2Fbridge-zip","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fopengiver%2Fbridge-zip","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fopengiver%2Fbridge-zip/lists"}