← Directory

PhantomBot

PhantomBot is an open-source Java chatbot for Twitch.

  • Other
  • Tools & Utilities
PhantomBot is an open-source Java chatbot for Twitch. It automates moderation, custom commands, points, raffles, games, music requests, and web-based configuration. Streamers and self-hosters use it to extend their Twitch channel with integrated services and third-party modules.

Platform availability

Available on 1 of 6 install platforms

  • Unraid
  • TrueNAS (not listed)
  • Umbrel (not listed)
  • ZimaOS (not listed)
  • Proxmox (not listed)
  • Helm (not listed)

Also on Docker Hub and GitHub

Health score

69/100 Good

Maintained
100last commit 6 days ago
Popular
59846 GitHub stars
Easy to install
351 install platform, install notes, Docker image
Light to run
502 GB minimum RAM
How is this calculated?

A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). Factors without data are left out and the rest are rescaled.

Availability: platform listings confirmed today, links checked 11 days ago

GitHub stars
846
Open issues
22
Last commit
2026-10-03
Latest release
v3.22.0.2
License
GPL-3.0
Activity
declining

Checked 2 days ago - source: GitHub (phantombot/PhantomBot)

Resources & Compatibility

Minimum requirements: 2 GB RAM, 1 CPU core(s).

Checked 10 days ago - source: Docker Hub image tags and published docs

First-install notes

  • First launch Create botlogin.txt in the PhantomBot appdata folder after the first launch, restart the container, then clear the HTTPS fields in the web panel. source

Fetched 6 days ago - each note links to its source

Alternatives (3)

  • StreamElements - The Ultimate All in One Platform for Streamers - Provides a chatbot, overlays, a loyalty system, and more.
  • Streamer.bot - Streamer.bot is a local bot, meaning all connections are made directly from your local PC to any configured external services, such as Twit…
  • TikFinity - TikFinity is an advanced and powerful streaming tool designed specifically for TikTok LIVE.

Checked 7 days ago - source: AlternativeTo

Common questions

How do I get the web panel login credentials after initial setup?

Click Bot Setup and OAuth, then look in the terminal window for the auto-generated username and password shown on the login page.

What extra step is needed after the first launch when using the Unraid container?

Create botlogin.txt in the PhantomBot appdata folder, restart the container, then clear the HTTPS fields in the web panel.

What file permissions do I need when running from the extracted release on Linux or macOS?

Apply execute permissions to launch.sh, and also apply execute permissions to launch-service.sh if you plan to run the bot as a background service.

Have self-hosters had trouble exposing PhantomBot through a reverse proxy?

Users have discussed issues with PhantomBot in the Nginx Proxy Manager community, while one person reported making the web interface accessible from a subdomain with plain Nginx.

Answers sourced from ca.unraid.net, github.com, www.reddit.com

Community

Collected 10 days ago - public community threads