Skip to content

Latest commit

 

History

History
56 lines (38 loc) · 2.1 KB

README.md

File metadata and controls

56 lines (38 loc) · 2.1 KB

Slack Saved Items Export

Elixir CI

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

example

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