SwiftUI

SwiftUI Applications

Documentation for StreamTV SwiftUI applications and installers.

BUILD SWIFTUI

Building the SwiftUI Installer

Quick Start

Option 1: Open in Xcode (Easiest)

1. Open Xcode
2. File → Open → Select StreamTVInstaller/StreamTVInstaller.xcodeproj
3. Select "My Mac" as the destination
4. Press Cmd+B to build
5. Press Cmd+R to run

The app will be built in StreamTVInstaller/build/ and you can test it immediately.

Option 2: Build from Command Line

# Build using xcodebuild
cd StreamTVInstaller
xcodebuild -project StreamTVInstaller.xcodeproj \
           -scheme "StreamTV Installer" \
           -configuration Release \
           -derivedDataPath build

Option 3: Use Build Script

./build-installer.sh

Project Structure

StreamTVInstaller/
├── StreamTVInstaller.swift         # App entry point
├── ContentView.swift                # Main UI view
├── InstallerViewModel.swift         # Installation logic
├── Package.swift                    # Swift Package Manager config
├── Info.plist                       # App metadata
├── StreamTVInstaller.xcodeproj/     # Xcode project
└── build/                           # Build output
    └── StreamTV Installer.app      # Built application

Requirements

• macOS: 11.0 (Big Sur) or later
• Xcode: 13.0 or later
• Swift: 5.5 or later

Creating the Project (If Needed)

If the Xcode project doesn't exist:

1. Open Xcode
2. File → New → Project
3. Select macOS → App
4. Configure:
   • Product Name: StreamTV Installer
   • Team: (your team or None)
   • Organization Identifier: com.streamtv
   • Interface: SwiftUI
   • Language: Swift
5. Save in the StreamTVInstaller/ directory
6. Replace generated files with existing Swift files in the directory

Building for Distribution

Create Release Build

1. In Xcode, select Product → Archive
2. Wait for archive to complete
3. Distribute the app from Organizer

Code Signing (Optional)

For distribution outside the App Store:

1. Get Apple Developer certificate
2. In Xcode: Signing & Capabilities → Enable signing
3. Archive and export

Troubleshooting

"No such module 'SwiftUI'"

Make sure you're targeting macOS 11.0 or later:

• In Xcode: Project Settings → Deployment Target → macOS 11.0

"Cannot find type 'NSWorkspace'"

Add import:

import AppKit

Build Errors

1. Clean build folder: Cmd+Shift+K
2. Delete derived data
3. Rebuild: Cmd+B

Running the Built App

After building:

1. App will be in StreamTVInstaller/build/StreamTV Installer.app
2. Double-click to run
3. Or use: open "StreamTVInstaller/build/StreamTV Installer.app"

Path Independence

The SwiftUI app automatically finds the StreamTV directory:

• When running as app bundle: Looks for StreamTV directory relative to app
• When running from source: Uses current directory
• Searches up directory tree to find StreamTV root

---

README SWIFTUI

StreamTV SwiftUI Installer - Complete Guide

Overview

The SwiftUI installer provides a native macOS experience with a beautiful, modern interface built using Apple's SwiftUI framework. This replaces the Tkinter-based installer with a fully native macOS application.

Quick Start

Building the Installer

Option 1: Using Xcode (Recommended)

1. Open Xcode
2. File → Open → Navigate to StreamTVInstaller/StreamTVInstaller.xcodeproj
3. If the project doesn't exist, create it:
   • File → New → Project
   • Select macOS → App
   • Product Name: StreamTV Installer
   • Interface: SwiftUI
   • Language: Swift
   • Save in the StreamTVInstaller/ directory
   • Replace generated files with existing Swift files
4. Select "My Mac" as destination
5. Press Cmd+B to build
6. Press Cmd+R to run

Option 2: Using Build Script

./build-installer.sh

Option 3: Command Line

cd StreamTVInstaller
xcodebuild -project StreamTVInstaller.xcodeproj \
           -scheme "StreamTV Installer" \
           -configuration Release

Running the Installer

Double-Click Method:

1. Build the installer (see above)
2. Double-click Install-StreamTV-SwiftUI.command
3. The native SwiftUI installer will open

Direct App Launch:

1. Navigate to StreamTVInstaller/build/StreamTV Installer.app
2. Double-click the app

Features

Native macOS Experience

• ✅ SwiftUI Interface: Built with Apple's modern UI framework
• ✅ Native Look & Feel: Matches macOS Human Interface Guidelines
• ✅ Smooth Animations: Native macOS animations and transitions
• ✅ Dark Mode: Automatic dark mode support
• ✅ Accessibility: Full VoiceOver and accessibility support
• ✅ SF Symbols: Uses native macOS icon system

Visual Status Indicators

Each module shows its status with native SF Symbols:

• Green Checkmark (checkmark.circle.fill): Success
• Yellow Warning (exclamationmark.triangle.fill): Issues detected
• Red Error (xmark.circle.fill): Installation failed
• Blue Info (info.circle.fill): Information messages

Installation Features

• ✅ Module Detection: Automatically detects existing installations
• ✅ Update Support: Updates existing modules when needed
• ✅ Auto-Fix: Attempts to fix detected issues automatically
• ✅ Real-time Progress: Live progress bar and status updates
• ✅ Path Independent: Works from any location

Project Structure

StreamTV/
├── StreamTVInstaller/
│   ├── StreamTVInstaller.swift         # App entry point
│   ├── ContentView.swift                # Main UI view
│   ├── InstallerViewModel.swift         # Installation logic
│   ├── Package.swift                    # Swift Package Manager config
│   ├── Info.plist                       # App metadata
│   ├── StreamTVInstaller.xcodeproj/    # Xcode project
│   └── build/                           # Build output directory
│       └── StreamTV Installer.app       # Built application
├── build-installer.sh                   # Build script
├── Install-StreamTV-SwiftUI.command     # Launcher
└── README_SWIFTUI.md                    # This file

Requirements

• macOS: 11.0 (Big Sur) or later
• Xcode: 13.0 or later
• Swift: 5.5 or later

Installation Modules

The installer handles:

1. Python - Checks version, downloads installer if needed
2. FFmpeg - Installs via Homebrew or direct download
3. Virtual Environment - Creates/updates venv
4. pip - Upgrades pip, setuptools, wheel
5. Dependencies - Installs/updates Python packages
6. Configuration - Sets up config.yaml
7. Database - Initializes SQLite database
8. Channels - Creates default channels
9. Launch Scripts - Creates start scripts and launchd service

Advantages Over Tkinter

Feature	SwiftUI Installer	Tkinter Installer
Native Look	✅ Yes	❌ No
Performance	✅ Fast	⚠️ Slower
Dark Mode	✅ Automatic	⚠️ Limited
Accessibility	✅ Full	⚠️ Basic
Animations	✅ Smooth	⚠️ Basic
SF Symbols	✅ Yes	❌ No
Build Required	⚠️ Yes	✅ No

Troubleshooting

"Xcode not found"

Install Xcode from the App Store, then:

xcode-select --install

"Cannot find type 'NSApplication'"

Add import to ContentView.swift:

import AppKit

"Build failed"

1. Clean build: Cmd+Shift+K in Xcode
2. Delete derived data
3. Rebuild: Cmd+B

"App won't open"

1. Right-click → Open (to bypass Gatekeeper)
2. Check System Preferences → Security & Privacy
3. For distribution, code sign the app

Path Detection Issues

The app automatically finds the StreamTV directory:

• When running as app bundle: Looks relative to app location
• When running from source: Uses current directory
• Searches up directory tree to find StreamTV root

Distribution

For End Users

1. Build the installer app
2. Create a DMG or ZIP file
3. Users can double-click to install

Code Signing (Optional)

For distribution outside the App Store:

1. Get Apple Developer certificate
2. In Xcode: Signing & Capabilities → Enable signing
3. Archive and export from Xcode

Comparison with Python Installer

The SwiftUI installer provides the same functionality as the Python installer but with:

• Better performance
• Native macOS appearance
• Better accessibility
• Automatic dark mode
• Smoother animations

Both installers are available - choose based on your preference!

Path Independence

The SwiftUI app is fully path-independent:

• Works from any location
• Handles symlinks correctly
• Resolves absolute paths automatically
• Changes working directory as needed

See PATH_INDEPENDENCE.md for details.

---

README

SwiftUI Applications Documentation

Documentation for StreamTV's SwiftUI-based macOS applications.

---

📚 Documentation Files

Building SwiftUI Apps

BUILD_SWIFTUI.md

• How to build SwiftUI applications
• Development setup
• Build process

SwiftUI Overview

README_SWIFTUI.md

• SwiftUI features
• Application overview
• Usage guide

---

🔗 Related Documentation

• Main Documentation Index
• SwiftUI Installer
• SwiftUI Quick Start

---

🛠️ SwiftUI Applications

StreamTV includes SwiftUI-based installers and utilities for macOS.

See installation docs for usage.

---

Related Pages

• Installation Guide
• Home