Repository files navigation

Purpose: archive your private and public Slack messages, users, channels,files and emojis. Generate Slack Export without admin privileges.

Quick links:

• Installation And Quickstart

• Join the discussion in Telegram.

• Buy me a cup of tea, or useGithub Sponsorsbutton on the top of the page.

• 

• How to's:

  • Mattermost migration steps
  • SlackLogViewerとSlackdumpを一緒に使用する
  • v1 Overview on Medium.com (outdated)

Typical use scenarios:

• archive your private conversations from Slack when the administratordoes not allow you to install applications OR you don't want to usepotentially privacy-violating third-party tools,
• archive channels from Slack when you're on a free "no archive" subscription,so you don't lose valuable knowledge in those channels,
• create a Slack Export archive without admin access, or
• save your favourite emojis.

There are several modes of operation

1. List users/channels
2. Dumping messages and threads
3. Creating a Slack Export in Mattermost or Standard modes.
4. Creating an Archive
5. Emoji download mode.
6. Viewing export, dump or archive files or directories (displays images).
7. Search mode (messages and files).

Runslackdump help to see all available options:

On macOS, you can install Slackdump with Homebrew:

brew install slackdump

On other Operating Systems, please follow these steps:

1. Download the latest release for your operating system from thereleases page.
2. Unpack the archive to any directory.
3. Run the./slackdump orslackdump.exe executable (see note below).
4. You know the drill: use arrow keys to select the menu item, and Enter (orReturn) to confirm.
5. Follow thesequickstart instructions.

To work around this:

• on Windows: click "more information", and press "RunAnyway" button.
• on macOS 14 Sonoma and prior: open the folder in Finder, hold Optionand double click the executable, choose Run.
• on macOS 15 Sequoia and later: start the slackdump, OS will show the"Unknown developer" window, then go to System Preferences -> Security andPrivacy -> General, and press "Open Anyway" button.

• Quickstart guide:slackdump help quickstart, readonline.
• Generic command overview:man ./slackdump.1
• Ez-Login 3000 Guide.
• V2 to V3 migration notes:slackdump help v2migrate, readonline.
• What's new in V3:slackdump help whatsnew, readonline.

If you're migrating to Discord, the recommended way is to useSlackord2 — a great tool with anice GUI, that is compatible with the export files generated by Slackdump.

For more advanced features and instructions, please see the [User Guide][ug],and readslackdump help pages.

Once the workspace data is dumped, you can run built-in viewer:

slackdump view<zip or directory>

The built-in viewer supports all types of dumps:

1. Slackdump Archive format;
2. Standard and Mattermost Slack Export;
3. Dump mode files

The built-in viewer is experimental, any contributions to make it better looking are welcome.

Alternatively, you can use one of the following tools to preview theexport results:

• SlackLogViewer - a fast and powerful Slack Export viewer written in C++, works on Export files (images won't be displayed, unless you used an export token flag).
• Slackdump2Html - a great Python application that converts Slack Dump to astatic browsable HTML. It works on Dump mode files.
• slack export viewer - Slack Export Viewer is a well known viewer forslack export files. Supports displaying files if saved in the "Standard" file mode.

Download:

go get github.com/rusq/slackdump/v3

package mainimport ("context""log""github.com/rusq/slackdump/v2""github.com/rusq/slackdump/v2/auth")funcmain() {provider,err:=auth.NewValueAuth("xoxc-...","xoxd-...")iferr!=nil {log.Print(err)return  }sd,err:=slackdump.New(context.Background(),provider)iferr!=nil {log.Print(err)return  }_=sd}

SeePackage Documentation.

Slackdump uses a "log/slog" package, it defaults to "slog.Default()". Set thedefault slog logger to the one you want to use.

If you were usinglogger.Silent before, you would need toimplement a discardingHandler for slog.

No, you don't. Just run the application and EZ-Login 3000 will takecare of the authentication or, alternatively, grab that token andcookie from the browser Slack session. See [User's Guide][ug].

Runslackdump workspace new <name or url> to reauthenticate.

slackdump view<ZIP-archive or directory>

No, unfortunately you can't. Slack doesn't allow to export data older than 90days for free workspaces, the API does not return any data before 90 days forworkspaces on the Free plan.

"Archive" is the new format introduced in v3, it minimises the memory usewhile scraping the data and also has a universal structure that can beconverted into export and dump formats at will by using the "convert" command.

"Export" format aims to replicate the files generated when exporting a Slackworkspace for compatibility.

"Dump" format has one channel per file, there's no workspace information norany users stored. Should it be required, one must get users and channels byrunningslackdump list command.

Behind the scenes slackdump always uses the "archive" file format for alloperations except "emoji" and "list", and converts to other formats on thefly, removing the temporary archive files afterwards.

Big thanks to all contributors, who submitted a pull request, reported a bug,suggested a feature, helped to reproduce, or spent time chatting with me onthe Telegram or Slack to help to understand the issue and tested the proposedsolution.

Also, I'd like to thank current sponsors:

• @malsatin

And everyone who made a donation to support the project in the past and keepsupporting the project:

• Vivek R.
• Fabian I.
• Ori P.
• Shir B. L.
• Emin G.
• Robert Z.
• Sudhanshu J.

Messages that were conveyed with the donations:

• 25/01/2022: Stay away fromTheSignChef.com, ya hear, they don'tpay what they owe to their employees.