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

slack-saved-items-export's Issues

Trouble running

Anyone able to help point me in the right direction for the script, new to erlang?

Permission denied error

I downloaded the binary, set the token, and attempted to run the program:

➜  Downloads export SLACK_SAVED_ITEMS_EXPORT_OAUTH_TOKEN=xoxd-XXXXX
➜  Downloads ./slack-saved-items-export --output export.html --show-profile-image
zsh: permission denied: ./slack-saved-items-export
➜  Downloads ./slack-saved-items-export --help
zsh: permission denied: ./slack-saved-items-export

But I'm getting a "permission denied" error. (I've removed my user token for privacy but had pasted it correctly.) Any idea what might cause this issue?