Content

Your library in Kiosk is built around four concepts: a database that stores the index on disk, categories that act as top-level tabs, sources that are the actual folders on your hard drive, and files — the individual assets in your gallery. Everything is local; nothing leaves your machine.

---

Database

Kiosk stores your library in a local database on your machine — a lightweight file that holds your categories, sources, file index, tags, and thumbnail references. Nothing is sent anywhere; everything stays on your disk.

Free version: one local database, stored in %APPDATA%\Kiosk\.

Pro version: create and manage multiple databases using the dropdown in the bottom-left corner of the main window. Each database is completely independent — useful for keeping a personal library separate from a studio project, or organizing different types of work. Switch between them instantly with a single click.

---

Category

Categories are the top-level organizers in your library — like tabs along the sidebar. Each one holds its own set of sources and shows its own files.

Example setup:

• Assets — 3D models and scenes
• Textures — PBR texture sets
• HDRI — environment maps

Creating a Category

1. Click the + button in the sidebar.
2. Enter a name.
3. Optionally assign a custom icon.

File format filters are configured per source, not per category.

Managing Categories

• Rename — Right-click a category in the sidebar.
• Set Icon — Right-click a category to assign a custom icon.
• Delete — Removes the category and its sources from the index. Files on disk are never affected.

---

Sources

Sources are the folders Kiosk scans for files. Each source belongs to a category, and a category can have as many sources as you want.

Adding a Source

Two ways to add a source:

1. Content Manager — Open App Menu → Content Manager, select a category, click Add Source, and browse to a folder.
2. Drag and drop — Drag a folder directly onto the Kiosk window. It gets added as a source in the currently active category.

Source Row Fields

Each source row in the Content Manager has these fields:

Field	What it does
Name	A custom display label shown in the source toggle buttons above the gallery.
Path	The folder on disk. Click to browse or paste a path directly.
Filter	File extension filter for this source. Example: *.hdr, *.exr shows only those formats. Uses the category’s filter if left blank.
Merging Rule	A glob-style pattern to group related files into a single tile (see below).

Filter Examples

*.fbx, *.obj, *.glb     → only these model formats
*.hdr, *.exr            → HDR images only
*.png, *.jpg, *.tif     → raster images

Merging Rules

Merging rules group files that share a naming pattern into a single tile. Useful for assets that come in multiple variants or resolutions.

Write a pattern where * is the wildcard for the part that varies between files, wrapped in parentheses.

Pattern	Groups files like…
(*-?k.hdr)	sky-1k.hdr, sky-2k.hdr, sky-4k.hdr → one tile
(*_LOD?.fbx)	tree_LOD0.fbx, tree_LOD1.fbx, tree_LOD2.fbx → one tile
(*_v?.blend)	scene_v1.blend, scene_v2.blend → one tile

When a tile has multiple variants, use the dropdown on the tile to scroll through and select which variant to export.

---

Files

Once a source is added, Kiosk scans it and builds the file grid. Each tile in the gallery represents one file (or a group, if merging rules apply).

Thumbnails

Kiosk generates previews automatically:

• Images — PNG, JPG, EXR, TIF, TGA, HDR, BMP: thumbnail from the image itself.
• Videos — MP4, MOV, AVI: a frame is extracted. Hover to scrub through frames.
• 3D Files — OBJ, STL, PLY, FBX, glTF, USD: rendered with 3-point lighting via the built-in 3D engine.

To set a custom thumbnail, right-click a file → Thumbnail:

• Choose Thumbnail — Pick an image from disk.
• Paste from Clipboard (Ctrl+V) — Use any copied image.
• Capture Thumbnail — Fullscreen screenshot with rubber-band selection.
• Generate 3D Thumbnail — Force re-render for supported 3D formats.

Custom Tags

Tags let you add your own labels to any file:

1. Right-click a file (or select multiple).
2. Choose Edit → Custom Tags.
3. Type a tag and press Enter.

Tags are searchable — type a tag name in the search bar to filter. You can batch-tag multiple selected files at once.

In the tree folder view, right-click any folder to set tags for all files inside it at once.

OpenPBR Texture Sets

Kiosk detects PBR texture sets automatically. When it finds files sharing a base name but differing by channel suffix — wood_basecolor.png, wood_roughness.png, wood_normal.png — it groups them into a single tile.

Supported channels follow the OpenPBR specification: base color, metalness, roughness, normal, displacement, specular, transmission, coat, emission, ambient occlusion, and more.

To customize which keywords map to which channels, open App Menu → PBR Detection Settings. This lets you match your personal naming conventions — for example if you use diff instead of basecolor.

When you export a texture set to a DCC app, Kiosk creates a complete material with all channels connected automatically — Principled BSDF in Blender, Octane/Redshift nodes in Cinema 4D, Arnold shaders in Maya, and so on.