# PixelHue Mirror

> PixelHue Mirror is an unofficial mirror of PixelHue video processor and switcher resources: firmware, control software, specifications, user manuals, and release notes, synced from pixelhue.com. Files are served directly from mirror.pixelhue.wiki via filename-based URLs.

## When to use this

Use PixelHue Mirror when you need to:
- Download a specific PixelHue processor firmware (e.g. Q8, U5 Pro, P80) or control software (e.g. PixelFlow) without navigating the official site's download portal
- Check whether a firmware, software package, or document has been updated: GET /api/changes.json returns recently changed files as JSON
- Read specifications, user manuals, or release notes (PDF) inline in a browser or agent context
- Enumerate every available file programmatically via the sitemap, including superseded versions

Do NOT use this site for official support, warranty, or sales questions — those belong to PixelHue at https://pixelhue.com/. This mirror carries PixelHue products only; it is not a general firmware archive.

## How an agent should call this site

- Catalog listing: GET https://mirror.pixelhue.wiki/ with header `Accept: text/markdown` for a Markdown catalog, or `Accept: text/html` for the interactive page
- Full catalog as JSON: GET https://mirror.pixelhue.wiki/api/catalog.json — groups → products → files with version, size, and date
- File download or inline document: GET https://mirror.pixelhue.wiki/<URL-encoded filename> — filenames are listed in sitemap.xml; documents render inline, binaries download as attachments
- Recent changes: GET https://mirror.pixelhue.wiki/api/changes.json — JSON array sorted by lastChangedAt, newest first
- API contract: https://mirror.pixelhue.wiki/openapi.json — OpenAPI 3.1 spec with typed schemas for every endpoint; https://mirror.pixelhue.wiki/api returns a machine-readable endpoint index
- Versioning: API responses carry an `API-Version: 1` header; deprecated operations emit `Deprecation`/`Sunset` headers at least 90 days before removal
- Rate limits: responses carry informational `RateLimit-*` headers (60 req/min policy); a hard limit, if ever enabled, returns 429 with `Retry-After`
- Errors: 404/503 responses return Markdown with `Accept: text/markdown`, or structured JSON ({"error": {code, message, hint}}) with `Accept: application/json`

## Browser agents (WebMCP)

This site implements WebMCP: pages are cross-origin isolated and register read-only tools on `navigator.modelContext`. Browser agents should call these instead of scraping the DOM:

- `search_catalog({query, category?})` — search firmware/software/documents; returns files with absolute download URLs
- `list_products()` — all product groups and models with file counts
- `get_download_url({filename})` — resolve one file by name to metadata + download URL
- `get_recent_changes()` — latest upstream releases, newest first

## Resources

- [Homepage](https://mirror.pixelhue.wiki/): interactive catalog with search
- [Developers](https://mirror.pixelhue.wiki/developers): API quickstart and documentation
- [openapi.json](https://mirror.pixelhue.wiki/openapi.json): OpenAPI 3.1 specification
- [sitemap.xml](https://mirror.pixelhue.wiki/sitemap.xml): full file index
- [Catalog API](https://mirror.pixelhue.wiki/api/catalog.json): full catalog as JSON
- [Changes API](https://mirror.pixelhue.wiki/api/changes.json): recently updated files
- [About](https://mirror.pixelhue.wiki/about) | [Contact](https://mirror.pixelhue.wiki/contact) | [Privacy](https://mirror.pixelhue.wiki/privacy)