gitmyhub

openwrt-theme-foxhound

Lua ★ 17 updated 2d ago

Foxhound is a fast and clean modern theme for openwrt

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.

LuaCSSLuCIOpenWrtsetup: moderatecomplexity 3/5

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.

Where it fits