Bulk delete messages and files on Slack.
Install from Pip:
pip install slack-cleaner
If you prefer Docker, there is a pre-built Docker image as well:
docker pull kfei/slack-cleaner
# Delete all messages from a channel
slack-cleaner --token <TOKEN> --message --channel general --user "*"
# Delete all messages from a private group
slack-cleaner --token <TOKEN> --message --group hr --user "*"
# Delete all messages from a direct message channel
slack-cleaner --token <TOKEN> --message --direct sherry --user johndoe
# Delete all messages from a multiparty direct message channel. Note that the
# list of usernames must contains yourself
slack-cleaner --token <TOKEN> --message --mpdirect sherry,james,johndoe --user "*"
# Delete all messages from certain user
slack-cleaner --token <TOKEN> --message --channel gossip --user johndoe
# Delete all messages from bots (especially flooding CI updates)
slack-cleaner --token <TOKEN> --message --channel auto-build --bot
# Delete all messages older than 2015/09/19
slack-cleaner --token <TOKEN> --message --channel general --user "*" --before 20150919
# Delete all files
slack-cleaner --token <TOKEN> --file --user "*"
# Delete all files from certain user
slack-cleaner --token <TOKEN> --file --user johndoe
# Delete all snippets and images
slack-cleaner --token <TOKEN> --file --types snippets,images
# Always have a look at help message
slack-cleaner --help
After the task, a backup file slack-cleaner.<timestamp>.log
will be created
in current directory if --log
is supplied.
If any API problem occurred, try --rate=<delay-in-seconds>
to reduce the API
call rate (which by default is unlimited).
If you see the following warning from urllib3
, consider to install missing
packages: pip install --upgrade requests[security]
or just upgrade your
Python to 2.7.9.
InsecurePlatformWarning: A true SSLContext object is not available.
This prevents urllib3 from configuring SSL appropriately and may cause certain SSL connections to fail.
For more information, see https://urllib3.readthedocs.org/en/latest/security.html#insecureplatformwarning.
To all the people who can only afford a free plan. :cry: