Install, update, remove & run AppImage from GitHub using your CLI. (Fork of AppImage ClI Tool)
- Install from the GitHub Releases
- Automatically Integrate App To Desktop When Installing/Updating
- Run Applications From Remote Without Installing Them
- Update with ease
Arch Linux & it's Derivatives
you can use this step if your distribution does provide libappimage v1.0.0 or greater, which is the case on Arch Linux & it's Derivatives, kaOS, KDE Neon, Parabola Linux
install libappimage dependency
pacman -S libappimagethen install bread
sudo curl -L https://github.com/pegvin/bread/releases/download/v0.7.2/bread-0.7.2-x86_64 -o /usr/local/bin/bread && sudo chmod +x /usr/local/bin/breadDebian & it's Derivatives
you can use this step if your distribution doesn't provide libappimage v1.0.0 or greater, which is the case on Debian & it's derivatives
get the appimage containing libappimage v1.0.3
sudo curl -L https://github.com/pegvin/bread/releases/download/v0.7.2/bread-0.7.2-x86_64.AppImage -o /usr/local/bin/bread && sudo chmod +x /usr/local/bin/breadAny version of libappimage will work with bread but it is recommended to use v1.0.0 or greater, You can also Refer to this list to check what version of libappimage your Distribution provides.
Just Remove the binary
sudo rm -v /usr/local/bin/breadNOTE this won't delete the app you've installed.
NOTE
Often there are many times when the GitHub user and repo both are same, for example libresprite, so in this case you can just specify single name like this bread install libresprite, this works with all the commands
Install a application
To install an Application from GitHub you can use the install command where user is the github repo owner and repo is the repository name
bread install user/repoTo install an application from a different Tag name you can specify the tag name too
bread install user/repo tagnameRun a application from remote
If you want to run a application from remote without installing it you can use the run command
bread run user/repoYou can pass CLI arguments to the application too like this
bread run user/repo -- --arg1 --arg2You can clear the download cache using clean command bread clean, Since all the applications you run from remote are cached so that it isn't downloaded everytime
Remove a application
you can remove a installed application using the remove command
bread remove user/repoUpdate a applicationn
You can update a application using the update command
bread update user/repoif you just want to check if update is available you can use the --check flag
bread update user/repo --checkif you want to update all the applications you can use the --all flag
bread update --allthe --check & --all flag can be used together
bread update --all --checkthe -n or --no-pre-release flag can be used to disable updates for pre-releases.
bread update --no-pre-releaseSearch for an application
You can search for a application from the AppImage API
bread search "Your search text"List all the installed application
You can list all the installed applications using list command
bread listIf you also want to see the SHA1 Hashes of the applications listed, you can pass the -s or --show-sha1 flag
bread list --show-sha1If you want to see the GitHub release tag name -t or --show-tag flag
bread list --show-tag- Icons not showing in menus until there's a system reboot
- Update Command Crashing
- Bread uses GitHub API to get information about a repository and it's release, but without authentication GitHub API limits the request per hour.
- Ubuntu 20.04 - by me
- Debian 11 - by me
- Manjaro Linux - by me
- Arch Linux - by my brother
Bread installs all the applications inside the Applications directory in your Linux Home Directory ~, inside this directory there can be also a directory named run-cache which contains all the appimages you've run from the remote via the bread run command.
In the Applications there is also a file named .registry.json which contains information related to the installed applications!
In the Applications directory there is also a file named .AppImageFeed.json which is AppImage Catalog From AppImage API
- Zap - ⚡ Delightful AppImage package manager
- A AppImage Manager Written in Shell
- The Original Tool Which Bread is Based On
Make Sure You Have Go version 1.18.x & AppImage Builder Installed.
Get The Repository Via Git:
git clone https://github.com/pegvin/breadGo Inside The Source Code Directory & Get All The Dependencies:
cd bread
go mod tidyMake The Build Script Executable And Run It
chmod +x ./make
./make --prodAnd To Build The AppImage Run
./make appimageThe make bash script can build your go code, make appimage out of it, and clean the left over stuff including the genrated builds.
This will build the go code into a binary inside the build folder
./make
Building for production requires passing --prod flag which will enable some compiler options resulting in a small build size.
./make --prod
Bread requires libappimage0 for integrating your apps to desktop, which is done via libappimage, to make End user's life easier we package the libappimage with bread and that's why we build the binaries into AppImages so that user doesn't need to install anything.
To make a appimage out the pre built binaries
./make appimage
To install the dependencies require to build go binary
./make get-deps
- Switch To Some Other Language Since Go Module System is Shit
- Improve UI
- Make AppImages Runnable From Remote Without Installing (Done in v0.3.6)
- Work On Reducing Binary Sizes (Reduced From 11.1MB to 3.1MB)
- Add 32 Bit Builds (Currently not possible since DL dependency is not available for 32 bit machines)
- Add Auto Updater Which Can Update The Bread Itself
- Add
--versionTo Get The Version (Done in v0.2.2) - Mirrors:
- ✖️ I Would Like To Introduce Concept Of Mirror Lists Which Contain The List Of AppImages With The Download URL, tho currently i am not working on it but in future i might.
- I am dropping this idea, tho i've added a search command which can search for appimages from a central server API