Houdini 22.0 Reference Windows

Theme Editor

The theme editor lets you change the color scheme of Houdini’s user interface. You can choose from a variety of preset themes, or create your own.

On this page

How to

To...Do this

Open the theme editor

In the main menus, choose Edit ▸ Color Theme.

Choose a preset theme

  • Click the name of preset in the preset list.

    The theme editor window changes to use that theme.

  • You can click Preview at the bottom of the window to temporarily switch the rest of Houdini to use the selected theme.

  • To save the selected theme as the new application theme, click Accept.

Create your own theme preset

  1. Select the theme you want to base your theme on.

  2. Click the Swatches or Sliders tab to show the full editor.

  3. Click the theme’s menu button (to the right of the theme name in the theme list) and choose Duplicate as.

  4. Enter the Name and Category of your new theme, then click Accept.

Edit a theme

See editing a theme below.

Use the current colors as the application theme

Click Accept in the bottom right corner of the window.

Cancel any changes and revert to the old theme

Click the theme editor window’s close button.

Change a theme’s name or category

Click the theme’s menu button (to the right of the theme name in the theme list) and choose Edit Info.

Tip

If a theme is read-only (the name is displayed in italics), you can’t edit it. You can create a new copy of the theme using Duplicate As and then change the name of the copy.

Make a random theme

Click the Random button in the bottom left corner of the window.

The first time you click the Random button it creates a new theme from the random colors. If the current theme was created by the Random button, clicking it again overwrites the theme with the new randomized values.

You can hold the button down to cycle through random themes. You can use Undo if you want to go back to a previous set of colors.

Delete a theme preset

  1. Click the theme in the preset list.

  2. Click the theme’s menu button (to the right of the theme name in the theme list) and choose Delete.

    or

    Press the Delete key.

Note

You cannot delete the “factory” presets shipped with Houdini in $HFS.

Presets

  • Presets from outside your user preferences directory (for example, the “factory” presets that ship with Houdini in $HFS) are “read only”. Their names are displayed in italics. They cannot be deleted, and if you try to edit one, Houdini will create a new temporary theme with your edits.

  • You can click a theme’s menu button (to the right of the theme name in the theme list). You can also right-click a theme to get the same menu.

  • Houdini sometimes creates “temporary” themes:

    • If you try to edit a read-only theme, Houdini creates a new theme with your edits.

    • If the saved theme doesn’t match any known themes.

      This can happen if you clicked Accept with an edited theme, but didn’t save your changes first. Or, if you set one of your themes as the application theme, then delete the theme. In these cases the temporary theme is named Untitled Theme.

    • The Random button generates a random theme in a new temporary preset, unless the currently selected theme was generated from the Random button.

    To save a temporary theme, click the theme’s menu button (to the right of the theme name in the theme list) and choose Save As. (If you are on one of the tabs other than Presets so the window is wide, you can also click the Save As button at the bottom of the window.)

  • Themes with unsaved changes and temporary themes have a bullet (•) next to their names in the theme list.

  • Houdini stores the files corresponding to your user themes in $HOUDINI_USER_PREF_DIR/config/Themes. To show the file for a theme, click the theme’s menu button (to the right of the theme name in the theme list) and choose Reveal File.

== Editing a theme === (edit)

  • Click the Swatches or Sliders tab to show the full editor.

    • The Swatches interface is a quick way to select colors by choosing from a curated palette.

    • The Sliders interface gives full control over

  • Use the controls on the right side to edit the base, accent, and highlight colors.

  • To revert to the most recently saved version of the current theme, click the Revert button at the bottom of the window.

  • To save the current settings to the selected theme, click the Save button at the bottom of the window.

  • If the selected preset is read-only, Houdini will create a new preset entry to save into.

Base, accent, and highlight colors

Houdini derives the full palette of user interface colors from three main colors you choose. It applies various heuristic rules when deriving to maintain contrast and readability.

Basically, you set the main colors to influence the overall look of the theme. Because most interface colors are derived from one of the main colors, or combinations of main colors, you may not see the unaltered main colors in many places.

The three main colors are:

Base

The background color. Houdini derives different background color variations from this color. The plain text color is derived from this color with a contrasting lightness.

Some derived colors use the hue and saturation of the Accent or Highlight colors, but the lightness of the Base color, to created a tinted background color for use behind text.

Accent

The color of buttons and various other user interface elements. Houdini uses this color for colorful parts of user interface icons (not node icons) by default.

Buttons marked as “primary” in the user interface use the unmodified Accent color (unless that wouldn’t be visible against the background). Other buttons use a color derived from the accent hue, the base lightness, and secondary chroma.

Highlight

The color of selected/current items. The text selection background uses the unmodified Highlight color. Selections in list and table views use a derived color the mixes the Highlight hue with the Base lightness and chroma, since the Highlight color is usually bright and colorful, which might be too much for a whole selected row.

The controls on the Tweaks tab let you change which color is used for some interface elements, such as checkboxes and selected tabs.

Note

Using light themes (themes with background lightness greater than or equal to 60) is currently experimental. We have not tested the heuristics for deriving colors in light themes nearly as much as for dark themes.

Increasing or decreasing contrast

On a television, the “contrast” control moves all colors toward or away from neutral gray. However, for themes, “contrast” only controls the contrast level of colors derived from the main colors. It does not affect the main colors.

Global Contrast

This is the same as the Global UI Contrast in the preferences. It is a global contrast for all themes, applied on top of any contrast in the current theme.

Individual themes have their own Theme contrast control on the tweaks tab. The global scale is applied on top of the theme scale. This can be useful if you want a certain theme to have lower or higher contrast than other themes.

You can also increase or decrease the contrast of text separately on the tweaks tab.

Swatches

  • For each of Base, Accent, and Highlight, click a hue circle, then click a swatch from a grid where the columns have different lightness and the rows have different chroma.

  • You can click the color swatch on the right to choose the color using Houdini’s standard color editor.

Sliders

  • Click in the color circle to set the hue and chroma, or edit the values using the sliders.

  • You can click the color swatch on the right to choose the color using Houdini’s standard color editor.

  • The theme editor uses a color model based on OkLCH. It is designed to account for perceptual color differences, so colors with the same Lightness value should have the same apparent brightness to the human eye. This system is not perfect but provides much better results than non-perceptual models such as HSV.

Tweaks

Theme contrast

This controls the contrast of colors derived from the main theme colors. It does not change the three main colors themselves.

Secondary chroma

Buttons and some other elements use a desaturated version of the accent color. This controls how colorful these elements are.

This is a scale on the chroma value of the accent color. A value of 0.0 is gray, a value of 1.0 is the same as the accent color. The default value is 0.2.

Text contrast

Increases or decreases the brightness difference between background and text.

Button brightness

Increases or decreases the brightness difference between background and normal buttons.

Field brightness

Increases or decreases the brightness difference between background and text fields.

Pane dividers

Increases or decreases the brightness difference between the background color and the dividers between panes in the pane layout.

Pressed Tabs/Buttons

Whether the color of selected tabs and pressed buttons is derived from the accent color or the highlight color.

Checked Toggles

Whether the color of “checked” checkboxes, switches, and radio buttons is derived from the accent color or the highlight color.

Invert Checked Toggles

Normally, Houdini uses the Check Toggles color for checkmarks, radio dots, and switch handles, then derives a contrasting background color. When this is on, the background uses the selected color instead, and Houdini derives a contrasting foreground color.

Unchecked Toggles

Whether checkbox and switch backgrounds use the button color or the field color. This could make a difference if you've tweaked the field or button brightness sliders signficantly.

Icon Tint Scale

Houdini tints user interface icons (not node icons) using the base color, with the colorfulness scaled by this value. The default value is 0.2. If the base color is gray, this has no effect.

Icon Accent Scale

Houdini recolors the colorful parts of user interface icons (not node icons) using the accent color (by default, see Icon use below), with the colorfulness scaled by this value. The default value is 0.5.

Icons Use

Whether to recolor the colorful parts of user interface icons using the accent color, the highlight color, or a custom color.

Windows