Argon for OpenWrt LuCI: install the theme, then configure it
Argon is a clean and tidy OpenWrt LuCI theme that allows users to customize their login interface with images or videos. It also supports automatic and manual switching between light and dark modes.
At a glance
- What is it?
- Argon is a LuCI theme for OpenWrt. It swaps the stock admin look for a cleaner layout, adds light and dark modes, and lets the login page use an image or video background. Here is what the repository actually documents, and where it stays quiet.
- Who is it for?
- Adopt Argon if you run an OpenWrt build and want a lighter admin interface with dark mode and a custom login background; the README gives both opkg and apk paths, so check which package manager your build uses before downloading. Skip it if your firmware uses APK v2, which cannot read the APK packages, or if you need a theme with a documented rollback procedure, because the README does not describe one.
- Can I use it commercially?
- Yes. Apache-2.0 is a permissive licence: you can use, modify and sell software built on it, as long as you keep its copyright and licence notices.
- Is it still maintained?
- Yes. The repository last received commits 2 days ago.
- What is it written in?
- Mainly Less, according to GitHub's language statistics.
Answers come from the project's GitHub data, last synced on November 15, 2026, and from our analysis. They are not legal advice.
Star history
- jerrykuku/luci-theme-argon5,621 ★ · +129
| Repository | 2026-09-23 | 2026-11-15 |
|---|---|---|
| jerrykuku/luci-theme-argon | 5.5k | 5.6k |
129 Stars in the last 53 days, measured from the daily GitHub snapshot. Compare with other projects
Editorial analysis
What Argon changes in the LuCI admin interface
LuCI is the web interface that ships with OpenWrt, and it is themeable. Argon replaces the default look with what the README calls a clean and tidy design, and it is aimed at people who administer a router through the browser often enough to care about how that interface reads. The repository topics line up with that audience: lede, luci, openwrt, theme.
The feature list is short and specific. Desktop and mobile layouts are both adapted. Light and dark modes can switch automatically or manually. Accent colors are customizable, and login glass effects are adjustable. The login page accepts a local image, a video, or an online wallpaper as its background.
Configuration is built in: the README says that in 3.0 the theme and configuration features are one package, luci-theme-argon, and the settings live under System → Argon Config. The release's luci-app-argon-config is only an empty migration package using the old package name.
How the theme is packaged and wired into a build
The repository is not a standalone application. The top-level entries tell you what kind of project this is: htdocs/ for the web assets, less/ for the stylesheet sources, root/ for files that land in the device filesystem, ucode/ for the ucode components, and a Makefile that follows the standard OpenWrt package layout. The primary language is Less, which matches the stylesheet directory and means the CSS you eventually get is compiled from Less sources during the build.
The Makefile is short and worth reading before you file a bug. It pulls in $(TOPDIR)/rules.mk and $(TOPDIR)/feeds/luci/luci.mk, declares the package title as Argon Theme, and sets LUCI_DEPENDS to +luci-base +USE_APK:wget-any +!USE_APK:wget +jsonfilter +ucode-mod-math +flock +coreutils +coreutils-timeout. That conditional syntax is the interesting part: depending on whether the target uses apk, the package pulls wget-any or plain wget, and in both cases jsonfilter. The version is pinned at 3.1.2 with PKG_RELEASE 20261102, and CONFIG_LUCI_CSSTIDY is emptied, which disables CSS tidying for this package.
The practical consequence is that Argon is a buildroot package first and a downloadable artifact second. Both routes exist, but the Makefile is the one the repository is organized around.
Installing luci-theme-argon from release packages
The README documents two install paths for release packages, one for opkg and one for APK v3, and points to docs/DEVELOPMENT.md for source builds. Start with the package manager your build uses, because the artifacts differ: an .ipk for opkg, an .apk for apk.
For opkg builds, fresh installations need only the luci-theme-argon package downloaded from Releases. Run opkg update first, then:
opkg install ./luci-theme-argon_*.ipkFor APK v3 (apk-tools 3.x) builds, the filename and the install command change; APK v2 cannot read these packages. Note the --allow-untrusted flag, which the README includes as part of the command:
apk add --allow-untrusted ./luci-theme-argon-*.apkIf you build your own image, the README points to the Build with OpenWrt section of docs/DEVELOPMENT.md, and says to stop including the old standalone luci-app-argon-config plugin alongside the theme.
After installing, the README says to select Argon under System → System → Language and Style → Design.
Where Argon stops being the right choice
The README's compatibility notes are about package managers: download the format matching your firmware's native package manager, and APK v2 cannot read the APK packages. Version 3.1 lists improved compatibility with stable OpenWrt firmware. That is a bigger constraint than it looks, because themes touch layout templates, and a mismatch shows up as broken pages rather than a clean error.
The login background feature is the second place to be careful. The README says the login page supports local images, videos, and online wallpapers. A video background on a login page is served from the router itself, and the README gives no guidance on file size, format, or where the files should be placed. It also does not discuss what happens when an online wallpaper URL is unreachable. If your router has limited flash or a slow link, that is your problem to size, not something the documentation resolves.
Finally, the README does not document rollback. If a theme change leaves the interface unusable, the documented material gives you no recovery procedure. Anyone administering a remote router should weigh that before installing.
Argon against the other LuCI themes people compare it with
The README does not compare Argon to other LuCI themes, so the differences below come from what Argon's own documentation claims about itself.
The distinction is the login page. Argon's stated feature set centers on customizing the login interface with images or videos, plus automatic and manual light and dark switching. A theme that does not offer a media background on the login page is solving a different problem: it is restyling the admin pages and stopping there. If your reason for changing themes is the login screen, Argon is aimed directly at that. The README also claims refined layouts, forms and tables for most third-party LuCI apps, with desktop/mobile and light/dark adaptations.
Since 3.0, Argon ships theme and configuration as one package, luci-theme-argon, with settings under System → Argon Config.
Maintenance, licence and the cost of keeping up
The repository is not archived, and the last push was on 2026-11-02. Releases are frequent: v3.1.0 on 2026-10-22, v3.1.1 on 2026-10-28, and v3.1.2 on 2026-11-02. The README points to RELEASE.md and RELEASE_ZH.md for the full version history, so the changelog lives in the repository rather than only in release notes.
Upgrade cost depends on how you installed it. If you built Argon into your image, you rebuild and reflash, and the Makefile pins PKG_VERSION 3.1.2 with PKG_RELEASE 20261102, so a version bump means editing the package or pulling a newer tree. If you installed a release package, v3.1.0 or later can upgrade through Theme updates under System → Argon Config, which installs with the firmware's native APK or OPKG, preserves Argon configuration and does not perform downgrades; users on v3.0.0 or earlier must install v3.1.2 manually once.
The licence is Apache-2.0 (the Makefile's PKG_LICENSE field lists Apache-2.0 MIT), stated in the LICENSE file and in the Makefile header, which reads "This is free software, licensed under the Apache License, Version 2.0 ." Apache-2.0 permits commercial use and modification and includes a patent grant, with the usual conditions around preserving notices and stating changes. It is a permissive licence, not a copyleft one, so redistributing a modified Argon inside a firmware image does not oblige you to publish the rest of the image. This is a description of the licence text, not legal advice; read LICENSE and, for a commercial product, involve counsel.
Editorial conclusion
Adopt Argon if you run an OpenWrt build and want a lighter admin interface with dark mode and a custom login background; the README gives both opkg and apk paths, so check which package manager your build uses before downloading. Skip it if your firmware uses APK v2, which cannot read the APK packages, or if you need a theme with a documented rollback procedure, because the README does not describe one. Verify first that your build's package manager matches the release artifacts you fetch; configuration is built into luci-theme-argon under System → Argon Config.
Frequently asked questions
How do I install luci-theme-argon on OpenWrt?
Download the luci-theme-argon package matching your firmware's native package manager from Releases; fresh installs need only this package. Run opkg update or apk update first, then opkg install ./luci-theme-argon_*.ipk or, on APK v3, apk add --allow-untrusted ./luci-theme-argon-*.apk.
What is LuCI on OpenWrt?
LuCI is the web interface that ships with OpenWrt, and it is themeable. Argon is one such theme, described in its README as a clean and tidy OpenWrt LuCI theme.
Is luci-theme-argon the best LuCI theme for OpenWrt?
The repository makes no such claim and does not compare itself with other themes. What it does state is its own feature set: desktop and mobile layouts, automatic or manual light and dark switching, customizable accent colors and adjustable login glass effects, and login backgrounds using local images, videos or online wallpapers.
How do I change the theme in OpenWrt after installing luci-theme-argon?
Select Argon under System → System → Language and Style → Design. Theme options such as login layouts, colors and wallpapers are under System → Argon Config.
Official sources
Add this badge to your README
If you maintain this project, the badge below links readers to this analysis and shows its maintenance status from the daily GitHub snapshot. Paste the markdown into your README; add ?metric=license or ?metric=stars to the image URL for a different field.
[](https://hysenlabs.com/projects/jerrykuku-luci-theme-argon)Star history chart for your README
[](https://hysenlabs.com/projects/jerrykuku-luci-theme-argon)Was this useful?