macOS Setup Guide


So, you want to setup PhantomBot on your Mac? Great! Please follow the steps below. If you have any questions, feel free to ask on the forums! Note, the version might not be the same as the current version in this guide.

  1. You will need a Twitch account for your bot. Create one here.

  2. Once you have the account, you will need to get a oauth token from Twitch Apps. This will allow the bot to login to your newly created Twitch account.

  3. Once you connect with Twitch on that page it will give you a oauth token, make sure to copy it. (include the oauth: part, also make sure you’re still connected with the bot account you created)

Make sure you mod the bot in your channel or it will not talk in chat. /mod my_bot_name.

Detailed instructions based on OS X 10.11.4

  1. Install Java 8 SE Development Kit for Mac OS X if you don’t have it yet.

  2. Download the bot from here.

  3. Open the Finder and go to your Downloads folder.

  4. Move the to your Documents. - Note replace x.x with the current bot version.

  5. To extract the just double-click it. - Note replace x.x with the current bot version.

  6. Start the Terminal app and run the following commands.

cd Documents/
mv PhantomBot-x.x PhantomBot - Note replace `x.x` with the current bot version.
cd PhantomBot/
chmod u+x
chmod u+x
  1. Once that’s done, launch PhantomBot.
  1. Follow the steps on screen. It will ask you for the bot username, use the username you created earlier.
    After that it will ask you for a oauth token, paste the one you got from Twitch Apps.
    After that enter the channel you wish the bot to join. (Your channel)
    And now your bot should be connected to your channel! You can find a list of commands for the bot here.

  2. Type exit and hit Enter in the bot console to shut it down gracefully.

Launch PhantomBot faster

  • go to Documents/PhantomBot -> right-click -> “Open With” -> “Other…” -> search for Terminal and select it -> check “Always Open With” -> hit “Open”
  • next time you wanna launch it: go to Documents/PhantomBot -> right-click -> “Open” -> click “Open”
  • next time you wanna launch it: go to Documents/PhantomBot -> just double-click

I need help with the bot or download thing
Phantombot clean install
Follower alerts?
Ich benötige Hilfe beim starten des Bots
Don't get how to launch the bot on osx