Scotty for AntMedia Server
==========================

``Scotty`` is a commercial plugin for `AntMedia Server <https://antmedia.io>`_ that detects
SCTE-35 ad break markers in live streams and injects the appropriate HLS signaling tags for
downstream ad insertion systems.

When a stream is published to an application that has Scotty enabled, the plugin automatically
parses incoming SCTE-35 binary cue points and annotates the HLS playlists in real time — with
no segment re-encoding or interruption to the stream.

Features
--------

- **SSAI** (Server-Side Ad Insertion signaling): Injects ``#EXT-X-CUE-OUT``,
  ``#EXT-X-CUE-OUT-CONT``, and ``#EXT-X-CUE-IN`` tags so ad-stitching services such as
  AWS MediaTailor can perform transparent segment replacement.
- **SGAI** (Server-Guided Ad Insertion): Injects ``#EXT-X-DATERANGE`` with
  ``CLASS="com.apple.hls.interstitial"`` so Apple HLS-capable players fetch and render the
  configured ad asset at the right moment.
- **Both modes simultaneously** — annotate playlists for multiple integration points at once.
- **SCTE-35 detection** via binary packet parsing (``splice_insert`` and ``time_signal``
  commands).
- **Three SSAI tag format options**: ``EXT_X_CUE_OUT_IN``, ``EXT_X_DATERANGE_SCTE35``,
  ``EXT_X_SCTE35``.
- **Per-application configuration** — different modes and settings per AntMedia application.
- **Per-stream settings** using regex stream-name patterns (``streamNameTemplates``).
- **Configuration hot-reload** without restarting AntMedia Server.
- **Web-based management UI** for installing the filter per application and editing settings.

.. toctree::
   :maxdepth: 1
   :caption: Contents

   installation
   configuration
   web-ui
   changelog
   license