HS-Rename/docs/GEARLEVER.md

Using HSRename with Gear Lever

Gear Lever can manage and update the HSRename AppImage. Because releases are hosted on Gitea (not GitHub), use one of the options below.

Option 1: Custom update URL (recommended to try first)

Gitea uses the same release path style as GitHub:
/owner/repo/releases/download/{tag}/{filename}

1. Open Gear Lever and add the HSRename AppImage (drag & drop or Add).
2. Select the HSRename entry and open Update / Custom update URL (or the equivalent in your Gear Lever version).
3. Try this URL pattern (with a wildcard for the tag):

   https://git.hisora.dev/Dawnsorrow/HS-Rename/releases/download/*/HSRename.AppImage
   

4. If Gear Lever accepts it (e.g. field turns green or validates), it may use the Gitea releases page to resolve the latest tag and offer updates when you push new releases.
5. Use Check for updates / List updates to see if it detects new versions.

If your Gear Lever only supports GitHub-style URLs and rejects this, use Option 2.

Option 2: Static URL (manual update link)

If the wildcard URL does not work:

1. In Gear Lever, add HSRename and set Update to Static URL.
2. Paste the direct download URL of the current release, for example:
   • v1.0.3:
     https://git.hisora.dev/Dawnsorrow/HS-Rename/releases/download/v1.0.3/HSRename.AppImage
3. When a new version is released (e.g. v1.0.4), open the releases page, open the new release, right‑click HSRename.AppImage → Copy link address, then in Gear Lever set the Static URL to that new link and run Update.

So: Gear Lever will only “see” updates if you change the Static URL to the new release’s download link when you want to update.

Option 3: CLI (if you use Gear Lever from the terminal)

After adding the AppImage in Gear Lever, you can set the update URL from the command line:

# Set custom update URL (try the wildcard pattern)
gearlever --set-update-url /path/to/HSRename.AppImage "https://git.hisora.dev/Dawnsorrow/HS-Rename/releases/download/*/HSRename.AppImage"

# Check for updates
gearlever --list-updates

# Apply update
gearlever --update /path/to/HSRename.AppImage

Replace /path/to/HSRename.AppImage with the actual path where Gear Lever stores the AppImage.

Release download URL pattern

For any release tag vX.Y.Z, the direct download URL is:

https://git.hisora.dev/Dawnsorrow/HS-Rename/releases/download/vX.Y.Z/HSRename.AppImage

So when we push a new release (e.g. v1.0.4), that new tag’s URL is what Gear Lever needs (either via the wildcard in Option 1 or by pasting the new URL in Option 2).