Download

IPTVX Media Server

Run your media server anywhere.

IPTVX Media Server lets you record, stream, and organize your library with the same elegant experience you expect from IPTVX. Install it on a NAS or on your Mac, then access it locally or remotely with secure access.

Install on NAS Install on Mac
IPTVX Media Server dashboard

Mac install

Run IPTVX Media Server on macOS.

Download from the Mac App Store and keep the same server experience everywhere.

Mac App Store

Install the dedicated IPTVX Media Server app and start recording instantly.

Download on Mac App Store

The Mac server uses the same commands and UI as the NAS version.

Troubleshooting

  1. Make sure that if your mac firewall is active you need to enable incoming connections for IPTVX Server in System Settings → Network → Firewall → Options.
  2. On your router, forward the same port to your Mac’s local IP address.
  3. If the port is occupied, change it from IPTVX Media Server settings.

Connect IPTVX to your server

Quick walkthrough to pair the app with your IPTVX Server.

NAS install

Install IPTVX NAS Server via SSH packages.

Choose Synology SPK or the Linux multi-arch package. Docker is not required.

Packages (v0.1.0)

Download the package for your NAS, upload it to your device, then install over SSH.

Download Synology SPK Download Linux multi-arch
SPK SHA-256
e03fbc3325a2360233ff62e8566815fc683efa4797c188ffc6f47f79c754e7ee
Linux tar.gz SHA-256
(update after build)

Optional verify on NAS after upload:

sha256sum /path/to/iptvx-server-0.1.0-noarch.spk
sha256sum /path/to/iptvx-server-0.1.0-linux-multiarch.tar.gz

Synology DSM 7 (SPK via SSH)

  1. Enable SSH in DSM: Control Panel -> Terminal & SNMP -> Enable SSH service.
  2. Upload iptvx-server-0.1.0-noarch.spk to your NAS.
  3. SSH into NAS and install package:
ssh <YOUR_USER>@<NAS_IP>
sudo synopkg install /volume1/homes/<YOUR_USER>/Downloads/iptvx-server-0.1.0-noarch.spk
sudo synopkg start iptvx-server

Server installed. Open UI at http://<NAS_IP>:9090/.

Default storage: /volume1/@appdata/iptvx-server/ and /volume1/@appdata/iptvx-server/recordings/.

Logs and stop:

sudo tail -f /var/packages/iptvx-server/var/server.log
sudo tail -f /var/log/synopkg.log
sudo synopkg stop iptvx-server

Generic Linux NAS (tar.gz via SSH)

Works on x86_64, arm64, armv7 when custom binaries are allowed.

  1. SSH into NAS and go where you want to create the server folder (example: cd ~).
  2. Extract the package and open the extracted folder.
  3. Start the server.
ssh <YOUR_USER>@<NAS_IP>
cd ~
tar -xzf /path/to/iptvx-server-0.1.0-linux-multiarch.tar.gz
cd iptvx-server
chmod +x ./start.sh
./start.sh

Server installed. Open UI at http://<NAS_IP>:9090/.

Logs and stop:

tail -f server.log
pkill -f iptvx-server

Updates

Upgrade and maintenance (SSH packages).

Run these updates after the NAS package installation flow above.

Synology SPK upgrade

  1. Upload the new SPK package to your NAS.
  2. SSH into NAS and run:
ssh <YOUR_USER>@<NAS_IP>
sudo synopkg stop iptvx-server
sudo synopkg uninstall iptvx-server
sudo synopkg install /volume1/homes/<YOUR_USER>/Downloads/iptvx-server-0.1.0-noarch.spk
sudo synopkg start iptvx-server
sudo synopkg status iptvx-server

Keep data and recordings in place: /volume1/@appdata/iptvx-server/.

Linux tar.gz update

  1. Stop current process and keep your existing config.env.
  2. Extract the new package and restart start.sh.
ssh <YOUR_USER>@<NAS_IP>
pkill -f iptvx-server
mkdir -p ~/iptvx-server-update
cd ~/iptvx-server-update
tar -xzf /path/to/iptvx-server-0.1.0-linux-multiarch.tar.gz
cd iptvx-server
chmod +x ./start.sh
nohup ./start.sh > server.log 2>&1 &
ss -ltnp | grep :9090 || netstat -ltnp | grep :9090

Change NAS config and port

At the moment on NAS, the port cannot be changed from the web UI: update it in config.env.

For Synology SPK:

sudo synopkg stop iptvx-server
sudo sh -c "sed -i -E 's/^PORT=.*/PORT=9091/' /var/packages/iptvx-server/target/config.env"
sudo synopkg start iptvx-server
curl -i http://<NAS_IP>:9091/api/status

Configurable values in the same file:

  • PORT
  • TOKEN
  • RECORDINGS_DIR
  • ENABLE_UI

For Linux tar.gz package:

  • edit config.env in the installed folder
  • set PORT=...
  • restart with start.sh
cd ~/iptvx-server/iptvx-server
sed -i -E 's/^PORT=.*/PORT=9091/' config.env
nohup ./start.sh > server.log 2>&1 &
curl -i http://<NAS_IP>:9091/api/status

After changing the port, remember to:

  • update the port in IPTVX client
  • update router port-forwarding (for external access)

What you get

Built for recording, streaming, and collections.

Recording & scheduling

Record live streams, manage scheduled programs, and monitor activity in real time.

Streaming & remote access

Stream recordings from the local network or externally using secure remote access.

Playlists & collections

Create personal media collections and playlists that can be shared across your devices.

Access

Local by default, remote when you need it.

Open the web UI without login on first access, then set a username and password inside settings.

Local network

Use your NAS or Mac IP address and the configured port to access the server from any device on the same network.

Remote access

When accessing from outside your network, use your public IP or DDNS with the configured port.