macreplayv2

macreplayv2

Docker app from T4s3rF4c3's Repository

Overview

MacReplayV2 is an improved IPTV portal proxy that allows you to manage and stream IPTV channels with advanced features like enhanced channel editing, EPG support, MAC address rotation, smart fallback systems, and portal management. Perfect for integrating with Plex or M3U-based media software.

MacReplayV2

MacReplayV2 is a lightweight IPTV portal proxy packaged for Docker on Unraid. This repository exists purely as a test sandbox, so expect limited polish and no formal support.

This codebase is an adaptation/extension of the original Evilvir-us/MacReplay project. All credit for the foundational work goes to the original author; this fork simply layers on adjustments, updates, and experimental features.

MacReplay is an improved version of STB-Proxy, designed for seamless connectivity between MAC address portals and media platforms like Plex / JellyFin or M3U-based software.

Snapshot

  • Multi-portal management with MAC rotation and basic EPG ingestion
  • Channel editor with duplicate cleanup, fallback chains, and quick filters
  • Single web UI on port 8001 that exposes dashboard, portals, editor, and settings views
  • Generates M3U and XMLTV outputs for Plex or any M3U-compatible player

Quick Start on Unraid

Manual Template Installation

  1. Download the my-macreplayv2.xml template file from this repository.
  2. Copy it to your Unraid server at: /boot/config/plugins/dockerMan/templates-user/
  3. In Unraid WebUI, navigate to APPSPrevious Apps → search for "MacReplayV2"
  4. Select the Container and click ActionsReinstall to create the container.
  5. Wait for the container to start, then open http://YOUR-UNRAID-IP:8001 in your browser.

First Steps

  • Navigate to the Portals tab and add your IPTV provider endpoint.
  • Supply one or more MAC addresses (or leave for auto-detection).
  • Click Test to verify connectivity.
  • Visit the Channel Editor to manage, filter, and enable/disable streams.
  • Use the Downloads menu to grab the M3U and XMLTV outputs for your media player.

Minimal Configuration

Setting Value Notes
Ports 8001/tcp Web dashboard + API
Volumes /mnt/user/appdata/macreplayv2/data:/app/data
/mnt/user/appdata/macreplayv2/logs:/app/logs
Persist config and logs
Env Vars PUID=99, PGID=100, TZ=Europe/Berlin (adjust as needed) Match your Unraid user/group
XMLTV refresh 4-hour background loop (override via EPG_REFRESH_INTERVAL_HOURS) Keeps Jellyfin guides up to date

Daily Use

  1. Portals tab – add the IPTV endpoint, supply one or more MAC addresses, and verify connectivity.
  2. Editor tab – filter channels, toggle enablement, and define fallback lists.
  3. Integrations – consume http://YOUR-IP:8001/playlist.m3u8 for streams and http://YOUR-IP:8001/epg.xml for guide data.

Maintenance Cheatsheet

# Tail logs
docker logs macreplayv2 -f

# Update test container
cd /mnt/user/appdata/macreplayv2
docker-compose -f docker-compose-unraid.yml down
git pull
docker-compose -f docker-compose-unraid.yml up -d --build

# Reset configuration
docker stop macreplayv2
rm /mnt/user/appdata/macreplayv2/data/MacReplayV2.json
docker start macreplayv2

Screenshots

Showcase your MacReplayV2 setup by adding screenshots here:

Dashboard

Dashboard

Portals Management

Portals Tab

Channel Editor

Channel Editor

Settings

Settings

Status

Experimental test project. Use at your own risk and do not rely on it.

License

This project is licensed under the MIT License – see the LICENSE file for details.

This codebase builds upon the original work from:

All credit for foundational contributions goes to the original authors.

Install Macreplayv2 on Unraid in a few clicks.

Find Macreplayv2 in Community Apps on your Unraid server, review the template, and click Install. Unraid handles the Docker app or plugin setup from the published template.

Open the Apps tab on your Unraid server Search Community Apps for Macreplayv2 Review the template variables and paths Click Install

Related apps

Explore more like this

Explore all

Details

Repository
ghcr.io/t4s3rf4c3/macreplay_v2:latest
Last Updated2026-07-15
First Seen2025-12-03

Runtime arguments

Web UI
http://[IP]:[PORT:8001]
Network
bridge
Shell
bash
Privileged
false
Extra Params
--restart=unless-stopped

Template configuration

WebUI PortPorttcp

Web interface port

Target
8001
Default
8001
Value
8001
Data DirectoryPathrw

Application data directory

Target
/app/data
Default
/mnt/user/appdata/macreplayv2/data
Value
/mnt/user/appdata/macreplayv2/data
Logs DirectoryPathrw

Application logs directory

Target
/app/logs
Default
/mnt/user/appdata/macreplayv2/logs
Value
/mnt/user/appdata/macreplayv2/logs
PUIDVariable

User ID (99 = nobody)

Default
99
Value
99
PGIDVariable

Group ID (100 = users)

Default
100
Value
100
TimezoneVariable

Timezone

Target
TZ
Default
Europe/Berlin
Value
Europe/Berlin
Python UnbufferedVariable

Python unbuffered output

Target
PYTHONUNBUFFERED
Default
1
Value
1