Docs Interface
SearchPalette
Search field for TouchDesigner's palette browser, installed into the palette on startup. Based on Yea Chen's TD-SearchPalette.
▦ Interface
Shortcuts
Global: they fire anywhere in TouchDesigner. Shortcuts scoped to a single panel are a local control scheme and stay off this list.
- Ctrl+Shift+F
TDX_SearchPalette
Adds a search field to TouchDesigner's palette browser, so palette components can be found by typing their name. It is based on Yea Chen's TD-SearchPalette.
The component installs itself into the palette on project start while Auto Install is on (the toggle roams with your config), and can be installed or removed at any time with the Install / Uninstall pulses on its parameters.
Search hotkey
ctrl+shift+f (cmd+shift+f on macOS) brings TD's own palette tab to the
front and focuses the search field, ready to type.
It acts on the palette in place. ui.openPaletteBrowser() would pop the
palette out into a floating window, so the hotkey deliberately leaves it
uncalled: if the browser is closed, the hotkey does nothing and starts no
rearranging of your workspace.
The tab step matters because the search field lives inside the stock palette list, and any contributed tab hides that list. The hotkey asks whichever palette-tab owner is installed to show TD's own tab again (PaletteRegistry and TDXLU's own injector are both feature-detected, neither required), then takes focus one frame later, because a tab switched back this frame is still hidden.
Rebindable. The combo lives on this package's own Search Hotkey
parameter, so it is listed under TDX_SearchPalette in HotkeyManager and can
be changed there or on the parameter directly; Reset to Default restores
ctrl+shift+f. It used to live in MY_HOTKEYS; keeping it with the tool that
owns the field means uninstalling this package takes its hotkey with it.
Editing the search text
The search field is a Text COMP, so it edits the way TouchDesigner's own text
fields do, including ctrl+left / ctrl+right to jump by word. It replaced
the legacy Field COMP, which TouchDesigner deprecated in 2022.24200 and which
had no word navigation.
Search behavior
Matching goes beyond the original module's prefix search:
- Substring, case-insensitive:
blurfindshsvBlur,radialBlurandbarrel_blur, as well as names that start with it. - Multiple words AND together:
audio anfindsaudioAnalysis. - Ranked results: an exact match first, then names starting with the
query, then names where it starts a word (
blurputshsvBlurandbarrel_bluraboveunblurred), then the rest, alphabetical within each group. - Wildcards still work: a word carrying
*or?is matched as a pattern, anchored at the front only, so a wildcard can only ever widen the search:audio*is still classic prefix search,*feefindsfeedbackGenjust like plainfeedoes, andweb*serfindswebBrowser. - Exclude with
-: a word prefixed with a minus removes matches:blur -barrelfinds every blur except thebarrel_blurpair. - Fuzzy fallback: when nothing matches literally, each word is
re-read more loosely, best reading first: a spelling either side of the
Atlantic (
randomisefindsrandomize,colourfindscolor), initials (mfofindsmovieFileOut), a typo of a word or its start (nosiefindsnoise,kinnectfindskinectAzure; one slip for words of four to seven letters, two from eight), and last a subsequence, sofbgfindsfeedbackGenandwbrsrfindswebBrowser. These only ever appear when the strict search came up empty, and they never reorder it. - Folder search: a word containing
/matches the palette folder instead of the name:gen/ noisefindsnoisein the Generators folder, andtools/alone lists a whole folder. Toggleable via the Folder Search parameter. - Latest version only: numbered copies of one component (
tool,tool1,tool2, or the same name in two folders) collapse to the latest-modified file. Toggleable via the Latest Version Only parameter.
The list stops at 200 rows, so a one-character query returns the 200 best-ranked components only.
Clicking a folder in the tree clears the search, so the list falls back to that folder's own contents and the old query goes with it. The X button next to the field still clears it without changing folder.
Parameters
Its Registry page comes from FNS_ConfigRegistry.
TD-SearchPalette
| Control | Type / default | What it does |
|---|---|---|
Auto Install at startupAutoinstall |
on / offon | Put the search field into TouchDesigner's palette browser every time the project opens. This choice roams with your config, so it holds across projects. |
InstallInstall |
button | Add the search field to the palette browser now, without waiting for the next project start. |
UninstallUninstall |
button | Take the search field back out of the palette browser and leave TD's own UI as it was. |
Live SearchLivesearch |
on / offon | Rebuild the result list on every keystroke. Off waits until you stop typing, and is worth turning off only if a very large palette makes typing feel heavy. |
Folder Search (token/)Foldersearch |
on / offon | Let a token containing '/' match the FOLDER instead of the component name, so 'gen/ noise' means folder ~gen and name ~noise, and 'tools/' on its own lists a folder. |
Latest Version OnlyLatestonly |
on / offon | Collapse numbered versions of one component (tool, tool1, tool2, or the same name in two folders) to the most recently modified file. |
Search HotkeyShortcuts |
textempty | Keyboard shortcut that opens the Palette Browser and focuses this search field. Rebindable here or in FNS_HotkeyManager; combos join with '.' and several are separated by spaces. |
Hide Palette When IdleAutohide |
on / offoff | Close the palette browser after it has gone unused for the number of minutes below. Unused means the mouse is outside the palette and nothing is being typed into the search field. Off by default; the palette stays open until you close it. |
Hide After (Minutes)Autohideminutes |
number5 | Minutes without interaction before the palette browser closes, when Hide Palette When Idle is on. The countdown restarts whenever the mouse enters the palette or the search field is typed into. |
Help
| Control | Type / default | What it does |
|---|---|---|
Github PageGithubpage |
button | Open the upstream project's GitHub page (Yea Chen's TD-SearchPalette) in your browser. |
Release NotesReleasenotes |
button | Open the upstream project's release notes in your browser. |
VersionVersionread-only |
textempty | The vendored component's own version, as its author numbers it. Not the package version the updater compares. |
TD BuildTdbuildread-only |
textempty | The TouchDesigner build this component was authored against. |
AuthorAuthorread-only |
textYea Chen <yeataro@gmail.com> | Who wrote the component this package vendors. |