fatchan
/
globalafk
mirror of https://gitgud.io/fatchan/globalafk
1
1
Fork 0
Code Issues Packages Projects Releases Wiki Activity
A simple python script that sends ugly notifications when something happens on a jschan imageboard that you moderate.
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
16 Commits
2 Branches
0 Tags
63 KiB
 
Tag: Branch: Tree: a05cf3cfe0
Branches Tags
${ item.name }
Create tag ${ searchTerm }
Create branch ${ searchTerm }
from 'a05cf3cfe0'
${ noResults }
Go to file
myumyu a05cf3cfe0
Updated README, added new package and changed small things 		3 years ago
components Updated README, added new package and changed small things 3 years ago
config Updated README, added new package and changed small things 3 years ago
.gitignore Initial commit 3 years ago
README.md Updated README, added new package and changed small things 3 years ago
main.py Updated README, added new package and changed small things 3 years ago
notifiers.py Created notifier and evaluator generic classes and improved main config parsing 3 years ago
requirements.txt Initial commit 3 years ago
session.py Refactored tiny details 3 years ago

README.md

globalafk

A python script that sends ugly notifications when something happens on a jschan imageboard that you moderate. It has been developed around composition principles in order to help you to expand or change it to fit your needs and goals. Most of the components are easily swappable.

Features

For now, this project has one (1) basic feature, send notifications. That said, you can configure it to send notifications when:

  • New reports
  • A new post includes some fine-grained pre-configured entry or some (clear or partially obfuscated) url that you have not whitelisted

All of these features can be turned off independently.

Requirements

You need to have moderation privileges in at least one board and an environment with python3 and the dependencies listed in requirements.txt file in order to run this script.

To send notifications on Linux you must have notify-send installed to receive notifications on linux. Run notify-send test to test it.

To send notifications on Android (assuming you are using Termux) you must have Termux:API installed to receive notifications on android. Run termux-notification --title test to test it.

Getting Started

  1. (Optional) Create and activate a virtual environment
  2. Run pip3 install -r requirements.txt to install the dependencies
  3. Install (if is not already installed) notify-send or termux-notification accordingly to your needs
  4. Make a copy of config_example.py and rename it to config.py
  5. Fill the account details and configure the script behavior in your new config.py file
  6. Run python3 main.py