TK Dynamic Delay
TK Dynamic Delay

Installation

  1. Download StreamDelaySystem.msi from the releases.
  2. Double-click the installer (a UAC prompt will appear).
  3. Follow the installation wizard.
  4. Services start automatically after installation.

What Gets Installed

LocationContents
C:\Program Files\StreamDelay\tk-delay-controller.exe, tk-delay-input-receiver.exe, tk-delay-bootstrap.exe, mediamtx.exe
C:\ProgramData\StreamDelay\.env config, hls/ directory, logs/ directory
Windows ServicesStreamDelayController, StreamDelayInput (both Automatic start)
Start MenuDashboard shortcut, Reconfigure shortcut, Uninstall shortcut

Silent Installation

msiexec /i StreamDelaySystem.msi /quiet /norestart

Building from Source

Prerequisites

SoftwareVersionPurpose
Go1.24+Compile Go services
WiX Toolset3.14+Create MSI installer
PowerShell5.1+Build automation
Windows SDK10.0+Code signing (optional)

Quick Setup

Run the prerequisites installer to automatically check and install everything:

.\install-prerequisites.ps1

This script will:

  • Check for and install Go 1.24+ (via winget)
  • Check for and install WiX Toolset 3.14+ (via winget)
  • Check for and configure Windows SDK (for code signing)
  • Download all Go module dependencies (go mod tidy)
  • Optionally download MediaMTX binary

Build Steps

# Build all components and MSI
.\build-all.ps1

# Clean build (removes all artifacts first)
.\build-all.ps1 -Clean

# Build individual components
cd controller
.\build.ps1

cd ..\services\input-receiver-mediamtx
.\build.ps1

cd ..\..\bootstrapper
.\build.ps1

# Build MSI installer
cd ..
.\build-msi.ps1

Build Output

ComponentOutput
Controllercontroller/tk-delay-controller.exe
Input Receiverservices/input-receiver-mediamtx/tk-delay-input-receiver.exe
Bootstrapperbootstrapper/tk-delay-bootstrap.exe
MediaMTXbin/mediamtx.exe
Installermsi/bin/StreamDelaySystem.msi (~25–35 MB)

Code Signing (Optional)

# Certificate from Windows Store
$env:CODE_SIGNING_THUMBPRINT = "YOUR_CERTIFICATE_THUMBPRINT"
.\build-all.ps1

# Or using PFX file
$env:CODE_SIGNING_PFX = "C:\Path\To\Certificate.pfx"
$env:CODE_SIGNING_PASSWORD = "YourPassword"
.\build-all.ps1

Post-Installation Verification

# Check services are running
Get-Service StreamDelayController, StreamDelayInput

# Open dashboard
Start-Process "http://localhost:8080"

# Check logs
Get-Content C:\ProgramData\StreamDelay\logs\controller.log -Tail 20
Get-Content C:\ProgramData\StreamDelay\logs\input-receiver.log -Tail 20

Troubleshooting Installation

ProblemSolution
Windows 11 requiredMust be Build 22631 or later
Service installation failedRemove old services with sc delete, retry
Services don’t startCheck port conflicts, permissions; restart services
Dashboard not accessibleCheck service status, port 8080, try http://127.0.0.1:8080
MediaMTX not startingVerify binary exists, check config, review logs

Uninstallation

  1. Run installer again and choose Remove, or
  2. Control Panel → Programs → Uninstall, or
  3. msiexec /x {ProductCode}

To remove all data including config and logs:

Remove-Item "C:\ProgramData\StreamDelay" -Recurse -Force

Next Steps

  • Quick Start — Configure OBS and start using the delay system.
Prev
Introduction
Next
Quick Start