README.md

---

📖 About

This project is an automated dashboard and flat-file API provider for GL.iNet firmware versions. It tracks the latest firmware releases (RELEASE, BETA, SNAPSHOT, TESTING, etc.) for all GL.iNet router, IOT, and KVM models.

Created by Admon for the GL.iNet community.

🎖️ Community Maintained – Part of the GL.iNet Toolbox project
⚠️ Independent Project – Not officially affiliated with GL.iNet or Tailscale

---

✨ Features

• 🚀 Automated Tracking – Daily updates for all GL.iNet models (Routers, IoT, KVM)
• 🔍 Link Validation – Every download link is verified with a HEAD request, retried on temporary failures. An unreachable link never changes which version is listed; it is flagged instead, and the newest older build that still downloads is offered as a second link
• 🩺 Status Page – /status.html lists every download that could not be reached, with the reason, the number of attempts and the latest reachable build
• 📁 Flat-File API – Simple, machine-readable directory structure for easy integration
• 📊 Categorized Dashboard – Clean UI grouped by device type with search functionality
• ⚡ Last Updated Badges – Track exactly when the data was last verified

---

🎛️ API Usage

This project serves as a machine-readable API. You can access version information directly:

Endpoint	Description
/api/all.json	Consolidated JSON of all tracked models and versions
/api/status.json	Build report: unreachable downloads with reason and attempt count, models the API returned no data for
/api/<model>/branches	Text file listing available firmware stages for a model
/api/<model>/<stage>/version	Returns only the version string (e.g., 4.5.0)
/api/<model>/<stage>/url	Returns the direct download URL for the firmware
/api/<model>/<stage>/date	Returns the release date
/api/<model>/<stage>/hash	Returns the MD5 hash (if available)
/api/<model>/<stage>/changelog	Returns the latest changelog as plain text (TXT)

/api/all.json includes changelog as path reference (e.g. /api/ax1800/release/changelog) instead of inline changelog content. Each entry also carries link_ok, which is false when the download link did not respond during the last build; the per-stage summary at /api/<model>/<stage>/ shows the same as a link: line. When a link is down and an older build still downloads, the entry gains latest_reachable (version, release_time, download) and the summary a matching latest_reachable: line. The reported version is always the newest one GL.iNet publishes, whether or not its download responds.

Example: curl -s https://glinet-firmware.admon.me/api/ax1800/release/version

---

💡 Getting Help

Need assistance or have questions?

• 💬 Join the discussion on GL.iNet Forum – Community support

---

⚠️ Disclaimer

This project is provided as-is without any warranty. Use it at your own risk. It is an independent community project and is not affiliated with GL.iNet.

---

---