luci-theme-argon

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.

4,411

834

4,411

100

View on GitHub

Top Related Projects

luci

6,705

LuCI - OpenWrt Configuration Interface

Quick Overview

Luci-theme-argon is a clean and modern OpenWrt theme for the LuCI web interface. It provides a sleek, responsive design that enhances the user experience for managing OpenWrt-based routers and network devices.

Pros

Elegant and user-friendly interface
Responsive design, suitable for both desktop and mobile devices
Customizable color schemes and background images
Regular updates and active community support

Cons

May require additional setup steps compared to default themes
Some users report occasional compatibility issues with certain OpenWrt versions
Limited documentation for advanced customization

Getting Started

To install the Argon theme on your OpenWrt device:

Connect to your OpenWrt device via SSH
Run the following commands:

opkg update
opkg install luci-theme-argon

Navigate to System > System Properties in the LuCI web interface
Select "Argon" as the default theme
Save and apply the changes
Refresh your browser to see the new theme

For manual installation or development purposes, clone the repository:

git clone https://github.com/jerrykuku/luci-theme-argon.git
cd luci-theme-argon

Refer to the project's README for more detailed instructions on manual installation and customization options.

Competitor Comparisons

luci

6,705

LuCI - OpenWrt Configuration Interface

Pros of luci

Core component of OpenWrt, providing a stable and well-maintained web interface
Extensive documentation and community support
Supports a wide range of OpenWrt features and configurations

Cons of luci

Default theme may appear outdated or less visually appealing
Less focus on modern design elements and user experience
Limited customization options without additional themes or modifications

Code comparison

luci-theme-argon:

local sys  = require "luci.sys"
local util = require "luci.util"
local http = require "luci.http"
local disp = require "luci.dispatcher"

local function is_mac(mac)
    return (mac and type(mac) == "string" and #mac == 17) or false
end

luci:

local sys = require "luci.sys"
local fs = require "nixio.fs"

function fork_exec(command)
    local pid = nixio.fork()
    if pid > 0 then
        return
    elseif pid == 0 then
        -- change to root dir
        nixio.chdir("/")

The luci-theme-argon repository focuses on providing a modern and visually appealing theme for the LuCI web interface, while the luci repository contains the core components of the OpenWrt web interface. The code snippets show different aspects of functionality, with luci-theme-argon handling MAC address validation and luci demonstrating process forking and execution.

Convert designs to code with AI

Introducing Visual Copilot: A new AI model to turn Figma designs to high quality code using your components.

Try Visual Copilot

README

A brand new OpenWrt LuCI theme

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 | ç®ä½ä¸æ

Key Features â¢ Branch â¢ Version History â¢ Getting started â¢ Screenshots â¢ Contributors â¢ Credits

Key Features

Clean Layout.
Adapted to mobile display.
Customizable theme colors.
Support for using Bing images as login background.
Support for custom uploading of images or videos as login background.
Automatically switch between light and dark modes with the system, and can also be set to a fixed mode.
Settings plugin with extensions luci-app-argon-config

**Upcoming Version **

"The current theme uses Less for CSS construction, and the method for switching between light and dark modes is relatively primitive. Meanwhile, the official theme has already switched to the UT template. I am exploring a way to build the theme template using modern front-end development tools, initially settling on a solution using Vite + UnoCSS. This approach will utilize a proxy server for debugging and also support HMR (Hot Module Replacement), significantly improving development speed. Currently, the basic development framework has been set up, but due to a busy schedule, I still need some time to migrate the existing styles. Stay tuned!"

Branch Introduction

There are currently two main branches that are adapted to different versions of the OpenWrt source code.
The table below will provide a detailed introduction:

Branch	Version	Description	Matching source
master	v2.x.x	Support the latest version of LuCI	Official OpenWrt â¢ ImmortalWrt
18.06 (deprecated)	v1.x.x	Support the 18.06 version of LuCI	Lean's LEDE

Version History

The latest version is v2.3.1 Click here to view the full version history record.

Getting started

Build for Lean's LEDE project (deprecated)

cd lede/package/lean
rm -rf luci-theme-argon
git clone -b 18.06 https://github.com/jerrykuku/luci-theme-argon.git luci-theme-argon
make menuconfig #choose LUCI->Theme->Luci-theme-argon
make -j1 V=s

Build for OpenWrt official SnapShots and ImmortalWrt

cd openwrt/package
git clone https://github.com/jerrykuku/luci-theme-argon.git
make menuconfig #choose LUCI->Theme->Luci-theme-argon
make -j1 V=s

Install for LuCI 18.06 ( Lean's LEDE )

wget --no-check-certificate https://github.com/jerrykuku/luci-theme-argon/releases/download/v1.8.2/luci-theme-argon_1.8.2-20230609_all.ipk
opkg install luci-theme-argon*.ipk

Install for OpenWrt official SnapShots and ImmortalWrt

opkg install luci-compat
opkg install luci-lib-ipkg
wget --no-check-certificate https://github.com/jerrykuku/luci-theme-argon/releases/download/v2.3.2/luci-theme-argon_2.3.2-r20250207_all.ipk
opkg install luci-theme-argon*.ipk

Install luci-app-argon-config

wget --no-check-certificate https://github.com/jerrykuku/luci-app-argon-config/releases/download/v0.9/luci-app-argon-config_0.9_all.ipk
opkg install luci-app-argon-config*.ipk

Notice

Chrome browser is highly recommended. There are some new css3 features used in this theme, currently only Chrome has the best compatibility.
Microsoft has officially retired Internet Explorer, RIP IEð~~Currently, the mainline version of the IE series has bugs that need to be addressed.~~
FireFox does not enable the backdrop-filter by default, see here for the opening method.

Screenshots

desktop mobile

Contributors

Made with contrib.rocks.

Related Projects

luci-app-argon-config: Argon theme config plugin
openwrt-package: My OpenWrt package
CasaOS: A simple, easy-to-use, elegant open-source Personal Cloud system (My current main project)

Credits

luci-theme-material

Top Related Projects

luci

6,705

LuCI - OpenWrt Configuration Interface

Convert designs to code with AI

Introducing Visual Copilot: A new AI model to turn Figma designs to high quality code using your components.

Try Visual Copilot