{"id":13495236,"url":"https://github.com/srevinsaju/zap","last_synced_at":"2025-04-05T06:10:03.225Z","repository":{"id":41327906,"uuid":"286548415","full_name":"srevinsaju/zap","owner":"srevinsaju","description":":zap: Delightful AppImage package manager","archived":false,"fork":false,"pushed_at":"2023-08-20T17:47:43.000Z","size":19260,"stargazers_count":484,"open_issues_count":49,"forks_count":20,"subscribers_count":10,"default_branch":"main","last_synced_at":"2024-04-13T21:18:23.497Z","etag":null,"topics":["appimage","cli","desktop","go","golang","hacktoberfest","hacktoberfest2022","installer","package-manager","zap"],"latest_commit_sha":null,"homepage":"https://zap.srev.in","language":"Go","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/srevinsaju.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}},"created_at":"2020-08-10T18:18:02.000Z","updated_at":"2024-04-14T22:32:06.019Z","dependencies_parsed_at":"2024-04-14T22:31:40.360Z","dependency_job_id":"51db72cb-a695-4a86-b8e3-720721baf7ea","html_url":"https://github.com/srevinsaju/zap","commit_stats":{"total_commits":185,"total_committers":7,"mean_commits":"26.428571428571427","dds":"0.11351351351351346","last_synced_commit":"ef44059447ebcbe83019136269b325ff9d79d4ab"},"previous_names":[],"tags_count":7,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/srevinsaju%2Fzap","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/srevinsaju%2Fzap/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/srevinsaju%2Fzap/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/srevinsaju%2Fzap/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/srevinsaju","download_url":"https://codeload.github.com/srevinsaju/zap/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247294541,"owners_count":20915340,"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":["appimage","cli","desktop","go","golang","hacktoberfest","hacktoberfest2022","installer","package-manager","zap"],"created_at":"2024-07-31T19:01:32.796Z","updated_at":"2025-04-05T06:10:03.161Z","avatar_url":"https://github.com/srevinsaju.png","language":"Go","funding_links":[],"categories":["AppImage consumption tools","Go","cli","golang"],"sub_categories":["Package managers"],"readme":"\u003cp align=\"center\"\u003e\n    \u003cimg src=\"https://github.com/srevinsaju/zap/raw/main/assets/logo.svg\" alt=\"zap Zap\" width=128 height=128\u003e\n\n\u003ch2 align=\"center\"\u003e⚡️ Zap\u003c/h2\u003e\n\n  \u003cp align=\"center\"\u003e\n    The delightful package manager for AppImages\n    \u003cbr\u003e\n    \u003ca href=\"https://github.com/srevinsaju/zap/issues/new\"\u003eReport bug\u003c/a\u003e\n    ·\n    \u003ca href=\"https://github.com/srevinsaju/zap/issues/new\"\u003eRequest feature\u003c/a\u003e\n  \u003c/p\u003e\n\u003c/p\u003e\n\n\u003cdiv align=\"center\"\u003e\n\n[![forthebadge made-with-go](http://ForTheBadge.com/images/badges/made-with-go.svg)](https://golang.org/)\u003cbr/\u003e\u003cbr/\u003e\n\n[![Mentioned in Awesome AppImage](https://awesome.re/mentioned-badge-flat.svg)](https://github.com/AppImage/awesome-appimage)\n\n[![GitHub followers](https://img.shields.io/github/followers/srevinsaju?label=Follow%20me\u0026style=social)](https://github.com/srevinsaju) [![GitHub stars](https://img.shields.io/github/stars/srevinsaju/zap?style=social)](https://github.com/srevinsaju/zap/stargazers)\n\n\u003cimg src=\"assets/zap-firefox-install.gif\" alt=\"Zap Installing Firefox\"\u003e\u003c/img\u003e\n\u003c/div\u003e\n\n\u003e Looking for the older Zap v1 (Python) implementation? Head over to [v1 branch](https://github.com/srevinsaju/zap/tree/v1).\n\n## Getting Started ✨\n\n### Automated Installation\nFor installing zap you can use our little [bash script](https://github.com/srevinsaju/zap/blob/main/install.sh).\n\nThe installer requires `curl`, `grep` `jq` and `wget` (optional). Please make sure you have it installed.\n\nFor system-wide installation (needs `sudo`)\n```bash\ncurl https://raw.githubusercontent.com/srevinsaju/zap/main/install.sh | sudo bash -s\n```\n\n**Note:** Always Check bash scripts before running as sudo. You can feel free to check out install.sh, it's safe.\n\nFor local installation run\n```bash\ncurl https://raw.githubusercontent.com/srevinsaju/zap/main/install.sh | bash -s\n```\n\n### Manual Installation\n\nFor system-wide installation (needs `sudo`)\n```bash\nsudo wget https://github.com/srevinsaju/zap/releases/download/continuous/zap-amd64 -O /usr/local/bin/zap\nsudo chmod +x /usr/local/bin/zap\nzap --help\n```\n\nFor local installation, (requires `~/.local/bin` to be on `$PATH`)\n```bash\nmkdir -p ~/.local/bin\nwget https://github.com/srevinsaju/zap/releases/download/continuous/zap-amd64 -O ~/.local/bin/zap\nchmod +x ~/.local/bin/zap\nzap --help\n```\n\n\u003e NOTE: Replace `amd64` with your machine architecture. Supported architectures are listed in the [release](https://github.com/srevinsaju/zap/releases/tag/v2-continuous) page \n\n#### Installing AppImages\nAll AppImages from the [AppImage Catalog](https://appimage.github.io) and [AppImage catalog v2](https://g.srev.in/get-appimage) can be installed using zap with their registered name.\n\n```bash\nzap install element\n```\nwill ask you the version of element you would like to install + download them and do all the hard work of integrating into your system, \ni.e creating desktop files, etc.\n\nYou can also install appimages from GitHub releases\n\n```bash\nzap install --github --from vscodium/vscodium\n```\n\nwill put some options which will let you choose the best version for your system.\n\nIt is also possible to install AppImage from URLs\n\n```bash\nzap install --from https://f.sed.lol/wow.AppImage wow\n```\n\nTo integrate a locally downloaded AppImage,\n```bash\nzap install libresprite ~/Downloads/Libresprite-x86_64.AppImage\n```\n\n... or using the `file://` protocol\n```bash\nzap install --from file:///home/username/Downloads/My_Super_Cool-x86_64.AppImage name_of_the_app_here\n```\nhere, `name_of_the_app_here` specifies the name of the application. This name will be used \nas a unique identification of the AppImage, by zap, in its internal database.\n\n \n#### Updating AppImages 🔄\nAppImages can be optionally, [automatically updated using the `zapd`](#Daemon), but to achieve this manually, you need to \n```bash\nzap update firefox\n```\nThis will make use of the update information embedded within the appimage, which if exists, will be used to 'delta-update' the latest\nversion, by downloading \"only\" the parts which have changed.\n\nFor those AppImages not supporting delta updates, you can still do \n```bash\nzap install zoom\n```\nto install the latest version of Zoom.\n\n\n##### Upgrade 🚀\n`zap` also supports updating all the apps together using `appimage-update`. \n\n```bash\nzap upgrade\n```\n\n\n#### Configuration ⚙️\nIt is possible to interactively configure `zap`. All you need to do is \n```bash\nzap init\n```\nAnd answer all the questions that would follow.\n\n\n#### Daemon 🏃\n\n`zapd` is a Zap AppImage daemon which periodically checks for updates.\n\n```bash\nzap daemon --install\n```\n\nThis will install a `systemd` service in the local (user) level, which will spawn `zap daemon` which auto-updates \nthe AppImages. \n\nTo run the daemon (sync), do \n```bash\nzap daemon\n```\n\u003cbr\u003e\n\n## Support 💸\n\nAll Pull Requests are welcome.\n\nIf you are a non-coder or was inspired by this small project, I would be glad if you would :star2: this repository, and spread the word with your friends and foes :smile:\n\n## Credits 🙏\n\nThis project has been possible with the help and support provided by the AppImage community. Thanks to the detailed responses I received from mentors at AppImage's freenode channel.\n\n## License ⚖️\n\n```\nMIT License\n\nCopyright (c) 2020-23 Srevin Saju, and other zap contributors\n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files (the \"Software\"), to deal\nin the Software without restriction, including without limitation the rights\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\ncopies of the Software, and to permit persons to whom the Software is\nfurnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all\ncopies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\nSOFTWARE.\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsrevinsaju%2Fzap","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsrevinsaju%2Fzap","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsrevinsaju%2Fzap/lists"}