Guide for OSX
Some information may not be applicable to older versions of OS X.
Installing the bot on OSX requires the downloading of several libraries. These libraries are best managed with Homebrew. Homebrew and a basic text editor are required for this MusicBot to function.
Let's get everything ready to install.
If you do not have a text editor, download a basic text editor from the Apple App Store (TextWrangler, or equivalent) or download an outside editor such as Atom.
Following that, you will install Homebrew
To install Homebrew open up Terminal.app found on your computer and copy+paste the following command then press RETURN:
/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
Run brew update to fetch the latest package data.
###1.c: Installing xcode-select
In order for the bot to function properly you need to install xcode command line tools to your mac. You will do this in Terminal.app by running the following command line:
xcode-select --install
A dialog box will open asking if you want to install xcode-select. Select install and finish the installation.
###1.d: Installing Python
Next, you need to install Python3.5 or later. ClickHere to start downloading Python3.5.1.
After downloading, open the python-3.5.1-macosx10.6.pkg you downloaded to begin installation.
This will be the first thing you see when it opens.
Click Continue.
Click Continue.
Read the Software License Agreement then Click Continue
Click Agree.
Choose your installation destination (Recommended: Downloads), then Click Install.
After the installation screen you will see this... Click Close.
Congratulations you have successfully installed Python3.5!!
To install dependencies, enter the following commands in Terminal.app:
brew install git
brew install ffmpeg
brew install opus
brew install libffi
brew install libsodium
To get the latest version of MusicBot, run this command using Terminal.app:
cd desktop
git clone https://github.com/SexualRhinoceros/MusicBot.git MusicBot -b master
cd
cd'ing to the desktop allows you to quickly find your MusicBot folder as it places the folder directly on your desktop.
###2.a: Allowing Terminal to Run Files
In order for Terminal.app to run the .command files needed for the bot you will need to do the following:
In Terminal.app type the command below followed by a space:
chmod +x
Click and drag the file update_macdeps.command into terminal then press RETURN.
Repeat the above for the runbot_mac.command file. You should then be able to double-click the command files to run the bot.
Example:
Run the following file that is located in your MusicBot's main folder.
Run this file:
update_macdeps.command
You may have to right click the file, mouse over 'Open With' then select 'Terminal.app'
This installs the various python dependencies used by the bot.
At this point you should create a bot account and add it to your server.
Inside the bot's folder is another folder called config. Open it, and then open the example_options.ini file. This is the file containing the bot's settings. All options are explained in the file. Make sure you save the file as options.ini after editing. If you need help, read the configuration page.
In the main folder (called MusicBot), double-click update_macdeps.command to install the required Python dependencies. After it is finished, you can close the window and then double-click runbot_mac.command to run the bot.
If you close the Terminal, your bot will stop working. This window is required to be open for the bot to run. The bot will also stop if you turn your computer off, sleep, or hibernate it. To avoid these issues, you can buy a dedicated server.
You don't need to do anything else! 😄 You can check out the command list to find out how to use your bot. If you have further questions please visit our Help Server on Discord.