Discord.FM

Discord.FM is a Discord bot designed for retrieving statistics and data from Last.fm, whilst facilitating more community elements by allowing people to link their Last.FM accounts.

Installation

Prerequisites

This bot is designed primarily with Python 3.6 and a Linux environment in mind, and may not function properly in other conditions.

To install the necessary Python modules, use the following command in the bot's folder (with sudo not being required in all environments):

sudo pip3 install -r requirements.txt

In-order to enable voice functionality, you need to install ffmpeg3 and keep youtube-dl up-to-date using:

sudo apt-get install ffmpeg3 | pip3 install --upgrade youtube-dl

Whilst you could just randomly run pip3 install --upgrade youtube-dl to keep youtube-dl up-to-date, this bot is designed to update youtube-dl on startup and I'd recommend following the releases at their github repository.

Setup

Discord access

To enable the bot, you will have to create a new Discord application here, create and setup a bot user under it, and take its token and put that into the following disco entry in config.json.

"disco": {
    "token": "INSERT_TOKEN_HERE"
  },

API access

In-order enable the relevant API functions, you will have to setup accounts and get api keys or IDs and secrets from the relative websites, enable access to the relevant end points and put them into the relevant api entries in config.json.

"api": {
  "last_key": "https://www.last.fm/api/account/create",
  "google_key": "https://console.developers.google.com/apis/library/youtube.googleapis.com",
  "spotify_ID": "https://developer.spotify.com/dashboard/",
  "spotify_secret": "https://developer.spotify.com/dashboard/"
},

Optional

Whilst this bot will default to running off an automatically generated local SQLite database (data/database.db), you can hook it up to an SQL server by adding the example seen below to config.json with your own data inserted. For this to function, the SQL server will need to have a database with the name entered in config pre-created, but the bot will automatically create the necessary tables.

"sql": {
  "database": "database_name",
  "host": "server_address",
  "port": 3015,
  "username": "root",
  "password": "password"
}

In-order to enable SQL access over SSL, you can pass through the certificate paths to the SQL adapter in the args dictionary in config.json.sql, with the key for each certificate type varying for custom SQL adapters but being the following for the default adapter.

"sql": {
   "args": {
      "ca": "path/to/certificate/authority/public/key.pem",
      "cert": "path/to/client/certificate/path/private/certificate.pem",
      "key": "path/to/client/public/key.pem"
   }
}

* Whenever config.json is mentioned in this document, this is interchangeable with config.yaml.

Discord

You can add a public version of this bot to your server using this invite link and can stop by our support server using this invite link if you'd like to chat or have any issues.

FasterSpeeding/Discord.FM