Bulk delete messages/files on Slack.
Project description
# slack-cleaner
Bulk delete messages and files on Slack.
## Install
Install from Pip:
```bash
pip install slack-cleaner
```
If you prefer Docker, there is a pre-built Docker image as well:
```bash
docker pull kfei/slack-cleaner
```
## Usage
```bash
# 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
```
## Tips
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.
```
## Credits
**To all the people who can only afford a free plan. :cry:**
Bulk delete messages and files on Slack.
## Install
Install from Pip:
```bash
pip install slack-cleaner
```
If you prefer Docker, there is a pre-built Docker image as well:
```bash
docker pull kfei/slack-cleaner
```
## Usage
```bash
# 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
```
## Tips
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.
```
## Credits
**To all the people who can only afford a free plan. :cry:**
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
slack-cleaner-0.3.0.tar.gz
(6.0 kB
view hashes)