Welcome to the MKS-IPTV-App Developer Wiki – your comprehensive technical resource for understanding, developing, and contributing to this native Apple ecosystem IPTV client.

---

This Wiki contains deep technical documentation that goes beyond the basic README and user-facing GitHub Pages. Here you'll find:

• Internal API documentation for developers
• Architecture deep-dives and implementation details
• Advanced troubleshooting for complex issues
• Contributing guidelines with technical specifics
• Platform-specific implementation details

---

• 🏗️ Arquitectura y Diseño

  • Visión General de la Arquitectura: Patrones MVVM, concurrencia de Actores y diseño del sistema.
  • Documentación de la API: Referencia completa de todas las APIs públicas.
  • API de StreamManager: Inmersión profunda en la arquitectura de streaming.
  • Sistema de Descarga: Implementación del servidor HTTP y gestión de descargas.

• 🛠️ Desarrollo

  • Configuración del Entorno de Desarrollo: Guía completa para colaboradores.
  • Guía de Contribución: Flujo de trabajo y estándares técnicos.

• 🔧 Temas Avanzados

  • Resolución de Problemas: Depuración avanzada y resolución de problemas.
  • Preguntas Frecuentes (FAQ): Preguntas técnicas y detalles de implementación.
  • Notas de la Versión: Registros de cambios técnicos detallados.

• 🗺️ Mapa del Sitio

  • Mapa del Sitio: Lista jerárquica de todas las páginas de la wiki.

---

MKS-IPTV-App is a native multiplatform IPTV client that showcases modern Swift development:

• Swift 6.0 with structured concurrency and Actor-based architecture
• SwiftUI with platform-adaptive UI patterns
• iOS 26 Beta Liquid Glass design implementation
• Cross-platform codebase supporting iOS, macOS, and tvOS
• Advanced networking with HTTP proxy and stream management
• Local HTTP server for download management and offline playback

• StreamManager: Live stream handling and URL resolution
• DownloadManager: Reactive download system with progress tracking
• HTTPStreamServer: Local server for downloaded content streaming
• PlatformNavigationView: Adaptive cross-platform navigation
• TouchBarManager: Native macOS TouchBar integration

---

This project follows several key architectural principles:

• ViewModels handle business logic and state management
• Actors ensure thread-safe data access
• ObservableObject for reactive UI updates

• iOS: Tab bar navigation, Liquid Glass design patterns
• macOS: Sidebar navigation, TouchBar integration
• tvOS: Focus-based navigation optimized for remote control

• HTTP Proxy servers for AVPlayer compatibility with IPTV streams
• Automatic redirect resolution for reliable streaming
• Optimized headers for different IPTV service providers

---

We welcome contributions! Before you start:

1. Read the Contributing Guidelines
2. Set up your development environment using Development Setup
3. Understand the Architecture Overview
4. Follow our coding standards and Swift 6 patterns

---

• GitHub Issues: Technical bugs and feature requests
• GitHub Discussions: Architecture discussions and questions

• GitHub Pages: User documentation and downloads
• README: Quick start and basic information

---

• Swift 6 Concurrency Guide
• SwiftUI Documentation
• Apple Human Interface Guidelines
• MVVM Pattern in Swift

---

---