grundleborg / slack-advanced-exporter

A tool for exporting additional data from Slack that is missing from the official data export.
MIT License
97 stars 19 forks source link
hacktoberfest

Slack Advanced Exporter

The Slack Advanced Exporter is a tool for supplementing official data exports from Slack with the other bits and pieces that these don't include.

Current Features

This tool can supplement an official Slack team export by adding the following to it:

Installation

Release binaries can be downloaded from release tags on Github here.

Usage

First, run a full export of your Slack team, and have the produced zip file handy.

Due to archive/zip limitations, these actions cannot modify archive in place. It's preferable to fetch e-mails first to avoid copying large attachments around.

Add users' e-mails to your export.

To fetch all users' e-mail addresses and add them to the archive, user this command:

./slack-advanced-exporter --input-archive your-slack-team-export.zip --output-archive export-with-emails.zip fetch-emails --api-token xoxp-123...

You'll need to obtain an API token here.

Add all the File Attachments to your export.

To fetch all the file attachments referenced in your Slack team export andd add them to the archive, use this command:

./slack-advanced-exporter --input-archive your-slack-team-export.zip --output-archive export-with-attachments.zip fetch-attachments

You may need an API token to access some attachments. You can add --api-token xoxp-123... to this command if so, in the same way as for fetch-emails.

Problems

If you encounter a bug in this tool, please file a bug report on its Github issue tracker.

Development Plans

I'm interested in adding features to this application to export anything else that it is possible to export but which isn't included in the existing Slack export archives. PRs and Issues welcome.

Contributing

Pull requests are welcome. Please ensure that you comply with the requirements below: