$ show kiddin9/Kwrt
This repository is a custom OpenWrt firmware distribution named 'Kwrt', based on the openwrt-25.12 stable branch and heavily optimized for Chinese domestic use. It provides a multi-target build overlay system with per-device configuration, patches, and customization scripts for a wide range of router and SBC platforms (x86_64, Rockchip, MediaTek, Qualcomm IPQ, Broadcom, Amlogic, etc.). The core functionality is to produce ready-to-flash firmware images with Chinese localization, pre-configured WiFi, custom package feeds, and additional device support not present in upstream OpenWrt. The build process is fully automated via GitHub Actions, which triggers on repository dispatch events, builds firmware for all targets, uploads artifacts to release pages and cloud storage, and sends notifications via Telegram. The repository also includes an online firmware customization service at openwrt.ai and a self-hosted package repository at dl.openwrt.ai. While the codebase is functional and well-organized for its purpose, it exhibits hobbyist maintenance patterns such as brittle sed-based patching, hardcoded local paths, binary blobs without provenance, and incomplete patch files, which limit its reusability and long-term maintainability.
The LLM identified 3 files worth highlighting for reuse:
A self-contained shell script that applies common customizations to every OpenWrt build target: adds the kiddin9/op-packages feed, rewrites default package selection, renames the distribution to 'Kwrt', sets LAN IP to 10.0.0.1, enables WiFi with country CN, and applies a series of patches from ImmortalWrt and Lean's lede. It is reusable as a template for any OpenWrt derivative build that needs consistent baseline configuration across multiple hardware targets.
A GitHub Actions workflow that orchestrates firmware builds for all device targets using a matrix strategy. It is triggered by repository_dispatch events, checks out the repo, sets up build dependencies, compiles firmware for each target, uploads artifacts to GitHub releases and cloud storage (WeTransfer, CowTransfer), deploys the ImageBuilder to dl.openwrt.ai, and sends Telegram notifications. This workflow demonstrates a robust, reusable pattern for multi-target firmware CI/CD with artifact distribution.
A patch for the opkg package manager that forces dependency resolution even when packages are marked as 'force-depends'. This is a non-obvious fix that addresses a common issue in OpenWrt where package installations fail due to missing optional dependencies. The patch is clean, minimal, and could be reused in any OpenWrt-based distribution to improve package management robustness.