{"id":15539400,"url":"https://github.com/greatwizard/qmk-firmware-build","last_synced_at":"2025-09-06T17:42:58.428Z","repository":{"id":39880704,"uuid":"491474843","full_name":"GreatWizard/qmk-firmware-build","owner":"GreatWizard","description":null,"archived":false,"fork":false,"pushed_at":"2023-06-08T03:26:10.000Z","size":90,"stargazers_count":0,"open_issues_count":0,"forks_count":1,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-07-28T12:36:14.168Z","etag":null,"topics":["automation","build","firmware","keyboard","keymap","qmk","qmk-firmware","via","vial"],"latest_commit_sha":null,"homepage":"https://github.com/GreatWizard/qmk-firmware-build/releases/tag/nightly","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/GreatWizard.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","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}},"created_at":"2022-05-12T10:54:37.000Z","updated_at":"2022-05-24T09:29:57.000Z","dependencies_parsed_at":"2024-11-08T19:49:54.685Z","dependency_job_id":null,"html_url":"https://github.com/GreatWizard/qmk-firmware-build","commit_stats":{"total_commits":21,"total_committers":1,"mean_commits":21.0,"dds":0.0,"last_synced_commit":"edf1514aa42aab44af26fe867f38e2a4697fb452"},"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/GreatWizard/qmk-firmware-build","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GreatWizard%2Fqmk-firmware-build","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GreatWizard%2Fqmk-firmware-build/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GreatWizard%2Fqmk-firmware-build/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GreatWizard%2Fqmk-firmware-build/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/GreatWizard","download_url":"https://codeload.github.com/GreatWizard/qmk-firmware-build/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GreatWizard%2Fqmk-firmware-build/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":273940063,"owners_count":25195095,"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-09-06T02:00:13.247Z","response_time":2576,"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":["automation","build","firmware","keyboard","keymap","qmk","qmk-firmware","via","vial"],"created_at":"2024-10-02T12:10:18.015Z","updated_at":"2025-09-06T17:42:58.386Z","avatar_url":"https://github.com/GreatWizard.png","language":"JavaScript","funding_links":["https://liberapay.com/GreatWizard/"],"categories":[],"sub_categories":[],"readme":"# QMK Firmware Build\n\n[![CI](https://github.com/GreatWizard/qmk-firmware-build/actions/workflows/ci.yml/badge.svg)](https://github.com/GreatWizard/qmk-firmware-build/actions/workflows/ci.yml)\n[![Publish](https://github.com/GreatWizard/qmk-firmware-build/actions/workflows/publish.yml/badge.svg)](https://github.com/GreatWizard/qmk-firmware-build/actions/workflows/publish.yml)\n[![License: GPL-3.0](https://img.shields.io/github/license/GreatWizard/qmk-firmware-build)](https://github.com/GreatWizard/qmk-firmware-build/blob/master/LICENSE.md)\n[![Liberapay](https://img.shields.io/liberapay/patrons/GreatWizard.svg?logo=liberapay)](https://liberapay.com/GreatWizard/)\n\nThis project uses [QMK Firmware](https://qmk.fm).\n\nIt builds all the via/vial keyboard firmwares configured in the repository.\nIf vial firmware is not available, the default firmware is built as a fallback.\n\n## Release\n\nEvery night the script is executed by Github Actions and updates the `nightly` tag.\n\nYou can download the files directly here:\nhttps://github.com/GreatWizard/qmk-firmware-build/releases/tag/nightly\n\n## How to flash a firmware\n\nFollow steps from this guide: [Flashing your keyboard](https://docs.qmk.fm/#/newbs_flashing).\n\n## VIA or VIAL?\n\nVIA and VIAL are cross-platform (Windows, Linux and Mac) GUI for configuring your keyboard in real time.\nVIA is a closed-source and integrated natively in QMK Firmware.\nVial is an open-source and is based on a QMK fork.\n\n### VIA\n\nSee documentation here: https://www.caniusevia.com/\n\n### VIAL\n\nSee documentation here: https://get.vial.today/\n\n## Add my keyboards\n\nYou can add your keyboards by doing a pull request with the following content:\n\n- create a new user in the `users` directory that is exactly you GitHub nickname\n- for QMK firmwares, add a file `keyboards.yml` in your directory following this structure:\n\n```yaml\n---\n- keyboard: kprepublic/jj50 # required\n  keymaps: [greatwizard] # required\n- fork: # optional\n    username: piit79 # required\n    repository: qmk_firmware # optional, defaults to qmk_firmware\n    branch: master # optional, defaults to master\n  keyboard: 42keebs/mysterium/v15d # required\n  keymaps: [via] # required\n```\n\n- for vial firmwares, add a file `vial.yml` in your directory following this structure:\n\n```yaml\n---\n- fork: # optional\n    username: greatwiard # required\n    repository: vial-qmk # optional, defaults to vial-qmk\n    branch: jj50 # optional, defaults to vial\n  keyboard: kprepublic/jj50 # required\n  keymaps: [vial] # required\n```\n\n## Alternative places to get firmwares\n\n- https://qmk.fm/keyboards/\n- https://qmk.tzarc.io/\n- https://github.com/filterpaper/build_qmk_dev\n- https://github.com/Xelus22/QMK-VIA-Hex-Develop\n- https://github.com/Xelus22/QMK-VIA-Hex\n- https://www.caniusevia.com/docs/download_firmware\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgreatwizard%2Fqmk-firmware-build","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgreatwizard%2Fqmk-firmware-build","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgreatwizard%2Fqmk-firmware-build/lists"}