Slack Cleaner2 is an improved slack cleaner version using a python first approach
Bulk delete messages and files on Slack.
Install from PyPi:
pip install slack-cleaner2
pip install -e git+https://github.com/sgratzl/slack_cleaner2.git
In contrast to the original version (https://github.com/kfei/slack-cleaner) this version is a focusing on pure python package that allows for easy scripting instead of a vast amount of different command line arguments.
from slack_cleaner2 import * s = SlackCleaner('SECRET TOKEN') # list of users s.users # list of all kind of channels s.conversations # delete all messages in -bots channels for msg in s.msgs(filter(match('.*-bots'), s.conversations)): # delete messages, its files, and all its replies (thread) msg.delete(replies=True, files=True) # delete all general messages and also iterate over all replies for msg in s.c.general.msgs(with_replies=True): msg.delete()
You will need to generate a Slack legacy user token to use slack-cleaner. You can generate a token here:
The token should start with xoxp and not like bot tokens with xoxb.
Permission Scopes needed
The permissions to grant depend on what you are going to use the script for. Grant the permissions below depending on your use.
Beyond granting permissions, if you wish to use this script to delete messages or files posted by others, you will need to be an Owner or Admin of the workspace.
General channel and user detection
Deleting messages from public channels
Deleting messages from private channels
Deleting messages from 1:1 IMs
Deleting messages from multi-person IMs
The cleaner needs you to give Slack's API permission to let it run the operations it needs. You grant these by registering it as an app in the workspace you want to use it in.
You can grant these permissions to the app by:
- going to Your Apps
- select 'Create New App', fill out an App Name (eg 'Slack Cleaner') and select the Slack workspace you want to use it in
- select 'OAuth & Permissions' in the sidebar
- scroll down to Scopes and select all scopes you need
- select 'Save changes'
- select 'Install App to Workspace'
- review the permissions and press 'Authorize'
- copy the 'OAuth Access Token' shown, and use this token as the
--tokenargument to the script
To all the people who can only afford a free plan. :cry:
python setup.py clean sdist bdist_wheel twine upload dist/*
change version in
Release history Release notifications | RSS feed
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
|Filename, size||File type||Python version||Upload date||Hashes|
|Filename, size slack_cleaner2-2.2.0-py2.py3-none-any.whl (16.2 kB)||File type Wheel||Python version py2.py3||Upload date||Hashes View|
|Filename, size slack_cleaner2-2.2.0.tar.gz (19.8 kB)||File type Source||Python version None||Upload date||Hashes View|
Hashes for slack_cleaner2-2.2.0-py2.py3-none-any.whl