The status of development is still in Beta. Please help me fix bugs by opening an issue.
- A Unix-like operating system: macOS, Linux, BSD. On Windows:
WSL2is preferred, butcygwinormsysalso mostly work. curlorwgetshould be installed
Zap Package Manager can be installed by running one of the following commands, with curl or wget or you can manually do the hardwork of download Zap AppImage and integrating with your system.
sh -c "$(curl -fsSL https://git.io/zapinit)"sh -c "$(wget -O- https://git.io/zapinit)"Just copy paste these into the terminal, and you are all ready.
It's a good idea to inspect the install script from projects you don't yet know. You can do that by downloading the install script first, looking through it so everything looks normal, then running it:
curl -Lo install_zap.sh https://raw.githubusercontent.com/srevinsaju/zap/master/tools/install.sh
# check the script file for any ambiguity
# for example: cat install_zap.sh ?
sh install_zap.shZap package manager is extremely easy to use. You can certainly be a pro at using zap if you already know how to use apt or dnf. Cool!
To check if zap got installed correctly, just type zap on the command line!
❯ zap
Usage: zap [OPTIONS] COMMAND [ARGS]...
🗲 Zap: A command line interface to install appimages
Options:
--version
--license, --lic
--help Show this message and exit.
Commands:
appdata Shows the config of an app
check-for-updates Updates an appimage using appimageupdate tool
config Shows the config or allows to configure the...
disintegrate Remove zap and optionally remove all the appimages...
get-md5 Get md5 of an appimage
install Installs an appimage
install-gh Installs an appimage from GitHub repository URL...
integrate Checks if appimage is integrated with the desktop
is-integrated Checks if appimage is integrated with the desktop
remove Removes an appimage
self-integrate Add the currently running appimage to PATH, making it...
self-update Update myself
show Get the url to the app and open it in your web browser...
update Updates an appimage using appimageupdate tool
x Execute a Zap installed app (optionally with
sandboxing...
xdg Parse xdg url
Wow, looks cool right?
Lets try one of the most interesting, AppImage, Subsurface, for which there is a lot of historical significance, in the beginning of the AppImage concept
zap install subsurfaceAnd you are done!
Powered by libappimage, zap supports desktop integration. That means, you don't have to worry about creating desktop files for your downloaded AppImages; everything is so automated.
By default, zap installs the AppImage in ~/.local/share/zap , which is provided by your $XDG_DATA_DIR , you can find all your downloaded copies of the AppImages there
Well, zap is an all in one tool which brings the best of all the technologies implemented at the AppImage Org. Using AppImageUpdate, supported AppImages can be updated with delta updates using zsync. That means you no longer would have to download the entire appimage again for every update, only the changed parts. Well thats awesome.
By default, zap uses appimageupdate to update apps. You can manually force zap to not use appimageupdate by providing --no-appimageupdate
❯ zap update --help
Usage: zap update [OPTIONS] APPNAME
Updates an appimage using appimageupdate tool
Options:
-a, --appimageupdate / --no-appimageupdate
Use AppImageupdate tool to update apps.
--help Show this message and exit.
Well, the new AppImage Catalog (appimage.github.io - v2) which is under development has a Click-2-Install feature. Just click on the Lightning bolt icon on the Apps release you would like to install.
This feature is still under testing, to enable this feature, please add the following file to this directory
~/.local/share/applications/zap-protocol.desktop
------------------------------------------------
[Desktop Entry]
Name=Zap
Exec=$HOME/zap/zap-x86_64.AppImage xdg %u
Icon=zap
Type=Application
Terminal=true
MimeType=x-scheme-handler/zap;
All Pull Requests are welcome.
If you are a non-coder or was inspired by this small project, I would be glad if you would 🌟 this repository, and spread the word with your friends and foes 😄
This 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.
Many parts of this documentation have been adapted (plagiarized) from The OhMyZsh Project, you may find the documentation structure is almost similar. And also the installation script.
MIT License
Copyright (c) 2020 Srevin Saju
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
THE 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 NONINFRINGEMENT. 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.
(C) Srevin Saju 2020