ivan-hc / appimagedl

Easily download AppImages and keep them up to date. Integrates with AppImageHub to get information about available AppImages.

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

appimagedl

appimagedl is a command line AppImage manager that integrates with AppImageHub. appimagedl uses https://appimage.github.io/feed.json to get information about approved AppImages from AppImageHub. If possible, 'appimageupdatetool' is used to keep AppImages up to date. Otherwise, 'jq' and 'wget' are used to get the latest release information using Github's API.

appimagedl is not responsible for bugs within AppImages that have been downloaded using appimagedl. Please report any bugs that are specific to downloaded AppImages to their maintainers.

How to install

wget https://raw.githubusercontent.com/ivan-hc/appimagedl/master/appimagedl-install
chmod a+x ./appimagedl-install
sudo ./appimagedl-install

Enable a local $PATH to run the programs as binary files

To run the AppImages from the command line (command appimagedl download $PROGRAM), add the following line at the end of your ~/.bashrc:

export PATH=$PATH:$(xdg-user-dir USER)/.local/bin

You can quickly do that using the following command:

echo 'export PATH=$PATH:$(xdg-user-dir USER)/.local/bin' >> ./.bashrc

Arguments

list|l      - list all available AppImages

info|i      - output json file containing information for an AppImage

search|se   - search for available AppImages

download|dl - download an AppImage to $TARGET_DIR

get         - download an AppImage to $GET_DIR without managing it

remove|rm   - remove a downloaded AppImage

update|up   - update list of AppImages and check downloaded AppImages for updates

revert|rev  - revert an updated AppImage to its previous version if available

freeze|fr   - mark or unmark an AppImage as FROZEN to preven update checks

config|cf   - open appimagedl's config file with $EDITOR

man|m       - show appimagedl man page

Additional Arguments

[list|info] --downloaded|-d   - show list or info for downloaded AppImages

--verbose [option] [AppImage] - add bash option 'set -v' for verbose output

--debug [option] [AppImage]   - add bash option 'set -x' for debugging

Github Rate Limit

By default, Github's rate limit for API checks is 60 per hour. When authenticated, the rate limit is increased to 5000 per hour. To take advantage of the increased rate limit, it is suggested that you add your token to appimagedl.conf.

It is recommended that you do not give this token access to any scopes as it will be stored in plain text in your config file. It may even be a good idea to create a throwaway account for use with this.

To use authenticated Github API checks with appimagedl, edit the following line in ~/.config/appimagedl/appimagedl.conf to contain your token:

GITHUB_TOKEN="YOURTOKEN"

How to uninstall

To remove appimagedl run the following command:

sudo /opt/appimagedl/remove

To remove all the downloaded applications (using the get option), do:

rm -R ~/.AppImages

To remove all the installed apps (using the download option), do:

rm -R ~/.local/bin/*

To remove the configuration files:

rm -R ~/.config/appimagedl

What is an AppImage?

An AppImage is a downloadable file for Linux that contains an application and everything the application needs to run (e.g., libraries, icons, fonts, translations, etc.) that cannot be reasonably expected to be part of each target system.

Related project

About

Easily download AppImages and keep them up to date. Integrates with AppImageHub to get information about available AppImages.

License:MIT License


Languages

Language:Shell 95.5%Language:Roff 4.5%