This is a tool to download GroupMe messages to a CSV file and display simple stats about those messages.
Example usage:
- Number of messages by each user
- Number of favorited messages
- Number of times a user spews profanity
- Average length of a user's message
- Number of times a user says "lol"
In order to download GroupMe messages, you need an unique access token provided to you by GroupMe. To get this, log into GroupMe's Developers website and click Access Token. You should then be given a 40 character long access token.
You might need to install Python's requests library: pip install requests
- Get your GroupMe Access Token using the instructions above.
- Run
python retrieve_msgs.py, pass in your access token, and follow the command line interface to download your GroupMe messages to a CSV file. Usepython retrieve_msgs.py --helpto see a list of commands. Below are some sample usages:
python retrieve_msgs.py <YOUR ACCESS TOKEN> -a -c output.csvwill output all of your GROUP messages into a csv file called output.csv.python retrieve_msgs.py <YOUR ACCESS TOKEN> -g "Beer League Hockey"will output your GROUP messages from the Beer League Hockey group into a csv file called beer_league_hockey.csv.python retrieve_msgs.py <YOUR ACCESS TOKEN> -d -awill output all of your DIRECT MESSAGES into a separate csv file for each person.python retrieve_msgs.py <YOUR ACCESS TOKEN> -d -g "Jennifer Lawrence" -c jlaw.csvwill output your DIRECT MESSAGES from Jennifer Lawrence into a csv file called jlaw.csv.
- Run
python run_stats.pyand pass in your CSV file to display some simple stats about your messages. Usepython run_stats.py --helpto see a list of commands. For example:python run_stats.py output.csvwill simply give you the number of messages sent by each individual.
If you run into any issues running this, let me know via the "Issues" tab. Some of the code is not fully tested so please file a bug report if an error occurs and I will try to address it!