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.
36 Commits
2 Branches
0 Tags
63 KiB
 
Tag: Branch: Tree: master
Branches Tags
${ item.name }
Create tag ${ searchTerm }
Create branch ${ searchTerm }
from 'master'
${ noResults }
Go to file
Thomas Lynch e61e075593
Merge branch 'dev' 		1 year ago
components add back evaluate to newpost, close #4 1 year ago
config Updated README, added new package and changed small things 1 year ago
.gitignore Initial commit 1 year ago
README.md Updated README.md 1 year ago
main.py bugfix wrong import 1 year ago
notification_button.py typo, bugfix 1 year ago
notifiers.py Created notifier and evaluator generic classes and improved main config parsing 1 year ago
requirements.txt Initial commit 1 year ago
session.py proper csrf method, remove temporary hack 1 year 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. Run notify-send test to test it.

To send notifications on Android (assuming you are using Termux) you must have Termux:API installed. 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

Contribute

All contributions are welcomed. Feel free to open a issue or make a pull request.