explaingit

fullband7/openwrt-theme-foxhound

16LuaAudience · ops devopsComplexity · 3/5Setup · moderate

TLDR

FoxHound is a dark, modern visual theme for the LuCI web control panel on OpenWrt routers. It replaces the default look with a responsive, customizable dashboard skin built with CSS variables.

Mindmap

mindmap
  root((openwrt-theme-foxhound))
    What it does
      Dark dashboard theme
      Replaces LuCI styling
      PassWall2 support
    Tech stack
      Lua
      CSS variables
      LuCI framework
    Customization
      palette.css file
      Logo swapping
      Login background
    Use cases
      Home router UI
      Mobile access
      VPN proxy pages
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Things people build with this

USE CASE 1

Give your OpenWrt router control panel a dark modern look instead of the default LuCI theme.

USE CASE 2

Make router settings usable on a phone with a collapsible sidebar and touch-friendly buttons.

USE CASE 3

Style PassWall2 VPN proxy pages to match the rest of the router dashboard automatically.

USE CASE 4

Customize colors, borders, and spacing across the entire interface by editing one palette.css file.

Tech stack

LuaCSSLuCIOpenWrt

Getting it running

Difficulty · moderate Time to first run · 30min

Requires an OpenWrt router with LuCI installed, some styling differences may appear depending on router hardware.

No license is mentioned in the project description.

In plain English

FoxHound is a visual theme for OpenWrt routers. OpenWrt is open-source firmware that replaces the built-in software on many home and small-office routers, and it includes a web-based control panel called LuCI where you configure your network settings. FoxHound replaces the default appearance of that control panel with a darker, more modern look. The theme is described as a complete rewrite of the default styling. It uses current CSS techniques to update all the standard UI elements: buttons, tables, dropdown menus, and progress bars. The result is a professional dark dashboard with the same underlying LuCI functionality intact. Screenshots in the README show a dark interface with clean typography and organized layout panels. Mobile support is a stated priority. The theme includes a separate stylesheet for responsive layouts, larger touch-friendly buttons, and a collapsible sidebar. The author reports testing on iOS and Android across screen sizes down to 320 pixels wide. There is also specific support for a plugin called PassWall2, which controls VPN and proxy settings on OpenWrt routers. FoxHound detects PassWall2 pages automatically and applies consistent styling so its forms and tables match the rest of the theme. Customization is handled through CSS variables collected in a single file called palette.css. You can change the main colors, border radius, shadows, and spacing by editing one file rather than hunting through many. Swapping the logo is also supported, either by editing a template file or by replacing an SVG file directly. The login page background image can be changed through a CSS variable as well. The README includes a note from the author saying the project was built for personal use and may not work the same way on all router hardware, and that some color bugs may exist. It is an open contribution project, though, with a fork-and-pull-request workflow described for anyone who wants to improve it.

Copy-paste prompts

Prompt 1
How do I install FoxHound on my OpenWrt router and which files do I copy to the LuCI theme directory?
Prompt 2
I want to change FoxHound's accent color to blue. Which variable in palette.css controls the main highlight color?
Prompt 3
FoxHound's sidebar won't collapse on my phone. How do I debug the responsive stylesheet for mobile layouts?
Prompt 4
How do I replace the FoxHound logo with my own SVG file in the LuCI theme?
Prompt 5
FoxHound's PassWall2 styles look broken on my router. How do I check if PassWall2 detection is working?
Open on GitHub → Explain another repo

← fullband7 on gitmyhub — every repo by this author, as a profile.

Verify against the repo before relying on details.