Bot to air your grievances
HTML Python CSS JavaScript Shell
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.

LIS Grievances


Because we all need to air our grievances some time

Project Homepage


  • Supports Emojis! (finally)
  • Of course, there is a patreon


OPTIONAL: Web files

  • Install apache/nginx etc to display the web component
  • Modify the html files to point to your account and avatar
  • run sudo ./deploy_html to copy those files to the usual /var/www/html


  • create your _grievances account on twitter
  • be sure to add a Mobile number as well or you won't get an API key
  • generate Twitter API key
  • be sure to allow access to DM in APP settings (see fig 1)
  • run sudo ./install_pre to install necessary parts (Currently just tweepy) and generate settings file
  • create a Google Form with one text box and get a pre-filled URL, check settings for details/example
  • add relevate info about form and API account info to
  • also add path of grievance text file to
  • create a temp directory for downloaded image files, used in media posting, set in

Checking Grievances

  • add to crontab to fire at a reasonable time frame (once an hour on the 30 minute mark)
  • also chmod +x as well
  • Grievances will be posted to your Google Spreadsheet
  • after each check it kills any lingering DMs (like bork used to do)

Posting Grievances

  • Your job is now to add the grievances from the spreadsheet to hopper/grievances_to_air.txt, or where ever else you specified. Ie. use some discretion
  • add to crontab to fire at a reasonable time frame (once an hour on the 00s)
  • once again chmod +x might be necessary
  • There is very limited media support built in. If there is a URL to a GIF or JPG in a DM, it will post approriately, but that is pretty much it
  • after a post it checks/kills any lingering DMs (like bork used to do)

Nag Grievances

  • You can set to run once a day via cron to troll for more grievances
  • chmod +x here too
  • Add your nags to the text file point to at NAGLIST
  • Ah, I don't really use this much, at all. I suggest you don't either

Bork Grievances

  • Deprecated. no longer needed


**fig 1 **

An art project by @elibtronic