Skip to main content

GoogleGroup Exporter - Unlock your mailing list

Project description

GoogleGroup Exporter is an extensible tool for retrieving and analysing your mailing list content.


  • Dump all your messages into a mbox file so you can explore the content using email clients.
  • Export all your topics with title, author, date and url to a csv file so you can easily explore it on a spreadsheet.
  • Support extraction of private groups using your browser’s cookies.
  • Download all content in parallel.
  • Transparently cache all requests so you can inexpensively retry or process the content in different ways.
  • Offers an easy extension API so you write your own scripts.

Installation and Usage

Install Python 3.5 or greater and then simply:

pip install googlegroupexporter

Then execute the program:

ggexport my-public-group

By default, ggexport will generate a my-public-group.mbox file with all the messages. Then you can open it with you preferred email client.

Exporting a Private Group

To export a private group you need to inform your cookie header string to ggexport.

To retrieve the cookie header on Google Chrome:

  1. Login into you Google Account;

  2. Visit your GoogleGroup page, for example:!forum/my-private-group
  3. Then inspect the page with Chrome’s Developer Tool;

  4. Go to Network;

  5. Select a request to the domain;

  6. Select Headers;

  7. Search for Request Headers;

  8. Look for the Cookie key;

  9. Copy the cookie header value string;

Then run:

ggexport my-private-group --cookies "COOKIE-HEADER-STRING-COPIED-FROM-MY-BROWSER"

Listing your group topics

To create a csv listing all your group’s topics along with their urls, authors, dates and number of messages, run:

ggexport my-public-group --mode csv

How to contribute

Fork this repository, checkout your fork, then:

python -m venv .gge
source .gge/bin/activate
python develop

Change what you want, then run the tests:

python test

To run your developed code you can use the command ggexport or run the module python -m googlegroupexporter.

When everything works, submit a pull request.


MIT License

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
googlegroupexporter-1.0.tar.gz (7.9 kB) Copy SHA256 hash SHA256 Source None

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page