{"id":16253494,"url":"https://github.com/petarov/query-apple-firmware-updates","last_synced_at":"2025-08-29T06:11:57.694Z","repository":{"id":57693351,"uuid":"455817855","full_name":"petarov/query-apple-firmware-updates","owner":"petarov","description":"🍎Query firmware updates about Apple devices","archived":false,"fork":false,"pushed_at":"2025-01-04T21:09:00.000Z","size":55,"stargazers_count":2,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-07-14T11:46:04.154Z","etag":null,"topics":["apple","dfu","firmware-updates","ios","ios-firmware","ipados","mdm"],"latest_commit_sha":null,"homepage":"https://vexelon.net/qadfu/","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/petarov.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2022-02-05T08:39:34.000Z","updated_at":"2025-01-04T21:07:45.000Z","dependencies_parsed_at":"2025-07-14T10:29:51.887Z","dependency_job_id":"99f97fd0-7667-43b8-8c9c-dcf3fe292861","html_url":"https://github.com/petarov/query-apple-firmware-updates","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/petarov/query-apple-firmware-updates","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/petarov%2Fquery-apple-firmware-updates","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/petarov%2Fquery-apple-firmware-updates/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/petarov%2Fquery-apple-firmware-updates/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/petarov%2Fquery-apple-firmware-updates/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/petarov","download_url":"https://codeload.github.com/petarov/query-apple-firmware-updates/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/petarov%2Fquery-apple-firmware-updates/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":272640648,"owners_count":24968713,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-08-29T02:00:10.610Z","response_time":87,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["apple","dfu","firmware-updates","ios","ios-firmware","ipados","mdm"],"created_at":"2024-10-10T15:17:37.336Z","updated_at":"2025-08-29T06:11:57.663Z","avatar_url":"https://github.com/petarov.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Query Apple Devices Firmware Updates\n\n[![CI Build](https://github.com/petarov/query-apple-firmware-updates/actions/workflows/build.yml/badge.svg)](https://github.com/petarov/query-apple-firmware-updates/actions/workflows/build.yml)\n[![Go Report Card](https://goreportcard.com/badge/github.com/petarov/query-apple-firmware-updates)](https://goreportcard.com/report/github.com/petarov/query-apple-firmware-updates)\n\nA web service that delivers firmware update infos about Apple devices.\n\nThis is in fact a caching proxy for [ipsw.me](https://ipsw.me/). Update infos are being stored in a local SQLite database.\n\n# Installation\n\nDownload `devices.json` from [SeparateRecords/apple_device_identifiers](https://github.com/SeparateRecords/apple_device_identifiers).\n\nRun `make` to produce binaries in the `dist` folder.\n\n# Usage\n\nTo start the service on `[::1]:7095` run:\n\n    ./qadfu_linux_amd64 -devices devices.json -db database.db\n\nThe webapp is available at `http://localhost:7095`.\n\n## Run as systemd daemon\n\nDownload the binary and `devices.json` file to `/opt/qadfu/` on your server. \n\nCreate a bash `/opt/qadfu/start.sh` startup script:\n\n```bash \n#!/bin/sh\n\n./qadfu_linux_amd64 -addr localhost -devices devices.json -db database.db\n```\n\nCreate the following file under `/lib/systemd/system/qadfu.service`:\n\n```bash\n[Unit]\nDescription=Query Apple Devices Firmware Updates\nAfter=nginx.service\n\n[Service]\nType=simple\nRestart=always\nRestartSec=5s\nRestart=on-failure\nWorkingDirectory=/opt/qadfu\nExecStart=/opt/qadfu/start.sh\n\n[Install]\nWantedBy=multi-user.target\n```\n\nTo enable the systemctl service run:\n\n    systemctl reenable /lib/systemd/system/qadfu.service\n\nTo start the service run:\n\n    systemctl start qadfu.service\n\n\n# API\n\nList of available API calls:\n\n- `/api` - shows all available junctions\n- `/api/devices` - Fetches a list of all Apple devices\n- `/api/devices/:product` - Fetches a single Apple device by product name\n- `/api/devices/search?key=:key` - Fetches a list of matching devices given the `key` parameter\n- `/api/updates/:product` - Fetches device updates by product name\n\n# Development\n\nTo install deps run:\n\n    go get\n\nTo run the server:\n\n    go run -tags \"fts5\"  main.go -devices devices.json -db database.db\n\nThe build tag `fts5` enables the SQLite FTS5 extension in the `mattn/go-sqlite3` lib.\n\n# License \n\n[MIT](LICENSE)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpetarov%2Fquery-apple-firmware-updates","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpetarov%2Fquery-apple-firmware-updates","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpetarov%2Fquery-apple-firmware-updates/lists"}