From: Benjamin Mako Hill <mako@atdot.cc>
Date: Wed, 5 Jan 2022 04:52:27 +0000 (+0900)
Subject: Merge branch 'master' of code.communitydata.science:coldcallbot-discord
X-Git-Url: https://code.communitydata.science/coldcallbot-discord.git/commitdiff_plain/refs/heads/master?hp=-c

Merge branch 'master' of code.communitydata.science:coldcallbot-discord
---

92e65de7715056ee39c923e1d51fb8c777e64afd
diff --combined README
index d07038e,611926e..733a2e8
--- a/README
+++ b/README
@@@ -1,14 -1,27 +1,27 @@@
  Setting up the Discord Bot
  ======================================
  
 -I run the Discord boy from my laptop. It requires the discord Python
 +I run the Discord bot from my laptop. It requires the discord Python
  module available in PyPi and installable like:
  
      $ pip3 install discord
  
- I don't have details on how I set up my own Discord bot and/or invited
- it to my server but I hope you'll add to this file as you do this and
- figure out what needs to happen.
+ Setting up the Bot
+ =====================================
+ 
+ The documentation for the `discord` python package
+ (https://discordpy.readthedocs.io/en/latest/discord.html) does a good
+ job explaining how to set up a Discord bot with your server. Follow
+ the steps there, with one important exception:
+ 
+ 1. On the "Bot" tab in the discord application configuration page you
+ need to enable both "Privileged Gateway Intents."  This allows the bot
+ to see who is present and active in the channel.
+ 
+ Finally, you need to copy your bot'ss Token (also found on the "Bot" tab)
+ into coldcallbot.py. Pass it as the argument to `ccb.run()`.
+ 
+ 
  
  Using the Cold Call Bot
  ======================================
@@@ -31,7 -44,7 +44,7 @@@ Daily Proces
  
  You need to start the bot from the laptop each day. I do that by:
  
 -  $ ./coldcallboy.py
 +  $ ./coldcallbot.py
  
  The bot will run in the terminal, print out data as it works including
  detailed weights as it goes, and it will record data into files in the