HS-Rename/docs/GEARLEVER.md

Using HSRename with Gear Lever

Gear Lever 4.x can update HSRename from Gitea releases. Gitea uses the same API as Forgejo, which Gear Lever supports directly.

Important: use Forgejo, not Default

In the HSRename details screen:

• Source must be Forgejo (not Default).
• The Website field is only metadata. It does not check for updates.
• Do not paste the release download URL into Website.

Configure updates (Gear Lever 4+)

1. Open Gear Lever → select HSRename.

2. Set Source to Forgejo.

3. Fill in:

   Field	Value
   Repo URL	https://git.hisora.dev/Dawnsorrow/HS-Rename
   Release file name	HSRename.AppImage
   Allow pre-releases	Off (unless you want draft releases)

4. Save, then use Check for updates / List updates.

If the fields validate (no error), Gear Lever queries:

https://git.hisora.dev/api/v1/repos/Dawnsorrow/HS-Rename/releases/latest

and compares the release asset file size with your local AppImage.

Gear Lever does not compare version numbers or file contents. If two releases compress to the same byte size (common with AppImages), it will say “No updates available” even when the app changed. HSRename releases from v1.0.7 onward include a small version-specific padding file so each release has a unique size.

To see which version you have without updating: open the AppImage mount folder usr/share/hsrename/VERSION, or check X-AppImage-Version in Gear Lever metadata after Reload metadata.

Direct download URL pattern

For release tag vX.Y.Z:

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

Latest release today:

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

Fallback: Static URL

If Forgejo does not work in your Gear Lever build, set Source to Static URL and paste the exact URL of the newest release (update this manually each release):

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

CLI (if gearlever is installed)

Gear Lever 4 may use different CLI options than older docs. Prefer the GUI Forgejo fields above. If your install still supports --set-update-url, the old wildcard pattern is not reliable for self-hosted Gitea; use Forgejo instead.

Troubleshooting

Symptom	Likely cause
No update offered	Source is still Default; local file size matches releases/latest (Gear Lever ignores version/content); or wrong Forgejo repo URL.
URL looks truncated in Website	Website is cosmetic only; configure Forgejo fields instead.
Update never finds newer builds	Wrong repo URL, wrong filename, or release has no HSRename.AppImage asset attached.

Releases page: https://git.hisora.dev/Dawnsorrow/HS-Rename/releases