id       = "houdini"
name     = "Houdini"
homepage = "https://www.sidefx.com/products/houdini/"
description = "Houdini has a wide range of content creation tools that meet the needs of artists creating Film, TV, Gamedev and more."
icon     = "SimpleIcons:houdini"

# Every name here comes from SideFX's own documentation. `hconfig` is in
# https://www.sidefx.com/docs/houdini/basics/config.html ("run the hconfig -ap
# command" to print the current path assignments); `hython` is in
# https://www.sidefx.com/docs/houdini/hom/commandline.html ("a Python shell that
# ships with Houdini"); `hrender` and `hscript` are two of the stand-alone
# utilities in $HFS/bin listed at
# https://www.sidefx.com/docs/houdini/ref/utils/. The GUI's own launcher is not
# listed: that page enumerates the $HFS/bin utilities and does not name it, and
# guessing a binary name is not what this field is for.
executables   = ["hython", "hconfig", "hrender", "hscript"]

[dotfiles]

# https://www.sidefx.com/docs/houdini/ref/env.html on HOUDINI_USER_PREF_DIR: the
# default is "$HOME/houdini__HVER__" on Windows and Linux, with __HVER__
# replaced by the MAJOR.MINOR version at runtime, and on macOS
# "$HOME/Library/Preferences/houdini/__HVER__" when that directory exists,
# falling back to the same $HOME/houdini__HVER__ otherwise. Both are real
# locations rather than two names for one place, so both are listed and a
# consumer skips the one that is absent; the version is part of the directory
# name, hence the glob. [preferences] is ~/Library/Preferences and is macOS-only,
# which is exactly the platform that spelling belongs to.
#
# https://www.sidefx.com/docs/houdini/basics/config.html names what lives there:
# houdini.env, the environment file Houdini reads on startup (and which
# HOUDINI_NO_ENV_FILE disables), and $HOME/houdini‹X›.‹Y›/.palette for the
# colour palette.
paths = [
  "[preferences]/houdini/*/",
  "~/houdini*/",
]

secret  = []

# No machine_lines: houdini.env is a list of `NAME = value` assignments and some
# of them (HOUDINI_PATH, HOUDINI_OTLSCAN_PATH) do hold absolute paths into one
# machine's disk, but which of a studio's variables are machine-local is a
# per-site question this catalog cannot answer, so no rule is invented here.