Machinon Theme

Machinon is a modern, responsive theme for Domoticz. It replaces the default interface with a clean, card-based layout: matching light and dark modes, a choice of color schemes, a refreshed icon set, and one settings page inside Domoticz where you control all of it.

Originally created by EdddieN in 2018, Machinon was rebuilt from the inside out for the 2.0 release and is now maintained by the Domoticz community in the official repository.

Website and full manual: domoticz.github.io/Machinon

The website has a live color scheme preview: pick any of the eight schemes and the page repaints itself, using the theme's own design tokens and real device cards, so you can see exactly what a scheme looks like before installing anything.

Requirements

• Domoticz 2025.2 or newer. The latest beta is recommended, as the theme is developed against it.
• A browser you can hard-refresh (Ctrl+Shift+R) after installing or updating.

No Domoticz restart is needed at any point.

Install

Option 1: dist branch (recommended)

The leanest install: just the built theme, no source files.

cd domoticz/www/styles
git clone -b dist --single-branch https://github.com/domoticz/Machinon.git machinon

To update later, run git pull inside the machinon folder.

Option 2: release zip

Download machinon-<version>.zip from the releases page and unzip it into domoticz/www/styles/. The zip already contains a machinon/ folder, so you do not need to create one.

Option 3: Theme Manager plugin

The Theme Manager plugin can install Machinon for you. It installs the full source repository rather than the lean dist build, so Option 1 loads faster if you do not need the plugin for other themes.

Option 4: full source (developers)

cd domoticz/www/styles
git clone https://github.com/domoticz/Machinon.git machinon

The source loads around 27 separate CSS files rather than one flattened file. That is fine for development, but slower for everyday use.

Activating the theme

1. In Domoticz, go to Setup > Settings and open the System tab.
2. Under User Interface, pick machinon from the Theme dropdown.
3. Click Apply Settings. On a desktop screen this button is at the top right, next to the row of tabs; on a phone it is a bar fixed to the bottom of the screen. The choice only persists once you click it.
4. Hard-refresh your browser with Ctrl+Shift+R, so it picks up the new files instead of the cached old ones.

Upgrading from an older Machinon

The repository history was rewritten for the 2.0 release, so git pull inside a pre-2.0 clone will fail because the histories no longer share a common base.

Delete the old machinon folder and reinstall using any option above. Theme Manager installs are git clones underneath and break the same way, so remove and re-add through Theme Manager.

Nothing needs migrating. All of your theme settings live in Domoticz itself and in your browser, not in the theme folder, so a clean reinstall picks them up automatically.

The Theme Hub

Every theme setting lives on one page inside Domoticz, reachable from the Setup menu once Machinon is active. It replaces the old per-setting Theme page.

File:Machinon-theme-hub.png

Settings are organized into nine groups: General, Menus and navbar, Dashboard, Device cards, Charts and log, Background and branding, Colors and schemes, Icon packs, and About. Many rows carry a live preview showing what the setting changes.

On an installation with separate logins, the Setup menu is only shown to admin users. Non-admin logins reach the Theme Hub from the dropdown that replaces Setup for them, labeled Other on the current beta and Profile on the 2025.2 stable release. Nobody is locked out of their own theme settings.

Every setting is documented individually in the settings reference.

Color schemes

Eight schemes ship with the theme: Machinon Light and Machinon Dark are the defaults, and Gruvbox, Magenta and Paper each come in a light and a dark variant. Pick one under Colors and schemes in the Theme Hub.

File:Machinon-scheme-magenta.png

You can also design your own palette with the custom color picker and save it as a preset. Every shipped scheme holds body text against its background at WCAG AA or better; custom colors are contrast-checked when you save them and warn you rather than failing silently.

Icon packs

Despite the name, this is not one all-or-nothing set you switch on. It is a browsable library of 267 icons in three styles (Blue UI, Color and Fun), each drawn for both its on state and its off state, and you install the ones you want onto individual devices.

File:Machinon-icon-packs.png

Installed icons are written into Domoticz's own custom-image database rather than into theme settings, so they stay in place if you switch themes and everyone using that installation sees them.

Missing an icon? There is a dedicated request form in the repository. The pack is built from Icons8 artwork in the Blue UI and Office M styles, so a request that links an icon already available in one of those styles can usually go straight in.

Bar ranges

Bar ranges turn a utility device's number into something readable at a glance: you define value bands with a color each, for example green up to 800 watts, amber to 2000, red above, and the interface shows the current value as a marker on a colored strip.

Domoticz shows these strips on the device's card on the Utility page and in Dynamic Dashboard stat widgets. Machinon adds a third place: the same bands painted across the charts on the device's Log page, so history gets the same at-a-glance reading as the live value.

Mobile layouts

Dashboards, menus and dialogs adapt to small screens rather than shrinking the desktop layout. Domoticz also switches to its compact dashboard automatically on a phone, listing your favorite devices as rows with their controls beside them.

Something not working?

Most problems after updating Domoticz or the theme are browser caching. Try a hard refresh (Ctrl+Shift+R), or open the site in a private window to check whether caching is the cause.

If the theme is selected but nothing changed, check that you clicked Apply Settings and then hard-refreshed. The troubleshooting page covers the common symptoms.

Links

• Website, with the live scheme preview
• Full manual
• Repository on GitHub
• Releases and changelog
• Report a bug, request a feature, or request an icon
• Forum thread]

Credits

Machinon was originally created by EdddieN and is now maintained by the Domoticz community. Icons by Icons8. Licensed under the GPL v3.