Bulk RenamerandCursor
28ec7746b8
Forgejo compares release asset size only; v1.0.5 and v1.0.6 were identical at 62933496 bytes. Co-authored-by: Cursor <[email protected]>
72 lines
2.9 KiB
Markdown
72 lines
2.9 KiB
Markdown
# Using HSRename with Gear Lever
|
|
|
|
[Gear Lever](https://github.com/mijorus/gearlever) 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
|