jerrykuku/luci-theme-argon

[license]: /LICENSE [license-badge]: https://img.shields.io/github/license/jerrykuku/luci-theme-argon?style=flat-square&a=1 [prs]: https://github.com/jerrykuku/luci-theme-argon/pulls [prs-badge]: https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=flat-square [issues]: https://github.com/jerrykuku/luci-theme-argon/issues/new [issues-badge]: https://img.shields.io/badge/Issues-welcome-brightgreen.svg?style=flat-square [release]: https://github.com/jerrykuku/luci-theme-argon/releases [release-badge]: https://img.shields.io/github/v/release/jerrykuku/luci-theme-argon?style=flat-square [download]: https://github.com/jerrykuku/luci-theme-argon/releases [download-badge]: https://img.shields.io/github/downloads/jerrykuku/luci-theme-argon/total?style=flat-square [contact]: https://t.me/jerryk6 [contact-badge]: https://img.shields.io/badge/Contact-telegram-blue?style=flat-square

A brand new OpenWrt LuCI theme · v3

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.

[![license][license-badge]][license] [![prs][prs-badge]][prs] [![issues][issues-badge]][issues] [![release][release-badge]][release] [![download][download-badge]][download] [![contact][contact-badge]][contact]

English · 简体中文

Watch the desktop demo · MP4

What's new in 3.1

• 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.

3.0 highlights

• 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.

Install

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- package from the same release and in the same format.

Select Argon under System → System → Language and Style → Design.

# 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-*.apk

Customize

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.

Screenshots

Light and dark views of the overview and both login layouts, on desktop and mobile.

Contributors

Made with contrib.rocks.

Development

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.