StreamGate iOS Application Project

StreamGate is an open-source native iOS application designed as a technical showcase for capturing and uploading video content directly to the cloud. Built purely for developers, it demonstrates how to handle complex mobile media workflows — such as camera capture, background screen recording, and reliable direct-to-cloud resumable uploads using FastPix infrastructure.

Once an upload completes, StreamGate generates an instant, shareable playback link.

---

Core Features & Architecture

StreamGate is built using a modern iOS tech stack (100% Swift, SwiftUI, ReplayKit, AVFoundation) and focuses on the following core capabilities:

1. Camera Capture: Integrates UIImagePickerController for native video recording directly within the app.
2. Screen Recording: Uses Apple's ReplayKit Broadcast Extension with AVAssetWriter to capture device-wide screen activity reliably in a separate sandboxed process.
3. Direct Cloud Uploading: Utilizes the FastPix iOS Upload SDK to push large media files securely to the cloud in resumable chunks without routing them through an intermediary backend server.
4. Local Playback / Preview: Integrates AVPlayer to preview the recorded video locally before the shareable link is generated.
5. Auto Cleanup: Automatically deletes previous recordings before each new session to keep on-device storage usage low.

---

Tech Stack & Dependencies

• Language: Swift
• UI Framework: SwiftUI
• Screen Capture: ReplayKit (RPBroadcastSampleHandler, RPSystemBroadcastPickerView)
• Video Encoding: AVFoundation (AVAssetWriter, H.264)
• Inter-process Communication: App Groups (shared UserDefaults + shared filesystem)
• Uploading: FastPix iOS Uploads SDK
• Build Constraints: iOS 16.0+, Xcode 15+, real device required

---

Setup & Build Instructions

Prerequisites

Before building the project, ensure you have:

• Xcode 15+
• iOS 16.0+
• Physical iPhone device (ReplayKit Broadcast Extensions do not work reliably on Simulator)
• Apple Developer Account
• FastPix API credentials

---

1. Clone Repository

git clone https://github.com/FastPix/iOS-StreamGate.git
cd StreamGate
open StreamGate.xcodeproj

---

2. Add FastPix iOS Uploads SDK

StreamGate uses the FastPix iOS Uploads SDK for resumable chunked uploads.

Via Swift Package Manager:

1. In Xcode go to File → Add Package Dependencies
2. Enter the package URL:

   https://github.com/FastPix/iOS-Uploads
   

3. Select the latest version and add it to the StreamGate main target

After adding, verify the SDK appears under the main target's Frameworks, Libraries, and Embedded Content alongside ScreenBroadcastExtension.appex:

Frameworks, Libraries, and Embedded Content
├── fp-swift-upload-sdk
└── ScreenBroadcastExtension.appex    →  Embed Without Signing

ScreenBroadcastExtension.appex must be set to Embed Without Signing so iOS bundles the extension inside the main app at install time. Without this the broadcast picker will show no available extension.

For full SDK setup instructions refer to the official guide: Set up Resumable Uploads for iOS

---

3. Configure App Groups

Enable the same App Group for both targets:

Main App Target

Signing & Capabilities
→ App Groups
→ group.com.streamgate.broadcast

ScreenBroadcastExtension Target

Signing & Capabilities
→ App Groups
→ group.com.streamgate.broadcast

The App Group identifier must match exactly on both targets. If they differ, the extension and main app write and read from different sandboxed directories and no recorded file will ever be detected.

To learn more about App Groups and Broadcast Extensions refer to: ReplayKit — Apple Developer Documentation

---

4. Configure Broadcast Extension

Verify the Broadcast Extension Bundle Identifier:

com.streamgate.StreamGate.ScreenBroadcastExtension

And ensure the same identifier is referenced in BroadcastPickerView.swift:

picker.preferredExtension = "com.streamgate.StreamGate.ScreenBroadcastExtension"

---

5. Configure FastPix Credentials

Add your FastPix credentials in UploadService.swift:

let accessTokenID   = "YOUR_TOKEN_ID"
let secretKey = "YOUR_SECRET_KEY"

For production builds, store credentials securely using environment variables or xcconfig files. Never commit credentials to version control.

To get your FastPix API credentials visit: Activate Your Account

---

6. Required Permissions

Add the following permissions to the main application's Info.plist:

<key>NSCameraUsageDescription</key>
<string>Used to record videos.</string>

<key>NSMicrophoneUsageDescription</key>
<string>Used to record audio.</string>

---

7. Build & Run

Using Xcode

1. Open StreamGate.xcodeproj
2. Select a physical iPhone as the run destination
3. Ensure your Apple Developer Team is selected for both:
   • StreamGate
   • ScreenBroadcastExtension
4. Verify App Groups are enabled on both targets:
   • group.com.streamgate.broadcast
5. Build and run:

Product → Clean Build Folder
Product → Build
Product → Run

Important Reference Links

• FastPix Platform: fastpix.io
• FastPix Access Token Guide: Activate Your Account
• FastPix VOD Upload API Docs: Direct Upload Video Media
• FastPix iOS Uploads SDK: FastPix/iOS-Uploads
• Apple ReplayKit Docs: ReplayKit — Apple Developer

---

License

StreamGate is licensed under the MIT License.