Xtreme IPTV Player - Rust Edition

A fast, lightweight, cross-platform IPTV player with Xtream Codes API support built in Rust.

Features

• 🔐 Xtream Codes API - Full support for login, live TV, movies, and series
• 📺 Live TV - Browse categories and play live streams
• 🎬 Movies & Series - Browse VOD content with seasons/episodes
• ⭐ Favorites - Star your favorite channels for quick access
• 📚 Address Book - Save multiple server credentials
• 🔍 Search - Filter channels and content
• 🎨 Dark/Light Mode - Toggle UI theme
• 🎮 Hardware Acceleration - GPU-accelerated video decoding
• 🌐 User Agent Spoofing - 35+ preset user agents
• 📶 Connection Quality Presets - Optimized buffering for your connection
• 🖥️ Multi-Player Support - VLC, mpv, ffplay, and more
• 💾 Save State - Remember login and settings
• 📋 M3U Support - Parse and play M3U/M3U8 playlists
• 🖱️ Single Window Mode - Auto-close previous player

Screenshots

Supported Platforms

| Platform | Architecture | Status | Binary | |----------|--------------|--------|--------| | Windows | x64 (Intel/AMD) | ✅ Optimized | xtreme_iptv_windows_x64.exe | | Windows | ARM64 (Snapdragon) | ✅ Optimized | xtreme_iptv_windows_arm64.exe | | Linux | x64 (Intel/AMD) | ✅ Optimized | xtreme_iptv_linux_x64 | | Linux | ARM64 (RPi, Snapdragon) | ✅ Optimized | xtreme_iptv_linux_arm64 | | Linux | RISC-V 64 | ✅ Optimized | xtreme_iptv_linux_riscv64 | | macOS | x64 (Intel) | ✅ Optimized | xtreme_iptv_macos_x64 | | macOS | ARM64 (Apple Silicon) | ✅ Optimized | xtreme_iptv_macos_arm64 | | macOS | Universal | ✅ Fat Binary | xtreme_iptv_macos_universal |

CPU Optimizations

| Platform | Optimizations | |----------|---------------| | Windows/Linux x64 | AVX, AVX2, BMI1, BMI2, FMA, LZCNT, POPCNT (x86-64-v3) | | Windows/Linux ARM64 | NEON, AES, SHA2, CRC32, LSE, FP16, DotProd (Snapdragon/Apple Silicon optimized) | | Linux RISC-V 64 | RV64GC (General + Compressed + Multiply + Atomic + Float + Double) | | macOS x64 | AVX, AVX2 (x86-64-v3) | | macOS ARM64 | Apple M1/M2/M3/M4 optimized (NEON, AES, SHA2, CRC32, LSE, FP16, DotProd) |

Supported Hardware

| Platform | Devices | |----------|---------| | Windows ARM64 | Snapdragon X Elite/Plus, Snapdragon 8cx, Microsoft SQ3, Surface Pro X | | Linux ARM64 | Raspberry Pi 4/5, NVIDIA Jetson, Apple Silicon (Asahi), Ampere Altra, AWS Graviton | | Linux RISC-V | StarFive VisionFive 2, SiFive HiFive, Milk-V Mars/Pioneer, LicheeRV | | macOS ARM64 | MacBook Air/Pro (M1/M2/M3/M4), Mac Mini, Mac Studio, iMac, Mac Pro | | macOS x64 | Intel MacBook, iMac, Mac Mini, Mac Pro (2012-2020) |

Installation

Via npm (Easiest)

# Global install
npm install -g xtream-rust

# Run
xtreme-iptv

# Or run directly without installing
npx xtream-rust

Pre-built Binaries

Download from the Releases page.

Build from Source

Prerequisites

• Rust 1.70+
• For Windows cross-compile: mingw-w64
• For Windows ARM64 cross-compile: llvm-mingw

Build Commands

# Linux x64
./build.sh linux

# Linux ARM64 (Raspberry Pi, Snapdragon, etc.)
./build.sh linux-arm

# Linux RISC-V 64
./build.sh linux-riscv

# Windows x64 (cross-compile from Linux)
./build.sh windows

# Windows ARM64 (cross-compile from Linux)
./build.sh windows-arm

# macOS x64 (Intel) - requires macOS
./build.sh macos

# macOS ARM64 (Apple Silicon) - requires macOS
./build.sh macos-arm

# macOS Universal binary (x64 + ARM64) - requires macOS
./build.sh macos-universal

# All Linux platforms
./build.sh all-linux

# All Windows platforms
./build.sh all-windows

# All macOS platforms (requires macOS)
./build.sh all-macos

# Everything (all platforms)
./build.sh everything

# Show help
./build.sh help

Install Dependencies (Linux)

# Ubuntu/Debian - x64 cross-compile tools
sudo apt install mingw-w64

# Ubuntu/Debian - ARM64 cross-compile tools
sudo apt install gcc-aarch64-linux-gnu

# Ubuntu/Debian - RISC-V cross-compile tools
sudo apt install gcc-riscv64-linux-gnu

# Fedora
sudo dnf install mingw64-gcc gcc-aarch64-linux-gnu gcc-riscv64-linux-gnu

# Arch
sudo pacman -S mingw-w64-gcc aarch64-linux-gnu-gcc riscv64-linux-gnu-gcc

macOS Cross-Compilation (from Linux)

To cross-compile for macOS from Linux, you need OSXCross:

# Clone OSXCross
git clone https://github.com/tpoechtrager/osxcross
cd osxcross

# Download Xcode SDK (requires Apple Developer account)
# Place SDK in osxcross/tarballs/

# Build OSXCross
./build.sh

# Add to PATH
export PATH="$PWD/target/bin:$PATH"

Alternatively, build natively on a Mac for best results.

Usage

Quick Start

1. Launch the application
2. Enter your Xtream Codes server details:
   • Server: http://yourserver.com:port
   • Username: your username
   • Password: your password
3. Click Login
4. Browse Live TV, Movies, or Series
5. Double-click a channel to play

Player Configuration

Enter your preferred media player in the Player field:

| Player | Value | Notes | |--------|-------|-------| | VLC | vlc | Auto-detected on Windows | | mpv | mpv | Recommended, best performance | | ffplay | ffplay or leave empty | Default player | | Custom | Full path | e.g., C:\Program Files\VLC\vlc.exe |

Connection Quality Presets

| Preset | Buffer | Best For | |--------|--------|----------| | ⚡ Fast | 2s | Fiber, high-speed connections | | 📶 Normal | 5s | Standard broadband | | 🐢 Slow | 15s | DSL, congested networks | | 🦥 Very Slow | 30s | Mobile, satellite, poor connections | | ⚙️ Custom | 1-120s | Manual configuration |

Hardware Acceleration

Enable HW Acceleration checkbox to use GPU video decoding:

| Platform | Decoder | |----------|---------| | Windows | DXVA2 / D3D11VA | | Linux | VA-API / VDPAU | | macOS | VideoToolbox |

Disable if you experience playback issues with certain streams.

Keyboard Shortcuts

| Key | Action | |-----|--------| | Enter | Play selected channel | | Escape | Go back | | Ctrl+F | Focus search | | Ctrl+S | Save settings |

Configuration

Settings are stored in:

| Platform | Location | |----------|----------| | Windows | %APPDATA%\xtreme_iptv\config.json | | Linux | ~/.config/xtreme_iptv/config.json | | macOS | ~/Library/Application Support/xtreme_iptv/config.json |

Config Options

{
  "external_player": "vlc",
  "buffer_seconds": 5,
  "connection_quality": "Normal",
  "dark_mode": true,
  "hw_accel": true,
  "single_window_mode": true,
  "save_state": true,
  "pass_user_agent_to_player": true
}

Troubleshooting

VLC won't start

• Use full path: C:\Program Files\VideoLAN\VLC\vlc.exe
• Or add VLC to system PATH

Video buffering/stuttering

1. Increase buffer: Change Connection to Slow or Very Slow
2. Try different player (mpv often performs better)
3. Disable HW Acceleration if GPU issues

Hardware acceleration errors

hardware acceleration picture allocation failed

• Uncheck HW Acceleration to use CPU decoding
• Update GPU drivers

Stream won't play

• Check User Agent settings
• Try different User Agent preset
• Verify stream URL works in browser

Building with Internal Player (Optional)

The internal FFmpeg player is optional and requires FFmpeg development libraries:

# Install FFmpeg dev libs (Linux)
sudo apt install libavcodec-dev libavformat-dev libavutil-dev libswscale-dev pkg-config clang

# Build with internal player
./build.sh linux --internal-player

Note: Internal player is video-only (no audio) and mainly for testing.

License

MIT License - See LICENSE for details.

Credits

• Built with egui - Immediate mode GUI
• eframe - Native framework
• Rust community for excellent crates

Contributing

Contributions welcome! Please open an issue or PR.

Disclaimer: This software is for personal use with legally obtained IPTV subscriptions only. The developers are not responsible for misuse.