eef98fb361
Covers: how the autoloader works, adding new classes, cache invalidation, manual registration (addClass), adding new directories, naming rules, duplicate resolution, and debugging. Sidebar links added to both language versions of the Docsify site.
XC_VM IPTV Panel
Open-source, community-driven Xtream Codes panel
Built for modern IPTV workflows – powerful, scalable, and free.
📑 Table of Contents
📘 Contents
🚀 Overview
XC_VM is an open-source IPTV platform based on Xtream Codes. It enables:
- 📺 Live & VOD streaming
- 🔀 Load balancing
- 📊 Full user/reseller control
- 🎚️ Transcoding & EPG
- 🔐 Hardened security fixes
✅ 100% free. No license checks. No server locks.
⚠️ Status
BETA SOFTWARE — actively developed
📚 Documentation
-
🇬🇧 English Guide https://vateron-media.github.io/XC_VM/#/en-us/
-
🇷🇺 Руководство на русском https://vateron-media.github.io/XC_VM/#/ru-ru/
🧱 Technology Stack
| Component | Version | Description |
|---|---|---|
| PHP | 8.2 | Backend runtime |
| Nginx | 1.24 | Web server & reverse proxy |
| FFmpeg | 8.0, 7.1, 5.1, 4.4, 4.3, 4.0 | Media transcoding & processing |
| MariaDB | 11.4 | SQL database engine |
| KeyDB | 6.3.4 | Cache & session storage (Redis) |
| yt-dlp | 2025.07.21 | Audio/Video downloader |
🐧 Supported Ubuntu Versions
XC_VM officially supports the following Ubuntu LTS and interim releases:
| Ubuntu Version | Codename | Status |
|---|---|---|
| 20.04 | Focal Fossa | ⚠️ Outdated |
| 20.10 | Groovy Gorilla | ⚠️ Outdated |
| 22.04 | Jammy Jellyfish | ✅ Fully Supported |
| 22.10 | Kinetic Kudu | ⚙️ Compatible |
| 24.04 | Noble Numbat | ✅ Fully Supported |
| 24.10 | Oracular Oriole | 🧪 Under Testing |
💡 Recommendations
For new installations, the strongly recommended Ubuntu versions are:
- 🟢 Ubuntu 22.04 LTS
- 🟢 Ubuntu 24.04 LTS
These versions receive full support, active security updates, and provide the stability required for XC_VM.
⚠️ Important Note About Ubuntu 20.x
Ubuntu 20.04 and 20.10 are outdated and no longer receive updates for most essential system packages. Using these versions is still possible, but:
- 🛠️ Official support is discontinued — any issues must be resolved by the user.
- 🚫 Bugs caused by outdated dependencies or libraries will not be addressed by the XC_VM project.
📥 Quick Install
✅ Ubuntu 22.04 or newer
# 1. Update system
sudo apt update && sudo apt full-upgrade -y
# 2. Install dependencies
sudo apt install -y python3-pip unzip
# 3. Download latest release
latest_version=$(curl -s https://api.github.com/repos/Vateron-Media/XC_VM/releases/latest | grep '"tag_name":' | cut -d '"' -f 4)
wget "https://github.com/Vateron-Media/XC_VM/releases/download/${latest_version}/XC_VM.zip"
# 4. Unpack and install
unzip XC_VM.zip
sudo python3 install
🧰 Service Management
sudo systemctl start xc_vm # Start
sudo systemctl stop xc_vm # Stop
sudo systemctl restart xc_vm # Restart
sudo systemctl status xc_vm # Status
sudo /home/xc_vm/bin/nginx/sbin/nginx -s reload # Reload Nginx config
journalctl -u xc_vm -f # Live logs
📂 Project Structure
├─ docs/ # 📚 Project documentation
├─ lb_configs/ # ⚙️ Configurations for building Load Balancer (LB)
└─ src/ # 💻 Main project code
🧮 Server Requirements & Sizing
🔧 Minimum Specs
| Component | Recommendation |
|---|---|
| CPU | 6+ cores (Xeon/Ryzen) |
| RAM | 16–32 GB |
| Disk | SSD/NVMe, 480+ GB |
| Network | Dedicated 1 Gbps port |
| OS | Ubuntu 22.04+ (clean install) |
📊 Planning Formulae
- Bandwidth (Mbps) = Channels × Bitrate
- Max Users = Bandwidth ÷ Stream Bitrate
Example:
HD bitrate = 4 Mbps
1 Gbps = ~940 usable Mbps
→ Max Channels: 940 ÷ 4 = ~235
→ Max Users: 940 ÷ 4 = ~235
⚠️ 10 users watching the same channel = 10× bandwidth (unless caching or multicast used)
💻 RAM & CPU Usage
| Resource | Load per Stream |
|---|---|
| RAM | 50–100 MB |
| CPU (transcoded) | ~1 core |
✅ Features
- ✅ No server restrictions
- ✅ EPG importer
- ✅ VOD management
- ✅ User/reseller panel
- ✅ Security patches
- ✅ Clean UI
🔧 Known Limitations
- ❌ Requires Linux knowledge
- ❌ Community-based support
- ❌ Some bugs in transcoding module (in progress)
🤝 Contributing
We welcome community help!
📝 License
⚠️ Legal Disclaimer
🚫 This software is for educational purposes only. ⚖️ You are solely responsible for how it is used. We take no responsibility for misuse or illegal deployments.