# PhantomBot

PhantomBot is an open-source Java chatbot for Twitch. It is open source and self-hosted, installable on Docker Hub and Unraid.

Canonical page: https://ourlocalhost.com/app/286/phantombot

## Description

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 9 platforms: Unraid.

## Health score

69/100 (Good), based on 4 of 4 factors.
- Maintained: 100 (last commit 21 days ago)
- Popular: 59 (846 GitHub stars)
- Easy to install: 35 (1 install platform, install notes, Docker image)
- Light to run: 50 (2 GB minimum RAM)

## Links

- Docker Hub: https://hub.docker.com/r/gmt2001/phantombot-stable
- Unraid: https://ca.unraid.net/apps/phantombot-1-08efoai0q0ntdi?q=PhantomBot-1
- Official website: https://phantombot.dev
- GitHub: https://github.com/PhantomBot/PhantomBot

## 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.

## Alternatives

- StreamElements: The Ultimate All in One Platform for Streamers - Provides a chatbot, overlays, a loyalty system, and more.
- Streamer.bot: Streamer.bot is a free tool that lets you automate your live broadcasts.
- TikFinity: TikFinity is an advanced and powerful streaming tool designed specifically for TikTok LIVE.

---
Source: Our Local Host (https://ourlocalhost.com/app/286/phantombot), the self-hosted and open-source app directory.
