tsih-robo

A private Discordia-slash bot that uses gallery-dl to fill in badly embeded art websites

Introduction

Tsih-robo primary function is to fill the gap of badly embeded links on discord for websites links like Pixiv, Pawoo, Baraag, Exhentai and etc using gallery-dl. Pretty much what SaucyBot does, but with more websites that you can insert into a json as you see fit, but only websites that are compatible with gallery-dl. She has also many other miscellaneous commands made for fun.

She was chosen to be written in Lua because the language shares the same color as her hair! Tsih-robo was made using Discordia API. (/▽＼)

It's just a fun project I always wanted to create but ended up wanting to maintain, and also my first programming project ever!

(o′┏▽┓｀o)

Commands

Tsih-robo supports slash and message commands. If you're cloning this repo to run the bot yourself you need to load the bot with luvit main.lua true to load the commands.

All of her commands are located in libs/commands, where it has a init.lua file that returns a table of each functions.

The main one

• /sauce
  • channel limit:integer personalizes how much images Tsih can send in a channel. It can go from 0* up to 100.
  • global limit:integer personalizes how much images Tsih can send in the entire server.** It can go from 0* up to 10.

as for links, she will always send up to 5 because Discord and only embed 5 links per message. The preferences are saved inside data/storage.json

*if set to 0, it means that she will not send anything.

**the channel option has priority over global, meaning that if global is set to 10 and channel is set to 20, Tsih will send 20 images to the specific channel where the command was used.

Misc

• /avatar [user:User] returns your or another user's avatar link.
• /question returns a random string as an answer to a question.
• /hug makes Tsih annoyed.
• /pinch makes Tsih sad.
• /randomemoji allow:boolean adds or removes the server's id to data/storage.json file, where Tsih will randomly use it to get the server's custom emoticons and use it as a random react.
• /rolemanager
  • give name:string hexcolor:string gives the user a personalized cargo with the name and color of their choise.
  • remove removes the personalized cargo that Tsih created from the user.
• /tsihoclock
  • sign will make Tsih post daily a random image inside one of the two folders inside assets/images/tsihoclock/ at 9PM UTC. Be sure to personalize it with your own set of images!
  • unsign removes the channel from the daily image posting. Sad...
  • manual sends an ephemeral message of one of the images. Nice!
  • auto will run the same function that would run at 9PM UTC. Only the bot's owner can run it, it's a dangerous command that can annoy people!

None of the commands above are ephemeral.

Installation

Be aware that simply installing tsih-robo may cause crashes during runtime because of the absence of the /assets folder. Because of that I recommend you to change or delete pinch, hug, omori.lua, tsihoclock commands and their respective code in the project if you don't want to have a headache with it... I-I'm working on a way to make cloning less painful.

Pre-requisites programs

ffmpeg required by the two programs below.

gallery-dl required for sauce command.

yt-dlp required for song command. I do not recommend youtube-dl.

Bot installation

1. Follow Discordia's installation guide.

2. lit install creationix/coro-spawn to install a module that spawns gallery-dl and yt-dlp child-processes during runtime.

3. Git clone discordia-interactions and discordia-slash inside deps folder:

git clone https://github.com/Bilal2453/discordia-interactions deps/discordia-interactions
git clone https://github.com/GitSparTV/discordia-slash deps/discordia-slash

4. Create a file named token.txt inside data/ containing your discord application's token.

If you're running the bot for the first time, then run ./luvit main.lua true to load it's slash commands. After that you won't need to use the true argument again unless you add/change her slash commands!

gallery-dl configuration

Depending of which website Tsih-Robo is going to get the images to send, you will need to configurate your gallery-dl to work in those websites, e.g. login credentials.

For that, you will usually need to create an account for websites like Pixiv in order to get permissions for the bot see it's contents. Some websites like Pixiv will need you to run oauth command in gallery-dl in order to download the images from the website and send it to Discord. It's recommended to export your browser's cookies for gallery-dl.

Please check here to understand how to configurate your gallery-dl.

When using gallery-dl.conf, be sure to drag it inside tsih-robo folder in case you're on Windows. If you're on Linux just put it to /etc/

Huge thanks

This project wouldn't be possible without:

• People that developed gallery-dl, luvit, Discordia API and it's extensions
• Discordia's brilliant minds for helping me deal with my stupidity
• Asuran95 and rafaelrc7 for telling me the bot was based and that I should rewrite most of the scripts
• Ikuse for making incentivising Tsih art to keep the darkness away
• People that use tsih-robo (and criticised her)
• SaucyBot for being a worthy opponent
• Other people that I forgot to mention