A bot to automatically post information on the SecureDrop Gitter room. Messages can be scheduled to be posted on specific day(s) of the week at specific time(s). It can be used in any other Gitter room as well.
Sign in with a GitHub account on https://developer.gitter.im/ to obtain the authentication token required to access the Gitter API.
Clone the repo, and
Create a file auth.yml with its contents as
Execute the script sd-helper.py to start the bot.
Configuring the bot's behavior
The behavior of the bot can be configured by editing data.yml. Add tasks by specifying 3 things-
message- The message that needs to be posted.
day- Integer value(s) denoting day(s) of a week. The week starts from Monday(0) and goes till Sunday(6).
time- Time value(s) at which the message is to be posted, according to your timezone. It should be in 24h format, like
The name of the task does not matter, other than the fact that it should be unique.
Interacting with the bot
The bot can be stopped from posting any further messages on a certain day by @ mentioning followed by the
blacklist command as follows
Note that the bot only responds to users authorized to perform this action. A list of such users is maintained in the file approved_users.yml. Users are identified by their Gitter user IDs, which can be obtained by following the Gitter API documentation.
- Make sure the GitHub account has joined the room before posting.
- Do not post same message too frequently. Gitter's spam detection may flag your account.
- Register an OAuth 2.0 application at https://developer.gitter.im/apps for highly active bots.