{"id":49956416,"url":"https://github.com/olegfour3/arc2zen","last_synced_at":"2026-05-18T00:13:14.761Z","repository":{"id":336659956,"uuid":"1150625418","full_name":"olegfour3/arc2zen","owner":"olegfour3","description":"Migrate Arc Browser bookmarks to Zen Browser, or export to HTML","archived":false,"fork":false,"pushed_at":"2026-02-05T14:17:43.000Z","size":23,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-02-06T00:56:28.443Z","etag":null,"topics":["arcbrowser","export","import","migration","python","script","zenbrowser"],"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/olegfour3.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,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-02-05T13:57:35.000Z","updated_at":"2026-02-05T14:23:29.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/olegfour3/arc2zen","commit_stats":null,"previous_names":["olegfour3/arc2zen"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/olegfour3/arc2zen","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/olegfour3%2Farc2zen","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/olegfour3%2Farc2zen/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/olegfour3%2Farc2zen/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/olegfour3%2Farc2zen/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/olegfour3","download_url":"https://codeload.github.com/olegfour3/arc2zen/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/olegfour3%2Farc2zen/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33160177,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-17T22:39:12.733Z","status":"ssl_error","status_checked_at":"2026-05-17T22:39:10.741Z","response_time":107,"last_error":"SSL_read: 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":["arcbrowser","export","import","migration","python","script","zenbrowser"],"created_at":"2026-05-18T00:13:14.271Z","updated_at":"2026-05-18T00:13:14.748Z","avatar_url":"https://github.com/olegfour3.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Arc2Zen\n\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n\nA tool for exporting bookmarks from Arc Browser and Zen Browser to HTML format, and migrating bookmarks directly from Arc to Zen Browser.\n\n**[RU](README_RU.md)**\n\n## Features\n\n- **Export Arc bookmarks** to HTML (preserves order, compatible with all browsers)\n- **Export Zen bookmarks** to HTML (preserves order, compatible with all browsers)\n- **Direct migration** from Arc to Zen (preserves folder structure and tab order)\n- **Multi-profile support** for Arc and Zen\n- **macOS only**\n\n## Quick Start\n\n### With uv (recommended)\n\n```bash\ngit clone https://github.com/yourusername/arc2zen.git\ncd arc2zen\nuv run main.py\n```\n\n`uv` will automatically create a virtual environment and install dependencies.\n\n### With pip\n\n```bash\ngit clone https://github.com/yourusername/arc2zen.git\ncd arc2zen\npip install lz4\npython main.py\n```\n\n## Requirements\n\n- Python 3.10+\n- `lz4` package (for Zen Browser operations)\n\nWhen using `uv`, dependencies are installed automatically.\n\n## Usage\n\nRun the script and select an option from the menu:\n\n```\n============================================================\nArc Bookmarks Tool\n============================================================\n\nChoose an option:\n\n  1. Export Arc bookmarks to HTML file\n  2. Export Zen bookmarks to HTML file\n  3. Migrate Arc bookmarks to Zen Browser\n\n  0. Exit\n```\n\n### Option 1: Export Arc Bookmarks\n\nExports all pinned bookmarks from Arc Browser to a standard HTML file.\n\n- Auto-generated filename with date or custom name\n\n### Option 2: Export Zen Bookmarks\n\nExports all pinned tabs from Zen Browser to HTML format.\n\n- Preserves workspace structure as folders\n- Preserves folder hierarchy\n\n### Option 3: Migrate Arc to Zen\n\nDirectly imports Arc bookmarks into Zen Browser.\n\n**Important:**\n- Zen Browser must be **closed** before migration\n- The script automatically checks if Zen is running\n- Creates backups before making changes\n- Requires matching workspaces in Zen (will prompt to create missing ones)\n\n## File Locations\n\n### Arc Browser Data\n\n`~/Library/Application Support/Arc/StorableSidebar.json`\n\n### Zen Browser Data\n\n`~/Library/Application Support/zen/Profiles/`\n\n## Migrating Passwords (Manual)\n\nThis tool does not migrate passwords (different security systems). Follow these steps manually:\n\n### Export from macOS (Arc uses iCloud Keychain)\n1. Open **Passwords** app (macOS Sequoia+) or **Keychain Access**\n2. **Passwords app:** File → Export All Passwords → Save as CSV\n3. **Keychain Access:** File → Export Items\n\n### Import to Zen\n1. Open Zen Browser\n2. Go to `about:logins`\n3. Click **⋯** (menu) → **Import from a File...**\n4. Select the CSV file\n\n\u003e **Security:** Delete the CSV file after import — it contains plain text passwords.\n\n## Importing HTML to Browsers\n\n### Chrome / Chromium\n1. Go to `chrome://bookmarks/`\n2. Click ⋮ → \"Import bookmarks\"\n3. Select the HTML file\n\n### Firefox\n1. Press `Ctrl+Shift+B` (Bookmarks Manager)\n2. \"Import and Backup\" → \"Import Bookmarks from HTML\"\n\n### Safari\n1. File → \"Import From\" → \"Bookmarks HTML File\"\n\n### Edge\n1. Click ⋯ → \"Favorites\" → \"Manage favorites\"\n2. Click ⋯ → \"Import favorites\" → \"Bookmarks HTML file\"\n\n## Project Structure\n\n```\narc2zen/\n├── main.py              # Main entry point\n├── pyproject.toml       # Project config and dependencies\n├── core/\n│   ├── __init__.py\n│   ├── models.py        # Data classes\n│   ├── arc_exporter.py  # Arc Browser operations\n│   ├── zen_exporter.py  # Zen export to HTML\n│   └── zen_importer.py  # Arc to Zen migration\n├── README.md\n├── README_RU.md\n└── LICENSE\n```\n\n## Troubleshooting\n\n### \"File not found\" for Arc\n- Ensure Arc Browser is installed and has been run at least once\n\n### \"Zen Browser profile not found\"\n- Ensure Zen Browser is installed and has been run at least once\n\n### \"lz4 module required\"\n```bash\nuv run main.py   # installs automatically\n# or\npip install lz4\n```\n\n### Missing bookmarks after migration\n- Only **pinned** tabs are migrated\n- Unpinned tabs are not included\n\n## Contributing\n\nContributions are welcome! Please feel free to submit issues or pull requests.\n\n## Support\n\nIf you find this project helpful, please give it a ⭐ star!\n\n## License\n\nThis project is licensed under the [MIT License](LICENSE).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Folegfour3%2Farc2zen","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Folegfour3%2Farc2zen","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Folegfour3%2Farc2zen/lists"}