https://github.com/youyanggu/groupme_stats

Tool to download and optionally display interesting stats about GroupMe messages
https://github.com/youyanggu/groupme_stats

Last synced: about 2 months ago
JSON representation

Tool to download and optionally display interesting stats about GroupMe messages

• Host: GitHub
• URL: https://github.com/youyanggu/groupme_stats
• Owner: youyanggu
• License: mit
• Created: 2014-07-08T08:21:53.000Z (over 10 years ago)
• Default Branch: master
• Last Pushed: 2017-07-21T04:55:16.000Z (over 7 years ago)
• Last Synced: 2024-08-14T07:10:03.659Z (5 months ago)
• Language: Python
• Homepage:
• Size: 21.5 KB
• Stars: 60
• Watchers: 6
• Forks: 39
• Open Issues: 3
• Metadata Files:
  • Readme: README.md
  • License: LICENSE.md

Awesome Lists containing this project

• jimsghstars - youyanggu/groupme_stats - Tool to download and optionally display interesting stats about GroupMe messages (Python)

README

        
Download GroupMe Messages

=============

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"

Getting Access Token

--------------

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 on the upper right. You should then be given a 32-character or 40-character access token. You will need this later.

Dependencies

--------------

Python 2.7. You need to have Python's requests library: ```pip install requests```

Instructions

--------------

1. Get your GroupMe Access Token using the instructions above.

2. 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. Use ```python retrieve_msgs.py --help``` to see a list of commands. Below are some sample usages:

  - ```python retrieve_msgs.py  -a -c output.csv``` will output all of your GROUP messages into a csv file called output.csv.

  - ```python retrieve_msgs.py  -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  -d -a``` will output all of your DIRECT MESSAGES into a separate csv file for each person.

  - ```python retrieve_msgs.py  -d -g "Jennifer Lawrence" -c jlaw.csv``` will output your DIRECT MESSAGES from Jennifer Lawrence into a csv file called jlaw.csv.

3. Run ```python run_stats.py``` and pass in your CSV file to display some simple stats about your messages. Use ```python run_stats.py --help``` to see a list of commands. For example: ```python run_stats.py output.csv``` will 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!