slack-purger

slack-purger is a tool to purge historical messages, files, and reactions from Slack workspaces.

Installation

It is recommended to install slack-purger and its dependencies in a dedicated virtual environment using a tool such as pipx. To install the latest release from PyPI into ~/.local/bin run:

pipx install slack-purger

slack-purger requires Python 3.7 or later.

Usage

To remove all messages sent, files uploaded, and reactions made by a single user, run slack-purger with an authentication token given in either the SLACK_TOKEN environment variable, or passed in with the --token command line argument:

slack-purger --token <token>

An optional date can be provided with the --until command line argument, in which case only messages sent, files uploaded, and reactions made before that date will be deleted. The date can be specified in any natural language format understood by dateparser. For example:

slack-purger --until "2 weeks ago"

Copyright

Copyright © 2018-2020 Scott Stevenson.

slack-purger is distributed under the terms of the GNU General Public License, either version 3, or (at your option) any later version.