Setup

Setup

Requirements

• Windows 10 or 11
• PowerShell 5.1 or later (built in to Windows -- no install needed)
• TeknoParrot installed, with TeknoParrotUi.exe run at least once so it downloads its GameProfiles folder
• Your games extracted into per-game subfolders, or as ZIP files for AutoSync to extract

---

Running the script

Step 1. Open PowerShell and navigate to the folder containing TeknoParrot-Manager.ps1:

cd "C:\path\to\TeknoParrot\Scripts"

Step 2. Run the script:

.\TeknoParrot-Manager.ps1

If blocked by execution policy, allow it for this session only:

powershell -ExecutionPolicy Bypass -File .\TeknoParrot-Manager.ps1

Step 3. The script auto-detects your TeknoParrot path (see below), then walks you through initial setup. On later runs, press Y to reuse saved settings.

---

Auto-detect TeknoParrot path

On first run the script scans common install locations for TeknoParrotUi.exe before asking you to type a path:

• Your LaunchBox Emulators folder under %USERPROFILE%
• Drive roots: C:\TeknoParrot, D:\TeknoParrot, etc.
• Drive roots with sub-paths: \Games\TeknoParrot, \Emulators\TeknoParrot
• Program Files and Program Files (x86) on every mounted drive

If exactly one install is found it is offered for confirmation. If multiple installs are found they are listed numbered so you can pick without typing. If nothing is found the manual prompt appears.

---

Initial configuration

On first run you are prompted for:

Setting	Description
TeknoParrot root	Folder containing TeknoParrotUi.exe
Mode	AutoSync (has ZIP source) or Register only (already extracted)
ZIP source	(AutoSync only) Folder containing your game ZIPs (can be a NAS path)
Staging folder	Local folder where games are extracted or already live
RetroBat mode	Whether to use .teknoparrot folder naming for RetroBat/Batocera
Dat file	Optional -- Eggman/RomVault dat for improved registration (see Register)
ReShade DLL	Auto-detected from ReShade\ subfolder next to the script
dgVoodoo2 folder	Optional -- folder containing dgVoodoo2 DLLs (see dgVoodoo2)

Settings are saved to TeknoParrot-Manager.config.json next to the script. On later runs press Y to reuse them.

---

Configuration file

TeknoParrot-Manager.config.json stores your saved settings. You can edit it directly with any text editor. Delete it to be prompted for all settings again on the next run.

---

Overrides file

TeknoParrot-Manager.overrides.json is created empty on first run. It lets you fine-tune individual games:

{
  "noSync":         ["ZipBaseName1", "ZipBaseName2"],
  "onlySync":       ["ZipBaseName1", "ZipBaseName2"],
  "noPropagate":    ["ProfileCode1", "ProfileCode2"],
  "forceArchetype": { "ProfileCode": "ReferenceProfileCode" },
  "familyOverride": { "ProfileCode": "trackball" },
  "datFile":        "C:\\full\\path\\to\\collection.dat"
}

Key	Description
noSync	ZIP base names to always skip during extraction
onlySync	Whitelist -- only extract these ZIPs (bypasses interactive picker)
noPropagate	Profile codes to leave untouched during control propagation
forceArchetype	Pin a game to copy controls from a specific reference game
familyOverride	Override the auto-detected control family for a game
datFile	Full path to a dat file -- overrides the setup-configured path

All keys are optional. Bad or missing entries are ignored safely.

---

Resetting

What to reset	How
All saved settings	Delete TeknoParrot-Manager.config.json
Re-extract all ZIPs	Delete TeknoParrot-Manager.syncstate.json from your staging folder
Re-register one game	Delete that game's .xml from UserProfiles\, then re-run

---

Unattended / scheduled mode

Run with -Unattended to skip all prompts:

.\TeknoParrot-Manager.ps1 -Unattended

Requires saved settings (run once interactively first). Designed for Windows Task Scheduler. See Register for scheduling instructions.

---

Files created by the script

File	Description
TeknoParrot-Manager.config.json	Saved settings
TeknoParrot-Manager.overrides.json	Per-game overrides
TeknoParrot-Manager.log	Log of every run; includes a download audit trail (source/filename/version/SHA256) for fetched binaries
TeknoParrot-Manager.syncstate.json	Tracks extracted ZIPs (in staging folder)
TeknoParrot-Manager-controls.txt	Controls state snapshot after every run
TeknoParrot-Manager-ActionItems.txt	Outstanding action items from last registration run
TeknoParrot-LaunchBox-Import.xml	LaunchBox reference XML (when export is run)