SeeThrough Layer Rename

The See-through model names its layers the way an engineer names variables: hairf, hairb, handwearl, eyer. Those are fine for a pipeline and miserable for a game project, where someone (probably future you) has to read them in Spine and rig against them. SeeThrough Layer Rename is a 60-second stop on the export path that maps those terse tags to Spine-friendly names - front-hair, back-hair, handwear-left, eye-right - before anything hits disk.

It lives in the Spine prep chain the tk_seethrough fork added on top of upstream ComfyUI-See-through: PostProcess → Layer Rename → Layer Filter → Export Spine. If you're exporting a PSD instead, you don't need it - it only changes the names that appear in the Spine export.

How it works

The node takes the SEETHROUGH_PARTS container, walks every layer, and renames each tag using a built-in default mapping (the full list is in the pack README - hairf → front-hair, eyel → eye-left, earr → ear-right, and so on). Tags that are already clean (face, head, nose) pass through unchanged. It also stashes the original tag as original_tag internally, so nothing upstream loses track of what a layer actually is.

The custom_mapping_json input is the only knob, and it's optional. Leave it empty and you get the defaults. Want your own conventions? Drop in a JSON object and only the tags you name get overridden; everything else keeps the defaults:

{
  "hairf": "bangs",
  "topwear": "shirt",
  "handwearl": "left-glove"
}

If you paste invalid JSON, the node prints a warning and silently falls back to the defaults - annoying, but at least it doesn't crash your workflow.

When to use it

The built-in names are sensible defaults, so the main reasons to touch this node are: (1) you want the exported files readable at a glance, and (2) your team has a naming convention that the defaults don't match. The one real footgun: if you connect Layer Filter downstream, its tag list shows the renamed names - so filter on front-hair, not hairf. Skip Layer Rename entirely and the filter's list is back to the original tags.

Installation

Ships with tk_seethrough - ComfyUI Manager → search "See Through," or:

cd ComfyUI/custom_nodes
git clone https://github.com/tackcrypto1031/tk_seethrough.git
cd tk_seethrough
pip install -r requirements.txt

Restart ComfyUI; it lands under the SeeThrough category. No models, no downloads - this node is pure bookkeeping.