flatheade/plex_wol_py repository overview

⁠Plex Wake-on-LAN Monitor

A Docker container that monitors Plex Media Server traffic on a Ubiquiti Dream Machine Pro and automatically wakes up a designated device using Wake-on-LAN when activity is detected.

⁠Features

• Monitors Plex Media Server traffic (port 32400)
• Automatically sends Wake-on-LAN packets when needed
• Supports UDM Pro integration
• Built-in cooldown system to prevent WoL spam
• Configurable through YAML
• Rotational logging system
• Docker-optimized

⁠Quick Start

# config.yaml
udm:
  ip: "192.168.1.1"         # Your UDM Pro IP
  user: "root"              # SSH username
  password: "password"      # SSH password

device:
  mac_address: "00:11:22:33:44:55"  # Device to wake
  tcpdump_command: "tcpdump -i any port 32400 | grep -v \"IP2\""

settings:
  wol_cooldown: 60          # Seconds between WoL attempts
  recent_logs_limit: 10     # Number of logs to keep

# Run the container
docker run -d \
  --name plex-wol \
  --network host \
  -v $(pwd)/config.yaml:/app/config.yaml \
  flatheade/plex_wol_py:latest

⁠Requirements

• Ubiquiti Dream Machine Pro
• SSH access to UDM Pro
• Device with Wake-on-LAN enabled
• Docker with host networking capability

⁠Configuration

⁠Required Configuration

• UDM Pro credentials
• Target device MAC address
• Network settings

⁠Optional Settings

• WoL cooldown period
• Logging preferences
• Monitor intervals

⁠Features

• Automatic device wake-up
• Smart state monitoring
• Cooldown system
• Rotational logging
• Activity monitoring

⁠Security Notes

• Uses SSH for UDM Pro communication
• Requires root access for network monitoring
• Supports custom configurations
• Host network access required

⁠Support

For issues and feature requests, please visit the GitHub repository.

⁠Tags

• latest: Most recent stable release
• v1.0: Initial release with basic functionality

⁠Contributing

Contributions are welcome! Please feel free to submit a Pull Request.