NadekoBot/docs/guides/OSX Guide.md
Jordan Fearnley fc15f95fcb Minor Guide Updates
- Less saving of `credentials.json` required
- Only needing to use `credentials_example.json` if you fuck up
accounted for
- Restore and build in one swift move accounted for
2016-10-22 09:05:42 +01:00

7.0 KiB
Raw Blame History

Setting Up NadekoBot on OSX

Prerequisites

    1. Homebrew
    1. Google Account
    1. Soundcloud Account (if you want soundcloud support)
    1. Text Editor (TextWrangler, or equivalent) or outside editor such as Atom

####Installing Homebrew

/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"

Run brew update to fetch the latest package data.

####Installing dependencies

brew install git
brew install ffmpeg
brew update && brew upgrade ffmpeg
brew install openssl
brew install opus
brew install opus-tools
brew install opusfile
brew install libffi
brew install libsodium
brew install tmux

####Installing .NET Core SDK

  • ln -s /usr/local/opt/openssl/lib/libcrypto.1.0.0.dylib /usr/local/lib/
  • ln -s /usr/local/opt/openssl/lib/libssl.1.0.0.dylib /usr/local/lib/
  • Download the .NET Core SDK, found here.
  • Open the .pkg file you downloaded and install it.

####Check your FFMPEG

In case your FFMPEG wasnt installed properly

  • brew options ffmpeg
  • brew install ffmpeg --with-x --with-y --with-z etc.
  • brew update && brew upgrade (Update formulae and Homebrew itself && Install newer versions of outdated packages)
  • brew prune (Remove dead symlinks from Homebrews prefix)
  • brew doctor (Check your Homebrew installation for common issues)
  • Then try brew install ffmpeg again.

####Installing xcode-select Xcode command line tools. 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.

####Downloading and building Nadeko

  • cd ~
  • git clone -b 1.0 --recursive https://github.com/Kwoth/NadekoBot.git
  • cd ~/NadekoBot/
  • dotnet restore
  • cd ~/NadekoBot/src/NadekoBot/
  • dotnet build --configuration Release

####Creating DiscordBot application

  • Go to the Discord developer application page.
  • Log in with your Discord account.
  • On the left side, press New Application.
  • Fill out the App Name (your bot's name, in this case), put the image you want, and add an app description(optional).
  • Create the application.
  • Click on Create a Bot User and confirm it.
  • Keep this window open for now.

####Setting up Credentials.json file

  • Open up the NadekoBot folder, which should be in your home directory, then the src folder and then the additonal NadekoBot folder.
  • In our NadekoBot folder you should have .json file named credentials.json. (Note: If you do not see a .json after credentials.json , do not add the **.json**. You most likely have "Hide file extensions" enabled.)
  • If you mess up the setup of credentials.json, rename credentials_example.json to credentials.json.
  • Open the file with your Text editor.
  • In your applications page (the window you were asked to keep open earlier), under the Bot User section, you will see Token:click to reveal, click to reveal the token.
  • Copy your bot's token, and on the "Token" line of your credentials.json, replace null with your bot token and put quotation marks before and after the token, like so "Example.Token"
  • Copy the Client ID on the page and replace the null part of the ClientId line with it, and put quotation marks before and after, like earlier.
  • Again, copy the same Client ID and replace the null part of the BotId line with it, and do not put quotation marks before and after the ID.
  • Go to a server on discord and attempt to mention yourself, but put a backslash at the start as shown below
  • So the message \@fearnlj01#3535 will appears as <@145521851676884992> after you send the message (to make it slightly easier, add the backslash after you type the mention out)
  • Copy the numbers from the message you sent (145521851676884992) and replace the 0 on the OwnerIds section with your user ID shown earlier.
  • Save credentials.json (make sure you aren't saving it as credentials.json.txt)
  • If done correctly, you are now the bot owner. You can add multiple owners by seperating each owner ID with a comma within the square brackets.

####Running NadekoBot

tmux new -s nadeko

^this will create a new session named “nadeko”
(you can replace “nadeko” with anything you prefer and remember its your session name).

or if you want to use Screen, run:

screen -S nadeko

^this will create a new screen named “nadeko”
(you can replace “nadeko” with anything you prefer and remember its your screen name).

cd ~/NadekoBot/src/NadekoBot/

  • Start Nadeko using dotnet:

dotnet run --configuration Release

CHECK THE BOT IN DISCORD, IF EVERYTHING IS WORKING

Now time to move bot to background and to do that, press CTRL+B+D (this will ditach the nadeko session using TMUX)

If you used Screen press CTRL+A+D (this will detach the nadeko screen)

####Inviting your bot to your server - Invite Guide

  • Create a new server in Discord.
  • Copy your Client ID from your Discord bot applications page.
  • Replace the 12345678 in this link https://discordapp.com/oauth2/authorize?client_id=12345678&scope=bot&permissions=66186303 with your Client ID.
  • Your edited link should look like this: https://discordapp.com/oauth2/authorize?client_id=**YOUR_CLENT_ID**&scope=bot&permissions=66186303.
  • Go to newly created link and pick the server we created, and click Authorize.
  • Bot should be added to your server.

####Setting NadekoBot Music

For Music Setup and API keys check Setting up NadekoBot for Music and JSON Explanations.

####Updating Nadeko

Nadeko is really easy to update as of version 1.0! just copy and paste the command below to update Nadeko to the latest version

cd ~/NadekoBot/ && git init && git pull

####Some more Info - TMUX

  • If you want to see the sessions after logging back again, type tmux ls, and that will give you the list of sessions running.
  • If you want to switch to/ see that session, type tmux a -t nadeko (nadeko is the name of the session we created before so, replace “nadeko” with the session name you created.)
  • If you want to kill NadekoBot session, type tmux kill-session -t nadeko

####Some more Info - Screen

  • If you want to see the sessions after logging back again, type screen -ls, and that will give you the list of screens.
  • If you want to switch to/ see that screen, type screen -r nadeko (nadeko is the name of the screen we created before so, replace “nadeko” with the screen name you created.)
  • If you want to kill the NadekoBot screen, type screen -X -S nadeko quit