christophcemper / slack-advanced-exporter

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

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 Private Channels to your export

You can fetch all the private channels you have access to yourself, assuming you use an API token with scopes groups:read and groups:history. To do so, run this command:

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

Obtain a token as above.

Add all the File Attachments to your export.

To fetch all the file attachments referenced in your Slack team export and 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.

Add all the Profile Pictures to your export.

To fetch all the profile pics referenced in your Slack team export and add them to the archive, use this command:

./slack-advanced-exporter --input-archive your-slack-team-export.zip --output-archive export-with-profile-pics.zip fetch-profile-pictures

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: