MMore / slack-saved-items-export

Export your Saved Items in Slack to a neat HTML file - for your own reference or as a simple archive. Don't lose your Slack bookmarks anymore.

Slack Saved Items Export

Export your saved messages in Slack to a neat HTML file - for your own reference or as a simple archive. Don't lose your Slack bookmarks anymore.

Setup

For running you just need to have Erlang/OTP installed. It does not require Elixir to be installed unless you wanna build it on your own.

Download the slack-saved-items-export binary.

Alternatively build it with

$ mix escript.build

Usage

Create a "Slack App" in your Slack workspace (means basically getting an API token) with the following permissions:

• channels:history
• channels:read
• groups:history
• groups:read
• im:history
• im:read
• mpim:history
• mpim:read
• stars:read
• users:read

After installation you get a user token which starts usually with xoxp-. Set this token as environment variable and run the program:

export SLACK_SAVED_ITEMS_EXPORT_OAUTH_TOKEN=xoxp-YOUR-TOKEN
./slack-saved-items-export --help
./slack-saved-items-export --output export.html --show-profile-image

Example output

Known issues

Currently this program fulfills my personal purpose. Depending on future necessities the following issues might be good to know:

• API pagination is not taken into consideration
• no retry in case of ratelimiting
• unnamed private conversations between multiple users (mpim) are not implemented
• not all text formatting options are implemented; implementation should be revised

License

Available under the MIT license. See the LICENSE