feat: add Live TV sources, guides, DVR, and multiview

.cargo/config.toml

@@ -1,6 +1,7 @@
 # TODO: static link glibc
 
 [alias]
+xtask = "run --quiet -p xtask --"
 new-migration = "run --quiet -p xtask -- new-migration"
 msi-version = "run --quiet -p xtask -- msi-version"
 

.clang-format

@@ -0,0 +1,116 @@
+---
+# This file is centrally managed in https://github.com/<organization>/.github/
+# Don't make changes to this file in this repo as they will be overwritten with changes made to the same file in
+# the above-mentioned repo.
+
+# Generated from CLion C/C++ Code Style settings
+BasedOnStyle: LLVM
+AccessModifierOffset: -2
+AlignAfterOpenBracket: BlockIndent
+AlignConsecutiveAssignments: None
+AlignEscapedNewlines: DontAlign
+AlignOperands: Align
+AllowAllArgumentsOnNextLine: false
+AllowAllConstructorInitializersOnNextLine: false
+AllowAllParametersOfDeclarationOnNextLine: false
+AllowShortBlocksOnASingleLine: Empty
+AllowShortCaseLabelsOnASingleLine: false
+AllowShortEnumsOnASingleLine: false
+AllowShortFunctionsOnASingleLine: Empty
+AllowShortIfStatementsOnASingleLine: Never
+AllowShortLambdasOnASingleLine: None
+AllowShortLoopsOnASingleLine: true
+AlignTrailingComments: false
+AlwaysBreakAfterDefinitionReturnType: None
+AlwaysBreakAfterReturnType: None
+AlwaysBreakBeforeMultilineStrings: true
+AlwaysBreakTemplateDeclarations: MultiLine
+BinPackArguments: false
+BinPackParameters: false
+BracedInitializerIndentWidth: 2
+BraceWrapping:
+  AfterCaseLabel: false
+  AfterClass: false
+  AfterControlStatement: Never
+  AfterEnum: false
+  AfterExternBlock: true
+  AfterFunction: false
+  AfterNamespace: false
+  AfterObjCDeclaration: false
+  AfterUnion: false
+  BeforeCatch: true
+  BeforeElse: true
+  IndentBraces: false
+  SplitEmptyFunction: false
+  SplitEmptyRecord: true
+BreakArrays: true
+BreakBeforeBinaryOperators: None
+BreakBeforeBraces: Attach
+BreakBeforeTernaryOperators: false
+BreakConstructorInitializers: AfterColon
+BreakInheritanceList: AfterColon
+ColumnLimit: 0
+CompactNamespaces: false
+ContinuationIndentWidth: 2
+Cpp11BracedListStyle: true
+EmptyLineAfterAccessModifier: Never
+EmptyLineBeforeAccessModifier: Always
+ExperimentalAutoDetectBinPacking: true
+FixNamespaceComments: true
+IncludeBlocks: Regroup
+IndentAccessModifiers: false
+IndentCaseBlocks: true
+IndentCaseLabels: true
+IndentExternBlock: Indent
+IndentGotoLabels: true
+IndentPPDirectives: BeforeHash
+IndentWidth: 2
+IndentWrappedFunctionNames: true
+InsertBraces: true
+InsertNewlineAtEOF: true
+KeepEmptyLinesAtTheStartOfBlocks: false
+MaxEmptyLinesToKeep: 1
+NamespaceIndentation: All
+ObjCBinPackProtocolList: Never
+ObjCSpaceAfterProperty: true
+ObjCSpaceBeforeProtocolList: true
+PackConstructorInitializers: Never
+PenaltyBreakBeforeFirstCallParameter: 1
+PenaltyBreakComment: 1
+PenaltyBreakString: 1
+PenaltyBreakFirstLessLess: 0
+PenaltyExcessCharacter: 1000000
+PenaltyReturnTypeOnItsOwnLine: 100000000
+PointerAlignment: Right
+ReferenceAlignment: Pointer
+ReflowComments: true
+RemoveBracesLLVM: false
+RemoveSemicolon: false
+SeparateDefinitionBlocks: Always
+SortIncludes: CaseInsensitive
+SortUsingDeclarations: Lexicographic
+SpaceAfterCStyleCast: true
+SpaceAfterLogicalNot: false
+SpaceAfterTemplateKeyword: false
+SpaceBeforeAssignmentOperators: true
+SpaceBeforeCaseColon: false
+SpaceBeforeCpp11BracedList: true
+SpaceBeforeCtorInitializerColon: false
+SpaceBeforeInheritanceColon: false
+SpaceBeforeJsonColon: false
+SpaceBeforeParens: ControlStatements
+SpaceBeforeRangeBasedForLoopColon: true
+SpaceBeforeSquareBrackets: false
+SpaceInEmptyBlock: false
+SpaceInEmptyParentheses: false
+SpacesBeforeTrailingComments: 2
+SpacesInAngles: Never
+SpacesInCStyleCastParentheses: false
+SpacesInContainerLiterals: false
+SpacesInLineCommentPrefix:
+  Maximum: 3
+  Minimum: 1
+SpacesInParentheses: false
+SpacesInSquareBrackets: false
+TabWidth: 2
+UseTab: Never

.flake8

@@ -0,0 +1,7 @@
+[flake8]
+filename =
+    *.py
+max-line-length = 120
+extend-exclude =
+    .venv/
+    venv/

.github/workflows/ci-rust.yml

@@ -107,7 +107,12 @@ jobs:
     env:
       CARGO_TERM_COLOR: always
       INPUT_RELEASE_VERSION: ${{ inputs.release_version }}
-      TEST_TOOLCHAIN: nightly  # libtest's JSON output requires nightly.
+      # Temporary pin pending https://github.com/rust-lang/rust/pull/165266; tracked in PR #351's checklist.
+      TEST_TOOLCHAIN: nightly-2026-10-31  # libtest JSON needs nightly; November 1 has a compiler regression.
+      # musl must support dlopen for Koko's bundled native TV library.
+      RUSTFLAGS: >-
+        ${{ contains(matrix.target, 'musl') &&
+        '-C target-feature=-crt-static -C link-arg=-Wl,-rpath,$ORIGIN/live-tv' || '' }}
     steps:
       - name: Fix arm64 Alpine container
         if: runner.arch == 'ARM64' && contains(matrix.container, 'alpine')
@@ -121,11 +126,15 @@ jobs:
           apk add --no-cache \
             bash \
             build-base \
+            cmake \
             curl \
             git \
             jq \
+            linux-headers \
             nodejs \
             npm \
+            numactl \
+            python3 \
             openssl-dev \
             openssl-libs-static \
             p7zip \
@@ -137,15 +146,15 @@ jobs:
 
       - name: Checkout
         uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1  # v7.0.1
+        with:
+          submodules: recursive
 
       - name: Trust Alpine checkout
         if: contains(matrix.container, 'alpine')
         run: |
           git config --global --add safe.directory "${GITHUB_WORKSPACE}"
           git config --global --add safe.directory "${GITHUB_WORKSPACE}/third-party/build-deps"
-
-      - name: Initialize build-deps
-        run: git submodule update --init --depth=1 third-party/build-deps
+          git config --global --add safe.directory "${GITHUB_WORKSPACE}/third-party/tsduck"
 
       - name: Install Ubuntu dependencies
         if: matrix.container == '' && contains(matrix.os, 'ubuntu')
@@ -162,6 +171,10 @@ jobs:
             p7zip-full \
             pkg-config
 
+      - name: Install macOS native build tools
+        if: contains(matrix.os, 'macos')
+        run: brew install bash coreutils gnu-sed grep make
+
       - name: Setup Rust
         if: matrix.container == ''
         uses: actions-rust-lang/setup-rust-toolchain@ecabd13d1c56bd1345c230e542e9144811ad706f  # v2.0.0
@@ -216,6 +229,8 @@ jobs:
       - name: Test
         id: test
         if: matrix.run == 'test'
+        env:
+          GH_TOKEN: ${{ github.token }}
         run: |
           tarpaulin_args=()
           case "${{ matrix.target }}" in
@@ -267,12 +282,24 @@ jobs:
       - name: Build
         if: matrix.run == 'build'
         env:
+          GH_TOKEN: ${{ github.token }}
           KOKO_FANART_PROJECT_API_KEY: ${{ secrets.FANART_PROJECT_API_KEY }}
           KOKO_LRCLIB_APPLICATION_ID: ${{ secrets.LRCLIB_APPLICATION_ID }}
         run: |
           cargo build --locked ${{ matrix.cargo_features }} --target ${{ matrix.target }} --release \
             --message-format=json | tee "${RUNNER_TEMP}/cargo-build.json"
 
+      - name: Bundle native TV library
+        if: matrix.run == 'build'
+        run: |
+          out_dir="$(jq -ber '
+            select(.reason == "build-script-executed" and (.package_id | contains("#koko@"))) | .out_dir
+          ' "${RUNNER_TEMP}/cargo-build.json")"
+          package_dir="$(cat "${out_dir}/native-tv-root.txt")"
+          destination="target/${{ matrix.target }}/release/live-tv"
+          mkdir -p "${destination}"
+          cp -R "${package_dir}/." "${destination}/"
+
       - name: Bundle shared FFmpeg tools
         if: matrix.run == 'build'
         env:
@@ -304,7 +331,8 @@ jobs:
           7z a "./artifacts/koko-${{ matrix.target }}.7z" \
             "./assets" \
             "./target/${{ matrix.target }}/release/koko${extension}" \
-            "./target/${{ matrix.target }}/release/ffmpeg"
+            "./target/${{ matrix.target }}/release/ffmpeg" \
+            "./target/${{ matrix.target }}/release/live-tv"
 
       - name: Prepare build artifact
         if: matrix.run == 'build' && matrix.build_artifact_path == 'build-artifact'
@@ -323,6 +351,8 @@ jobs:
             "build-artifact/target/${{ matrix.target }}/release/koko${extension}"
           cp -R "crates/client-web/dist" "build-artifact/crates/client-web/dist"
           cp -R "target/${{ matrix.target }}/release/ffmpeg" "build-artifact/target/${{ matrix.target }}/release/ffmpeg"
+          cp -R "target/${{ matrix.target }}/release/live-tv" \
+            "build-artifact/target/${{ matrix.target }}/release/live-tv"
 
       - name: Upload build artifact
         if: matrix.run == 'build'

.github/workflows/ci-windows-installer.yml

@@ -128,7 +128,8 @@ jobs:
           7z a "artifacts\koko-${{ matrix.target }}.7z" `
             ".\assets" `
             ".\target\${{ matrix.target }}\release\koko.exe" `
-            ".\target\${{ matrix.target }}\release\ffmpeg"
+            ".\target\${{ matrix.target }}\release\ffmpeg" `
+            ".\target\${{ matrix.target }}\release\live-tv"
 
       - name: Resolve MSI package version
         shell: pwsh

.github/workflows/ci.yml

@@ -67,6 +67,14 @@ jobs:
       - name: Check licenses
         run: cargo bin cargo-deny check licenses
 
+      - name: Test media tool package compatibility
+        run: |
+          rustc --test --edition=2021 -D warnings packaging/ffmpeg_stack.rs -o "${RUNNER_TEMP}/ffmpeg-stack-tests"
+          "${RUNNER_TEMP}/ffmpeg-stack-tests"
+
+      - name: Test native packaging metadata and downloads
+        run: cargo test -p xtask --locked
+
   clippy:
     name: Clippy
     permissions:
@@ -78,7 +86,8 @@ jobs:
     permissions:
       contents: read
     runs-on: ubuntu-latest
-    timeout-minutes: 30
+    # Cold native SDK builds and the playback suite can exceed thirty minutes together.
+    timeout-minutes: 45
     strategy:
       fail-fast: false
       matrix:
@@ -88,9 +97,12 @@ jobs:
     env:
       KOKO_SKIP_FFMPEG_DOWNLOAD: '1'
       KOKO_E2E_BROWSER: ${{ matrix.browser }}
+      KOKO_E2E_SERVER: ${{ github.workspace }}/target/debug/koko
     steps:
       - name: Checkout
         uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1  # v7.0.1
+        with:
+          submodules: recursive
 
       - name: Setup Rust
         uses: actions-rust-lang/setup-rust-toolchain@ecabd13d1c56bd1345c230e542e9144811ad706f  # v2.0.0
@@ -119,6 +131,11 @@ jobs:
             node node_modules/playwright/cli.js install --with-deps chrome
           fi
 
+      - name: Build browser test server
+        env:
+          KOKO_SKIP_FFMPEG_DOWNLOAD: '1'
+        run: cargo build -p koko --locked --no-default-features
+
       - name: Test real browser playback
         working-directory: crates/client-web
         run: npm run test:e2e

.gitmodules

@@ -14,3 +14,7 @@
 	path = third-party/dockle
 	url = https://github.com/LizardByte/dockle.git
 	branch = master
+[submodule "third-party/tsduck"]
+	path = third-party/tsduck
+	url = https://github.com/tsduck/tsduck.git
+	branch = master

.readthedocs.yaml

@@ -27,6 +27,8 @@ build:
           fi
           chmod +x "${dockle_dir}/readthedocs_build.sh"
           export DOCKLE_DIR="${dockle_dir}"
+          # Rustdoc generates the TV APIs without building or loading the native tuner runtime.
+          export KOKO_SKIP_TSDUCK_BUILD=1
           "${dockle_dir}/readthedocs_build.sh"
 
 python: