Configuration
Configure Kiosk Library settings, commands, and preferences.
Overview
Kiosk’s configuration is accessible from Settings in the main application. All settings are stored locally on your machine and never sent anywhere.
General Settings
| Setting | Description | Default |
|---|---|---|
| Theme | Light or dark UI theme | Dark |
| Language | Interface language | English |
| Thumbnail Size | Default thumbnail size in the grid | Medium |
| Default Action | What happens on double-click | Open File |
| Start with OS | Launch Kiosk when your computer starts | Off |
Library Settings
| Setting | Description |
|---|---|
| Cache Directory | Where Kiosk stores thumbnails and indexes |
| Auto-Refresh | Automatically re-scan sources on launch |
| Scan Subdirectories | Include files in subdirectories when scanning |
Plugin Settings
Each DCC plugin has its own configuration section:
- Watch Folder — Local folder used for plugin communication.
- Commands — Custom command scripts that execute in the DCC app.
- Export Plugin — Download the plugin file for manual installation.
See the Plugins page for per-DCC details.
Custom Commands
Custom commands allow you to define what happens when you interact with a file from within your DCC app. Each command is associated with a file extension and runs inside the DCC app’s scripting environment.
Available Variables
| Variable | Description | Example |
|---|---|---|
{path} | Full file path | /assets/model.fbx |
{name} | File name without extension | model |
{ext} | File extension | .fbx |
{dir} | Parent directory path | /assets/ |
Example: Multi-Line Command
Commands can span multiple lines for complex operations:
# Import FBX and center at origin
bpy.ops.import_scene.fbx(filepath="{path}")
obj = bpy.context.active_object
obj.location = (0, 0, 0)
obj.name = "{name}"License
- Activate — Enter your license key in Settings → License → Activate.
- Deactivate — You can deactivate your license to move it to another machine.
- Status — View your current license status and type (Free, Pro, or Studio).
Data & Privacy
Kiosk is fully offline. No data is collected, no analytics are tracked, and your files never leave your machine. The only network activity is:
- Checking for updates (optional, can be disabled)
- Gumroad license validation (one-time, on activation)