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.
English · 简体中文
- Online theme updates. Check stable releases and install with the firmware's native APK or OPKG, preserving Argon settings and verifying package SHA256 and size.
- Layout fixes. Improve dashboard actions, overview layouts, dynamic lists and custom IP/MAC inputs across narrow screens, light/dark modes and RTL layouts.
- Compatibility improvements. Improve compatibility with stable OpenWrt firmware.
Users on v3.0.0 or earlier must install v3.1.0 manually once to get online updates. See the release notes.
- Built-in Argon Config. Manage the theme without a separate plugin.
- Broad third-party app support. Refined layouts, forms and tables for most third-party LuCI apps, with desktop/mobile and light/dark adaptations.
- Two login layouts. Choose the classic sidebar or centered card.
- Light and dark. Switch from the header or follow your system, with customizable accent colors.
- Your own look. Adjust login glass effects, set image or video backgrounds, and upload a browser icon and login logo.
- Desktop and mobile. Responsive layouts across screen sizes.
In 3.0, the theme and configuration features are one package: luci-theme-argon. Fresh installations need only this package. Download the format matching your firmware's native package manager from Releases. If the old standalone configuration plugin is installed, follow the migration steps below first.
| Package manager | Package | Install |
|---|---|---|
opkg |
.ipk |
opkg install ./luci-theme-argon_*.ipk |
APK v3 (apk-tools 3.x) |
.apk |
apk add --allow-untrusted ./luci-theme-argon-*.apk |
Run opkg update or apk update first. APK v2 cannot read these APK packages; keep your firmware's native package manager.
For translations, install the matching luci-i18n-argon-config-<language> package from the same release and in the same format.
Select Argon under System → System → Language and Style → Design.
Already have the old luci-app-argon-config? Migrate to 3.0
This applies only when the old standalone configuration plugin is installed. Otherwise, skip this section.
The settings page, colors, backgrounds and branding are all included in the theme. The release's luci-app-argon-config is an empty migration package using the old package name. It preserves existing settings and hands its files over to the theme.
- Download both
luci-app-argon-configandluci-theme-argonfrom the same 3.0 release in the theme repository, in the same format. - Put both files in one directory on the router and open a terminal there. Do not uninstall the old plugin first. Choose the command pair for your firmware; run the second command only after the first succeeds.
# opkg
opkg install ./luci-app-argon-config_*.ipk
opkg install ./luci-theme-argon_*.ipk
# APK v3
apk add --allow-untrusted ./luci-app-argon-config-*.apk
apk add --allow-untrusted ./luci-theme-argon-*.apkThe first command replaces the old plugin with the empty migration package. The second installs the integrated theme and restores your settings. Continue configuring it under System → Argon Config.
Open System → Argon Config for login layouts, colors, glass effects, wallpapers and branding. The header's appearance button switches between Light mode, Dark mode and Follow system; the choice also applies to the login page.
Local image and video backgrounds are supported, along with Bing, Unsplash and Wallhaven wallpapers. Unsplash requires an API access key. Browser icons and login logos accept PNG files, 16–1024 pixels per side, up to 1 MiB; browser icons must be square.
Under Theme updates, check the latest stable release, read its release notes and download the package matching your firmware's package manager.
When a newer version is available, choose Update now and confirm to install the theme using the firmware’s native APK or OPKG package manager, preserving your Argon configuration. The page shows download, verification and installation status plus installation logs, and resumes monitoring after a page refresh. Reload the page after installation. Automatic installation requires a matching release package and SHA256 digest and does not perform downgrades. It updates the main theme package; separate translation packages remain managed by the system package manager.
When building firmware, stop including the old standalone luci-app-argon-config plugin alongside the theme: its files conflict with the integrated settings. See Build with OpenWrt for existing build scripts.
Light and dark views of the overview and both login layouts, on desktop and mobile.
Made with contrib.rocks.
See the development guide for source builds, LESS, templates, icons and checks.
Releases · Version history · Contributors · Report an issue
Licensed under Apache-2.0. Thanks to luci-theme-material.