Releases: cjayacopra/shiranekowrt
Release list
ShiranekoWrt 3.2.0
[3.2.0] — 2026-07-13
Added
- v2rayA v2.7.7.5 — new web-based proxy management frontend with xhttp support, offering an alternative to Xray's LuCI interface.
- QModem Boot Hook — automatically reapplies the lock cell command after modem initialization for reliable cell locking.
- Custom
luci-app-guest-wifi— JS-based guest Wi-Fi app purpose-built for OpenWrt 24.10, modern LuCI JS, fw4, and DSA, replacing the previous Lua-based implementation.
Changed
luci-app-guest-wifi— replaced with cjayacopra's JS-based, designed for OpenWrt 24.10's fw4/DSA firewall model.- Aurora theme UI/UX — refined palette, logo, and wallpaper for a more polished, modern look.
- GHFU — now tailored specifically for ShiranekoWrt, with firmware update workflow streamlined for this device.
- QModem — enhanced with Boot Hook support for automatic cell locking after modem re-initialization.
Fixed
luci-app-netstat(netstat-js) — resolved Network usage not showing in the UI.
Removed
luci-app-guest-wifi— removed legacy guest-wifi app.
Others
- under the hood fixes and optimizations
ShiranekoWrt 3.1.0
ShiranekoWrt 3.1.0 — Initial Public Release
ShiranekoWrt is a custom OpenWrt firmware built for the Arcadyan AW1000, leveraging Qualcomm's NSS (Network SubSystem) hardware offloading and RMNET for high-throughput cellular networking. It ships with a Aurora-themed LuCI interface, transparent proxying via Xray, full QModem cellular support, NAS/storage services, and a tailored front-panel LED status scheme.
Version: 3.1.0 (code RMNET-NSS) · based on OpenWrt 24.10-SNAPSHOT
Highlights
- Wire-speed everything. Qualcomm NSS hardware offload plus RMNET keeps the AW1000's CPU nearly idle while it pushes full line-rate — NAT, routing, and cellular tunneling all happen in silicon, not on the cores.
- Cellular that just works. QModem auto-dials your Quectel modem over NSS-accelerated QMI, with PCIe scan, signal/modemdata status, time sync, and live monitoring ready out of the box.
- Transparent proxy, zero fuss. Xray runs a full VLESS transparent proxy with CN geo-routing, ad-blocking, and least-ping load balancing — driven entirely from LuCI via
luci-app-xray. - A UI you'll actually want to look at. A rebranded Aurora theme (custom logo, wallpaper, and palette) makes LuCI feel native to the device.
- Flip it into a NAS. Samba4 + MiniDLNA with drive idle/spin-down, plus btrfs / ext4 / f2fs / ntfs3 support and disk-management tools.
- One tap to update.
ghfupulls the newest build straight from GitHub. - Everyday extras. Guest Wi-Fi, Wi-Fi scheduling, and live system stats round out the kit.
Default configuration
| Setting | Value |
|---|---|
| Hostname | ShiranekoWrt |
| Root password | admin@aw1000 |
| Timezone | Asia/Manila (PST-8) |
| LAN IPv6 | Disabled |
| QModem | Auto-dial enabled, PCIe scan enabled |
| LED indicators | Documented in "LED indicators" below |
Default wireless credentials
| Band | SSID | Password | Encryption | Channel / Width |
|---|---|---|---|---|
| 5 GHz | ShiranekoWrt 5G |
wireless123@ShiranekoWrt |
WPA2 (psk2) | 36 / HE160 |
| 2.4 GHz | ShiranekoWrt |
wireless123@ShiranekoWrt |
WPA/WPA2 mixed (psk-mixed) | 1 / HE20 |
Both radios use country code PH and are enabled by default. Change the Wi-Fi pasShiranekoWrt v3.1.0sword after first boot.
LED indicators
The front-panel LEDs reflect modem, signal, and connectivity state (RSRP re-sampled every 5s):
Network type (5g LED)
| LED | Lights when |
|---|---|
green:5g |
Connected via 5G — NR-SA / NR-NSA |
blue:5g |
Connected via 4G — LTE |
red:5g |
Connected via 3G — WCDMA/UMTS/HSPA or GSM/GPRS/EDGE |
Signal strength (signal LED)
| LED | RSRP |
|---|---|
green:signal |
≥ -95 dBm (good) |
blue:signal |
-110 to -95 dBm (medium) |
red:signal |
< -110 dBm (poor) / no signal |
Status LEDs
green:internet— on when an internet connectivity probe succeeds.green:wifi— on when any Wi-Fi AP interface is up.- SIM absent — all type/signal LEDs off except
red:signal+red:5g.
⚠️ Hardware requirement — Expanded MTD Layout
This firmware has only been tested with the Expanded MTD Layout described here:
https://github.com/ChamodyaChiran/AW1000-NSS-Build-Public/blob/main/Expanded%20MTD%20layout.md
Flashing this firmware without first applying the expanded MTD layout may brick your device. Do not flash unless your AW1000 is already running the expanded layout.
Disclaimer
This firmware is provided as-is, without any warranty of any kind, express or implied. Use it at your own risk. The authors are not responsible for any damage, data loss, or bricked devices resulting from its use.
Upgrade
Use ghfu (LuCI → System → Firmware Update) pointed at cjayacopra/shiranekowrt, or flash the *.bin via U-Boot / LuCI. Config is preserved by default (keep_config=1).
Credits
ShiranekoWrt stands on the shoulders of many open-source projects and their authors:
- qosmio — for the NSS packages and patches that make hardware offloading on the IPQ807x possible.
- FUjr — for QModem (
luci-app-qmodem) and the cellular/Quectel tooling. - OpenWrt Project — the base firmware, build system, and package ecosystem.
- LuCI Team — the web UI framework.
- Xray-core / XTLS — the VLESS proxy core and transparent proxying.
- yichya —
luci-app-xray, the LuCI management UI that drives Xray on this firmware. Xray would not be usable here without it. - Samba Team — Samba4 file sharing.
- MiniDLNA (readyMedia) authors — the DLNA media server.
- smallprogram —
luci-app-ghfu(GitHub Firmware Update). - eamonxg —
luci-theme-auroraandluci-app-aurora-config. - Quectel & the OpenWrt community — the customized Quectel CM and modem drivers.
- Every upstream package maintainer and contributor.
Bundled custom packages
These packages are vendored under package/custom:
| Package | Author / Source |
|---|---|
luci-theme-aurora |
eamonxg (forked by cjayacopra) |
luci-app-aurora-config |
eamonxg |
luci-app-guest-wifi |
binsee |
luci-app-bandix / openwrt-bandix |
timsaya |
luci-app-cpu-status |
gSpotx2f |
luci-app-disks-info |
gSpotx2f |
luci-app-netstat |
nooblk-98 (original; JS-modernized fork by cjayacopra) |
quectel-timesync |
sevvian |
This list is not exhaustive — thanks to the entire open-source community whose work this firmware builds upon.
Support
If ShiranekoWrt is useful to you, consider supporting the project — donations help cover build infrastructure and device costs.
- ☕ Ko-fi: https://ko-fi.com/shiraneko05
- 💚 OpenWrt (upstream): https://openwrt.org/donate — ShiranekoWrt is built on OpenWrt; please consider supporting the project it derives from.