**This is no longer maintained. I recommend moving over to https://github.com/kineticman/FastChannels

Pluto for Channels

Version 1.27

Changes

• Version 1.27:
  • Improved error logging: Pluto request failures now include the underlying exception message, making DNS, timeout, TLS, and other connectivity problems easier to diagnose.
• Version 1.26:
  • EPG startup failure handling: Prevented scheduler crashes when Pluto boot or EPG requests fail during startup or refresh.
  • Startup network wait: Added a bounded Pluto network readiness check before the initial EPG run.
• Version 1.25:
  • Stream pool env var: Default simultaneous streams increased to 15 and can now be configured with PLUTO_STREAM_POOL_SIZE without editing Python files.
• Version 1.24:
  • PLUTO_START support: Added PLUTO_START environment variable to offset all channel numbers by a fixed amount. Useful for avoiding collisions with other sources in Channels DVR.
  • DRM fix: Cleared drmCapabilities declaration which was causing false-positive DRM detection on some clients.
• Version 1.23:
  • Multi-stream fix: Replaced single hardcoded clientID with a rotating pool of virtual device sessions. Each concurrent stream now uses a unique clientID, bypassing Pluto TV's single-stream-per-device limitation. Pool size defaults to 10 simultaneous streams and is configurable via STREAM_POOL_SIZE in pluto.py.
• Version 1.22:
  • Added styling to Playlist page and a copy link.
• Version 1.21b:
  • Added Pluto Germany.
• Version 1.21:
  • Added support for PLUTO_USERNAME and PLUTO_PASSWORD environment variables.

Credits

• jgomez177 — Original project. Built the Pluto TV M3U/EPG integration for Channels DVR.
• nuken — Added authentication support (PLUTO_USERNAME / PLUTO_PASSWORD) after Pluto TV introduced mandatory account login.
• kineticman — Multi-stream fix. Introduced the rotating clientID session pool allowing multiple simultaneous streams without one killing another.

Running

Use single quotes around the username and password to avoid conflicts.

docker run -d --restart unless-stopped --network=host -e PLUTO_PORT=[your_port_number_here] -e PLUTO_USERNAME='your_username' -e PLUTO_PASSWORD='your_password' -e PLUTO_STREAM_POOL_SIZE=15 --name pluto-for-channels kineticman/pluto-for-channels:main

or

docker run -d --restart unless-stopped -p [your_port_number_here]:7777 -e PLUTO_USERNAME='your_username' -e PLUTO_PASSWORD='your_password' -e PLUTO_STREAM_POOL_SIZE=15 --name pluto-for-channels kineticman/pluto-for-channels:main

You can retrieve the playlist and EPG via the status page.

http://127.0.0.1:[your_port_number_here]

docker-compose.yml

version: '3.8'

services:
  pluto-for-channels:
    image: kineticman/pluto-for-channels:main
    container_name: pluto-for-channels
    restart: unless-stopped
    ports:
      # Map your desired host port to the container's port 7777
      - "7777:7777"
    environment:
      # Your Pluto TV username. Use single quotes if it contains special characters.
      PLUTO_USERNAME: YOUR_USERNAME
      # Your Pluto TV password. Use single quotes if it contains special characters.
      PLUTO_PASSWORD: YOUR_PASSWORD
      # Optional: Default simultaneous stream pool size.
      # Default: 15
      PLUTO_STREAM_POOL_SIZE: 15
      # Optional: Customize the country codes.
      # Default: 'local,us_east,us_west,ca,uk,fr,de'
      PLUTO_CODE: local,us_east,us_west,ca,uk,fr,de

Run docker compose up -d in terminal.

How to Use in Portainer

1. In Portainer, navigate to Stacks.
2. Click Add stack.
3. Give it a name (e.g., pluto).
4. Choose the Web editor option.
5. Paste the docker-compose.yml content from above into the editor.
6. Important: Edit the environment variables for PLUTO_USERNAME and PLUTO_PASSWORD with your credentials. You can also change the host port if 7777 is already in use on your system.
7. Click Deploy the stack.

Portainer will now pull the image and create the container with all your specified settings.

Environment Variables

Environment Variable	Description	Default
PLUTO_PORT	Port the API will be served on. You can set this if it conflicts with another service in your environment.	7777
PLUTO_USERNAME	Your Pluto TV username.
PLUTO_PASSWORD	Your Pluto TV password.
PLUTO_STREAM_POOL_SIZE	Maximum number of simultaneous Pluto stream device sessions to keep in the rotation pool. Increase if you need more concurrent streams.	15
PLUTO_START	Offset added to all channel numbers. Useful for avoiding collisions with other sources in Channels DVR. Note: applies before per-country offsets (CA +6000, UK +7000, etc.) when using the all playlist.	0
PLUTO_CODE	What country streams will be hosted. Multiple can be hosted using comma separation ALLOWED_COUNTRY_CODES: us_east - United States East Coast, us_west - United States West Coast, local - Local IP address Geolocation, ca - Canada, uk - United Kingdom, fr - France, de - Germany	local,us_west,us_east,ca,uk

Additional URL Parameters

Parameter	Description
channel_id_format	default channel-id is set as "pluto-{slug}". "id" will change channel-id to "pluto-{id}". "slug_only" will change channel-id to "{slug}".

Multi-Stream Configuration

By default, 15 simultaneous streams are supported. To change this, set PLUTO_STREAM_POOL_SIZE when starting the container:

docker run -d --restart unless-stopped --network=host \
  -e PLUTO_PORT=[your_port_number_here] \
  -e PLUTO_USERNAME='your_username' \
  -e PLUTO_PASSWORD='your_password' \
  -e PLUTO_STREAM_POOL_SIZE=30 \
  --name pluto-for-channels \
  kineticman/pluto-for-channels:main

Each pool slot authenticates independently as a separate virtual device. Tokens are cached and refreshed every 4 hours, so the overhead of a larger pool is minimal.