This repository has been archived on 2024-03-09. You can view files and clone it, but cannot push or open issues or pull requests.
Go to file
2022-10-18 13:15:53 -07:00
default Cleaned up comments 2022-10-13 15:00:42 -07:00
docs Removed unused settings 2022-10-17 13:08:52 -07:00
src Append file correction 2022-10-13 17:23:52 -07:00
.gitignore Added additional automation scripts 2022-10-08 17:50:09 -07:00
LICENSE.txt Initial Commit 2022-07-14 12:32:18 -07:00
README.md Updated donate section 2022-10-18 13:15:53 -07:00
requirements.txt Initial Commit 2022-07-14 12:32:18 -07:00
run.sh Updated to return exit code from bot 2022-10-08 17:51:06 -07:00

Readme

Yandere Lewd Bot is a customizable, no frills image-posting bot for Pleroma.

A live example can be viewed at GNU/Yandere.

Currently the bot will only run on Linux. I believe it should run on most distros but I have only tested it on Arch and Raspbian.

About

Yandere Lewd Bot is designed to be simple to understand (from a technical perspective) and easy to modify/extend. It relies on GNU formatted hash files to configure and organize posts (from the GNU coreutils package):

This project is licensed under GPLv3. See LICENSE.txt.

The bot is still in development and can easily be crashed by writing a poorly configured cfg.py file, or messing with the hash files it uses to configure posts. The bot may also crash with encoding errors for files with non-unicode filenames.

Installing

To setup the python3 environment (for Arch Linux) run the following commands:

sudo pacman -Syu
sudo pacman -S --needed python git
git clone 'https://git.yandere.cc/Anon/YandereLewdBot.git'
cd YandereLewdBot/
python -m venv venv
source venv/bin/activate
pip install --upgrade pip
pip install -r requirements.txt
deactivate
mkdir -p md5 rsc/{safe,nsfw}
cp -vn default/cfg.py src/
./run.sh -h

If everything worked correctly you should see usage information on Yandere Lewd Bot.

The ./run.sh file will automatically activate and deactivate the python virtual environment. You may want add a symlink to /usr/local/bin for convenience.

sudo ln -s "$(pwd)/run.sh" "/usr/local/bin/yandereLewdBot"
yandereLewdBot -h

For Debian or Ubuntu based distros I believe you need to change python with python3 for the package and command name ¯\_(ツ)_/¯

Generating your OAuth Tokens

Before you can begin posting from the bot, you must first create an account on the instance of your choice, and then generate your OAuth tokens.

To generate your tokens, run the following commands and follow the interactive prompts.

cd ..
git clone 'https://git.yandere.cc/Anon/CreatePleromaApp.git'
ln -s "$(pwd)"/YandereLewdBot/venv CreatePleromaApp/venv
ln -s "$(pwd)"/YandereLewdBot/src/cfg.py CreatePleromaApp/src/cfg.py
cd CreatePleromaApp
./run.sh -c cfg
# Follow the interactive prompts.

If you did everything correctly you should see Success! :) at the end of the terminal, as well as your credentials in the format below:

settings_server = OrderedDict([
        "app_name":       "app",
        "api_base_url":   "https://yandere.cc",
        "client_id":      "Long String of Text",
        "client_secret":  "Long String of Text",
        "access_token":   "Long String of Text"
])

settings_reminder = "09/20/2020 02:58PM"

settings_encrypt = {
        "encrypt":		False,
        "salt":			"",
		"keyfile":		None
}

If you used encryption, everything in the settings_server dictionary will be encrypted. If you used encryption and did not specify a keyfile, you will have to enter your password every time you start the bot. Copy and paste these values from the terminal into your src/cfg.py file. Make sure you paste over or delete the placeholder values with the same names.

Posting

To begin posting:

  • Put some images in the rsc/ folder (organize by safe and nsfw posts).
    • 'safe' posts will be marked with #yandere
    • 'nsfw' posts will be set to sensitive and marked as #nsfw #lewd #yandere
  • Make sure you are in the bot's root directory (the directory with run.sh)
  • Checksum all the files you added with the following command:
    • find "./rsc" -type f -exec md5sum -b '{}' \; > "./md5/master_file.txt"
  • Start the bot with ./run.sh
    • Enter your password if you encrypted your OAuth tokens.
    • If you symlinked the file in the Installing section you can simply run yandereLewdBot instead of changing directories and starting the bot with ./run.sh
  • If everything worked correctly, you should see your first image posted to your account.
  • When you start the bot again, it will begin posting from where it last left off.
    • It accomplishes this by writing to a md5/blacklist.txt file. If you see this file, it worked correctly.
  • Keep in mind that the bot's default visibility setting is set to unlisted for testing. You may want to update it to public.
  • Read docs/configuration.md to customize the bot for your purposes.

Donate

BTC: bc1q8w04c6xt0sm2nskkqatp372llyx8ed33at4k4g

ETH & BAT: 0x2B1C49cc1C93e5bba59a5eD4D0E0a4Da8D6Ce482

XMR: 493HynLQA4z71b3j9ZDXRNQudpdFW8GxeBGD8ahRctKn97RRurMVd35DqVqdAdjv68TcXTJWUwm6ee81ujDXGcmtKFixwQk

Useful Tips

Scheduling posts with cron

Most likely you will want this bot to run over a long period of time. There are a several ways to automate calling a script at regular intervals on Linux. For brevity I will be covering the cron way.

First off, install cron if it's not already installed:

sudo pacman -Syu
sudo pacman -S --needed cronie
sudo systemctl enable cronie
sudo systemctl start cronie

Next, run the following commands:

  • crontab -e
  • 25,55 * * * * /absolute/path/to/run.sh >> "/absolute/path/to/log.txt" 2>&1
    • Modify the paths above to suit your preferences
  • Save and exit

If you followed the steps above the cron job should run every 30 minutes at 25 and 55 minutes past the hour. Tail the log file to ensure it's working correctly.

A Master Blacklist

The default configuration file has the following settings below (these files will not exist by default. The bot will simply ignore blacklist hash files that it can't open). The _r stands for read and the _w stands for write. This will ensure that the master_blacklist.txt is always read, but is never written to. This is intended for the user to manually add GNU formatted hashes to master_blacklist.txt in case they want to make especially sure that hashes and paths that are matched in the list are never uploaded accidentally.

"master_blacklist_r":	("./md5/blacklist.txt", "./md5/master_blacklist.txt"),
"master_blacklist_w":	("./md5/blacklist.txt",),

Quickly Create Configuration Files

Configuration files for Yandere Lewd Bot are just python files. Because of this we can easily create multiple configurations by importing the main configuration file, and overriding the values we need. This is useful for creating holiday and debug configurations without needing to create a new configuration file from scratch.

# Name: alt.py
# Post to an alt account using the exact same settings as the main configuration file
# Run with the following command: ./run.sh -c alt

# cfg.py is the default configuration.
from cfg import *

settings_server = OrderedDict([
	("app_name",		"generate from ./bin/create_app.py"),
	("api_base_url",	"generate from ./bin/create_app.py"),
	("client_id",		"generate from ./bin/create_app.py"),
	("client_secret",	"generate from ./bin/create_app.py"),
	("access_token",	"generate from ./bin/create_app.py")
])

settings_reminder = "generate from ./bin/create_app.py"

settings_encrypt = {
	"encrypt":	False,
	"salt":		"generate from ./bin/create_app.py",
	"keyfile":	None
}

settings_behavior["master_blacklist_r"] = ("./md5/blacklist_alt.txt", "./md5/master_blacklist.txt")
settings_behavior["master_blacklist_w"] = ("./md5/blacklist_alt.txt",)

# Uncommenting the below might be useful if your alt is used for debugging and testing
# settings_behavior["master_list"] = ("master_file_alt.txt",)
# settings_behavior["visibility"] = "private"
# settings_behavior["debug"] = True
# settings_behavior["master_blacklist_w"] = tuple()
# Name: xmas.py
# An xmas themed config file!
# Run with the following command: ./run.sh -c xmas

# cfg.py is the default configuration.
from cfg import *

settings_behavior["master_list"] = ("./md5/event_xmas.txt",)
settings_behavior["master_blacklist_r"] = ("./md5/blacklist_xmas.txt", "master_blacklist.txt")
settings_behavior["master_blacklist_w"] = ("./md5/blacklist_xmas.txt",)

# Prepend '#Merry #Christmas' to the beginning of the first line in each post
for setting in settings_post:
	if len(setting["message"]) and issubclass(type(setting["message"][0]), str):
		new_msg = "#Merry #Christmas {}".format(setting["message"][0])
		setting["message"] = (new_msg,) + setting["message"][1:]