Machinon Theme: Difference between revisions
m →Update |
No edit summary |
||
| (2 intermediate revisions by the same user not shown) | |||
| Line 1: | Line 1: | ||
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:''' [https://domoticz.github.io/Machinon/ 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== | ==Install== | ||
===Option 1: dist branch (recommended)=== | |||
The leanest install: just the built theme, no source files. | |||
<pre>cd domoticz/www/styles | |||
git clone -b dist --single-branch https://github.com/domoticz/Machinon.git machinon</pre> | |||
To update later, run <code>git pull</code> inside the <code>machinon</code> folder. | |||
===Option 2: release zip=== | |||
Download <code>machinon-<version>.zip</code> from the [https://github.com/domoticz/Machinon/releases releases page] and unzip it into <code>domoticz/www/styles/</code>. The zip already contains a <code>machinon/</code> folder, so you do not need to create one. | |||
===Option 3: Theme Manager plugin=== | |||
The [https://github.com/galadril/domoticz-theme-manager 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)=== | ||
<pre>cd domoticz/www/styles | |||
git clone https://github.com/domoticz/Machinon.git machinon</pre> | |||
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== | |||
# In Domoticz, go to '''Setup > Settings''' and open the '''System''' tab. | |||
# Under '''User Interface''', pick <code>machinon</code> from the '''Theme''' dropdown. | |||
# 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.''' | |||
# 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 <code>git pull</code> inside a pre-2.0 clone will fail because the histories no longer share a common base. | |||
Delete the old <code>machinon</code> 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|800px]] | |||
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 [https://domoticz.github.io/Machinon/docs/settings-reference/ 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|800px]] | |||
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|800px]] | ||
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 [https://domoticz.github.io/Machinon/docs/troubleshooting-and-faq/ troubleshooting page] covers the common symptoms. | |||
==Links== | ==Links== | ||
* [https://domoticz.github.io/Machinon/ Website, with the live scheme preview] | |||
* [https://domoticz.github.io/Machinon/docs/ Full manual] | |||
* [https://github.com/domoticz/Machinon Repository on GitHub] | |||
* [https://github.com/domoticz/Machinon/releases Releases and changelog] | |||
* [https://github.com/domoticz/Machinon/issues/new/choose Report a bug, request a feature, or request an icon] | |||
* [https://forum.domoticz.com/viewtopic.php?t=45132 Forum thread]] | |||
==Credits== | |||
Machinon was originally created by EdddieN and is now maintained by the Domoticz community. Icons by [https://icons8.com Icons8]. Licensed under the GPL v3. | |||
[[Category: Theme]] | |||
Latest revision as of 12:47, 16 August 2026
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
- In Domoticz, go to Setup > Settings and open the System tab.
- Under User Interface, pick
machinonfrom the Theme dropdown. - 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.
- 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.
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.
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.