https://github.com/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.
https://github.com/mmore/slack-saved-items-export
archive cli elixir-apps exporter slack slack-api slack-app
Last synced: 12 months ago
JSON representation
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.
- Host: GitHub
- URL: https://github.com/mmore/slack-saved-items-export
- Owner: MMore
- License: mit
- Created: 2021-03-07T19:40:54.000Z (about 5 years ago)
- Default Branch: master
- Last Pushed: 2021-03-14T11:24:44.000Z (about 5 years ago)
- Last Synced: 2025-04-28T13:14:37.256Z (12 months ago)
- Topics: archive, cli, elixir-apps, exporter, slack, slack-api, slack-app
- Language: Elixir
- Homepage:
- Size: 85 KB
- Stars: 6
- Watchers: 2
- Forks: 0
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Slack Saved Items Export
[](https://github.com/MMore/slack-saved-items-export/actions/workflows/elixir.yml)
Export your [saved messages in Slack](https://slack.com/intl/en-de/help/articles/360042650274-Save-messages-and-files-) 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](https://medium.com/@brucifi/erlang-quick-install-a3b7fd96947f) installed. It does not require [Elixir](https://elixir-lang.org/install.html) to be installed unless you wanna build it on your own.
Download the [slack-saved-items-export](https://github.com/MMore/slack-saved-items-export/releases) binary.
Alternatively build it with
```
$ mix escript.build
```
## Usage
Create a "[Slack App](https://api.slack.com/authentication/basics)" 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](https://api.slack.com/authentication/token-types#user) 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](LICENSE)