Skip to content

Repository files navigation

Sightline

Sightline is a Windows desktop app and runtime for real-time stream automation.

Demo: (https://www.youtube.com/watch?v=sD8wB21P9R0)

Sightline is real-time stream automation for gameplay and live broadcasts: it watches for the moments that matter, reacts immediately, and helps turn live sessions into clips, cues, and polished automation flows.

As of July 22, 2026, the live product site at quacksoftware.com describes Sightline as software that detects moments, triggers reactions, and autoclips highlights during live gameplay or broadcasts. This repository is the codebase behind that product surface. It is not the marketing site, and it is not a full binary distribution mirror.

Product Scope

Sightline's core loop is:

  1. watch a live frame source
  2. detect a visual or OCR-driven event
  3. run follow-up actions
  4. optionally route the hit into clipping workflows

In the current codebase, that includes:

  • region-based visual detection
  • OCR/text extraction
  • OBS-driven capture and automation
  • action execution such as sounds, program launch, OBS updates, and markers
  • customer-app tooling for authoring, previewing, and running profiles

What Is In This Repo

  • sightline_runtime/ Runtime orchestration, capture providers, actions, sinks, and the embedded customer_app/.

  • perception_core/ Reusable image detection, OCR, extraction, and profile-processing helpers.

  • plugins/obs-overlay/ Local overlay service used by the app when overlay features are enabled.

  • build_customer_app_nuitka.bat Windows packaging entrypoint for the desktop app.

  • sightline.iss Inno Setup definition for the packaged installer.

What Is Not In This Repo

  • the archived private/internal repositories
  • local machine config and runtime artifacts
  • packaged binary outputs as first-class source-controlled artifacts
  • unrelated plugins and experiments that were present in the older private workspace

This public repo is intentionally narrowed to the user-facing Sightline product surface.

Repository Boundary

customer_app is not a separate product in this repo. It lives inside sightline_runtime and depends on the runtime and perception_core.

That means the public repository boundary is one repo containing:

  1. sightline_runtime
  2. perception_core
  3. plugins/obs-overlay

Run From Source

Install the required Python packages:

py -m pip install -r requirements.txt

Optional editor hotkey support:

py -m pip install -r sightline_runtime/optional_requirements.txt

External prerequisites:

  • Windows
  • Tesseract OCR installed separately
  • OBS plus obs-websocket if you want live OBS capture, OBS-triggered actions, or replay-buffer workflows

Launch the desktop app from source:

.\run_sightline_from_source.bat

Configuration

The repo ships example config files:

  • sightline_runtime/config.example.json
  • sightline_runtime/obs_capture.example.json
  • plugins/obs-overlay/config.example.json

Local overrides are optional and ignored by git:

  • sightline_runtime/config.json
  • sightline_runtime/obs_capture.json

If the local files are absent, the app falls back to the example configs. When OBS connection settings are changed from the app, the writable local capture config is sightline_runtime/obs_capture.json.

Build The Desktop App

Packaged builds use the public example configs bundled with the repo rather than ignored local machine config.

.\build_customer_app_nuitka.bat premium

Build prerequisites:

  • nuitka installed in the selected Python environment
  • Inno Setup 6 at the default path, or CUSTOMER_APP_INNO_COMPILER set explicitly

Notes On Releases

The packaged outputs that existed in the older private workspace were built on May 13, 2026 under C:\Users\dave\kick\tools. They are useful as archived release artifacts, but they were not rebuilt from this public repo during the repository split.

External Links

  • Product site: https://www.quacksoftware.com/
  • Demo video: https://www.youtube.com/watch?v=hBhhcpCBhwY
  • Free download: https://quacksoftware.gumroad.com/l/sightline-free
  • Premium download: https://quacksoftware.gumroad.com/l/sightline

About

Real-time computer vision and OCR automation for live streams, with OBS integration and event-driven actions.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages