A shepherd for your Appimages.
add magic install script
Aly Raffauf
(Jun 18, 2026, 12:11 PM EDT)
9bf2e199
f65ab144
+75
+21
README.md
+21
README.md
···
19
19
20
20
## Installation
21
21
22
+
### Quick install
23
+
24
+
```bash
25
+
curl -sSL https://raw.githubusercontent.com/alyraffauf/appherder/main/scripts/install.sh | bash
26
+
```
27
+
28
+
This downloads the latest AppImage, installs it, and enables automatic sync and upgrades.
29
+
22
30
### Download a binary
23
31
24
32
Grab `appherder-linux-amd64` from the [latest release](https://github.com/alyraffauf/appherder/releases/latest), then:
···
27
35
chmod +x appherder-linux-amd64
28
36
sudo mv appherder-linux-amd64 /usr/local/bin/appherder
29
37
```
38
+
39
+
### AppImage
40
+
41
+
Download the `.AppImage` from the [latest release](https://github.com/alyraffauf/appherder/releases/latest), then:
42
+
43
+
```bash
44
+
chmod +x appherder-*-x86_64.AppImage
45
+
./appherder-*-x86_64.AppImage install ./appherder-*-x86_64.AppImage
46
+
appherder autosync
47
+
appherder autoupgrade
48
+
```
49
+
50
+
The install step copies it into `~/AppImages` and links it to `~/.local/bin/appherder` automatically.
30
51
31
52
### Nix flake
32
53
+54
scripts/install.sh
+54
scripts/install.sh
···
1
+
#!/bin/bash
2
+
set -eu
3
+
4
+
REPO="alyraffauf/appherder"
5
+
DEST="$HOME/AppImages"
6
+
BIN="$HOME/.local/bin"
7
+
8
+
if [ -n "${GH_TOKEN:-}" ]; then
9
+
AUTH="Authorization: Bearer $GH_TOKEN"
10
+
elif [ -n "${GITHUB_TOKEN:-}" ]; then
11
+
AUTH="Authorization: Bearer $GITHUB_TOKEN"
12
+
else
13
+
AUTH=""
14
+
fi
15
+
16
+
echo "Fetching latest release..."
17
+
if [ -n "$AUTH" ]; then
18
+
URL=$(curl -sL -H "$AUTH" "https://api.github.com/repos/$REPO/releases/latest" |
19
+
grep -o '"browser_download_url": "[^"]*AppImage"' |
20
+
head -1 | cut -d'"' -f4)
21
+
else
22
+
URL=$(curl -sL "https://api.github.com/repos/$REPO/releases/latest" |
23
+
grep -o '"browser_download_url": "[^"]*AppImage"' |
24
+
head -1 | cut -d'"' -f4)
25
+
fi
26
+
27
+
if [ -z "$URL" ]; then
28
+
echo "Could not find AppImage asset in latest release" >&2
29
+
exit 1
30
+
fi
31
+
32
+
TMP="$(mktemp -d)"
33
+
trap 'rm -rf "$TMP"' EXIT
34
+
APPIMAGE="$TMP/appherder.AppImage"
35
+
36
+
echo "Downloading..."
37
+
curl -sLo "$APPIMAGE" "$URL"
38
+
chmod +x "$APPIMAGE"
39
+
40
+
echo "Installing..."
41
+
mkdir -p "$DEST" "$BIN"
42
+
"$APPIMAGE" install "$APPIMAGE"
43
+
44
+
echo "Enabling background services..."
45
+
"$BIN/appherder" autosync
46
+
"$BIN/appherder" autoupgrade
47
+
48
+
echo
49
+
echo "appherder installed. Run 'appherder --help' to get started."
50
+
echo "If 'appherder' is not found, re-open your terminal or run:"
51
+
echo " export PATH=\"$BIN:\$PATH\""
52
+
echo
53
+
echo "Coming from another AppImage manager? Run 'appherder migrate' to adopt"
54
+
echo "existing apps in $DEST."