down-bad / tutu-bot

A simple, Reddit-focused Discord bot

Tutu Bot

A simple, Reddit-focused Discord bot.

Add it to your server: https://tutu.imvasi.com

Features

Reddit

• 🔝 Get top posts, hourly/daily/weekly/monthly/yearly/overall
• 🔀 Get random posts of any subreddit
• 🆔 Get posts by their ID
• 🔎 Search for any Reddit post with an advanced search command
• 👤 Get posts from any Reddit user
• 💨 Easy and fast navigation with reactions
• 🔞 NSFW protection, such posts are only shown in NSFW channels

Urban Dictionary

• 🔎 Get definitions for anything, using Urban Dictionary
• 💬 Includes examples, likes & dislikes, and author
• 💨 Easy and fast navigation with reactions

Installation

Hosted Version

Tutu Bot is already hosted by me and is running 24/7.
You can add it to your server here:
https://tutu.imvasi.com

Install & Host by yourself

There are many reasons why you would want to do that, such as customizing the bot to your likings. You must follow these instructions in order to install it properly:

Clone the repo

git clone https://github.com/down-bad/TutuBot.git

Then, run

npm install

to install the required dependencies. Make sure you have Node installed.

Edit the configuration

Rename the rename_me.json file to config.json.

Fill out the required information:

• token: Your bot token
• ownerID: Your Discord user ID

You need to obtain a Reddit app ID & secret hash in order to use the Reddit functionality of this bot, using the following instructions:

• Go to Authorized applications
• Press "Create an app"
• Enter an application name, a description and a redirect uri (if you're not sure about the redirect uri, just put http://localhost:8080)
• Choose "script" in the list - that's important
• Press the "Create app" button

You will get the app's ID under the "personal use script" line and the secret hash.

In config.json, fill out the redditCredentials:

• username: Your Reddit username
• password: Your Reddit password
• app_id: The app ID you obtained above
• api_secret: The secret hash you obtained above

Make sure you're using the Reddit account that you got the ID with.

Run

node index.js

to run the bot.
Enjoy!