Home

Mellow

Table of Contents

1. Intro
2. Discord Bot Creation
3. Discord Bot Configuration
4. Useage
5. Docker Setup and Start

1. Intro

Mellow creates a Discord Bot which can communicate with several APIs like Ombi, Sonarr, Radarr and Tautulli. From the bot, in Discord, you can search and request in Ombi, get a list of all content from Tautulli and more!

DISCLAIMER: Ombi & Tautulli are the only supported platforms right now. Sonarr + Radarr support are coming soon.

---

2. Discord Bot Invite

Before setting Mellow up, you'll need a Discord server with your bot inside. You can check the official Discord website for more information: https://discordapi.com/permissions.html

The bot will need the following permissions:

• Read Messages
• Embed Links
• Read Message History
• Use External Emojis
• Send Messages
• Manage Messages
• Attach Files
• Mention @everyone
• Add Reactions

You'll need 2FA enabled to add some of these permissions.

3. Discord Bot Configuration

a. Go into the Mellow root folder and type

npm run prestart

b. To start the bot just simply type

npm run start

After starting the bot you will need to configure it by visiting youripordomain:port and filling out the Bot Settings which will start the bot with your token. The default login credentials are username:mellow password: default. Please change these as soon as possible! Note: It's recommended to set a username and password in General Settings. This way only you can access the web interface.

Bot Settings

• Token
  • Get it from https://discordapp.com/developers/ under "Bot"
• Owner ID
  • Your Discord ID. To get it from the desktop app, enable "Developer Mode" under "Appearance" advanced settings.
• Command Prefix
  • Eg. /, or !

Ombi Settings

• Define your ombi host, port, and API key.

4. Usage

_This wiki will assume your prefix is /

Use /help to view the commands list.

The main commands are

• Ombi

  • movie: search and request movies in ombi
  • tv: search and request tv shows in ombi

• Tautulli

  • libraries: get a list of all libraries on your server
  • refreshlibraries: refresh all libraries in tautulli

5. Docker Setup and Start

If you want to use this bot in a docker container you have to follow these steps:

a. Pull from docker hub:

docker pull voidp/mellow

b. Run docker image:

docker run -d --restart=unless-stopped --name mellow \ -v /opt/appdata/mellow/:/usr/src/app/data/ \ -e JWT_SECRET=random_string -e PORT=5060 \ -p 5060:5060 \ voidp/mellow

If you want persistent data create a folder in /opt/appdata/mellow/ or use docker compose. A yaml file is provided for this purpose.