XC_VM IPTV Panel
Open-source, community-driven Xtream Codes panel
Built for modern IPTV workflows โ powerful, scalable, and free.
---
## ๐ 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
---
## ๐งฑ Technology Stack
| Component | Version | Description |
|------------|---------|---------------------------------|
| PHP | 8.2 | Backend runtime |
| Nginx | 1.24 | Web server & reverse proxy |
| FFmpeg | 8.0 | Media transcoding & processing |
| MariaDB | 10.6+ | SQL database engine |
| KeyDB | 6.3.4 | Cache & session storage (Redis) |
| yt-dlp | 2025.07.21 | Audio/Video downloader |
---
## ๐ฅ Quick Install
> โ
Ubuntu 22.04 or newer
```bash
# 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
```bash
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 systemctl reload nginx # Reload Nginx config
journalctl -u xc_vm -f # Live logs
```
---
## ๐ Documentation
* ๐ฌ๐ง [English Guide](doc/en/main-page.md)
* ๐ท๐บ [ะ ัะบะพะฒะพะดััะฒะพ ะฝะฐ ััััะบะพะผ](doc/ru/main-page.md)
---
## ๐ Project Structure
```text.
โโ 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 20.04+ (clean install) |
---
### ๐ Planning Formulae
* **Bandwidth (Mbps)** = Channels ร Bitrate
* **Max Users** = Bandwidth รท Stream Bitrate
```text
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!
* ๐ ๏ธ [Contributing Guide](CONTRIBUTING.md)
* ๐ฅ [Contributors List](CONTRIBUTORS.md)
---
## ๐ License
[AGPL v3.0](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.
---