It can be hard moving on from those who leave your Slack organisation. How about a #deadtous channel where you can still talk to the departed?
Once you deploy deadtous, configure Slack and provide an export of your Slack history, it'll take on the personalities of those who have left. You'll be able to mention them directly by name in the channel of your choice and they'll respond!
You can:
/deadtous to see a list of who are the departed.@john.smith we miss you!You will need to deploy deadtous somewhere it can receive an HTTP request from Slack. The Deploy section lists some ways that you can do this.
Choose how you'll deploy, then:
/deadtous (or something else if you prefer). You can set a custom icon and description if you like, but leave everything else as is for now, and keep the page open.Now you can supply your Slack export.
npx deadtous import, or with docker run --rm jonoh/deadtous import. See full CLI usage below.Example: run directly with S3 output.
npx deadtous import -s s3:/my-bucket my-slack-export.zip
Example: run in Docker with local output.
docker run -it --rm -v /host/path:/data deadtous import my-slack-export.zip
Finally, you're done. Try mentioning a deleted user in your configured channel.
This section lists a few different ways you could deploy deadtous to a server.
In all cases it requires somewhere to store data, a local filesystem or S3 are supported.
To use S3, set the storage path in the format s3:/bucket-name, otherwise the path will be interpreted as local.
If you have a server with Node you can deploy and run it directly.
Clone the project, install the dependendies and then run bin/run server, or just run npx deadtous server (see deadtous server for usage).
Your server must be able to receive public HTTP requests so that Slack can send its webhook request.
Lambda is very cheap, and convenient if you already have an AWS account.
A Terraform module is available to make deployment easier. You should be able to use the example without modification by running terraform apply.
If you have your own way to deploy Lambdas, you can use the Docker image that includes the Lambda runtime (the Lambda builds are tagged with a -lambda suffix).
The image is published on Docker hub.
Run it as you would any other image, e.g. docker run, docker-compose, Kubernetes, etc. Your container must be able to receive public HTTP requests so that Slack can send its webhook request.
| Name | Default | Purpose |
|---|---|---|
| DEADTOUS_STORAGE | /data | Data storage location (local fs or s3) |
| DEADTOUS_SLACK_TOKENS | None | Slack webhook/slash tokens (Required) |
| DEADTOUS_PORT | 80 | Listening port |
| Default | Purpose |
|---|---|
| 80 | Listening port for Slack |
| Default Path | Purpose |
|---|---|
/data | Storage location (set with DEADTOUS_STORAGE) |
Running with docker run, listening on port 8080:
docker run \
-e DEADTOUS_SLACK_TOKENS=${SECRET_TOKENS} \
-p 8080:80 \
-v /host/path/to/data:/data \
jonoh/deadtous
You can run the CLI with npx deadtous or docker run -it --rm jonoh/deadtous.
deadtous dump [KEY]deadtous help [COMMAND]deadtous import [SLACK_EXPORT_FILE]deadtous serverdeadtous speak [USER]deadtous dump [KEY]read a file from storage
USAGE
$ deadtous dump [KEY]
OPTIONS
-s, --storage=storage (required) storage path
See code: src/commands/dump.ts
deadtous help [COMMAND]display help for deadtous
USAGE
$ deadtous help [COMMAND]
ARGUMENTS
COMMAND command to show help for
OPTIONS
--all see all commands in CLI
See code: @oclif/plugin-help
deadtous import [SLACK_EXPORT_FILE]import a Slack export archive file
USAGE
$ deadtous import [SLACK_EXPORT_FILE]
OPTIONS
-s, --storage=storage (required) storage path
See code: src/commands/import.ts
deadtous serverrun a Slack webhook HTTP server
USAGE
$ deadtous server
OPTIONS
-s, --storage=storage (required) storage path
--port=port [default: 8080]
--tokens=tokens (required)
See code: src/commands/server.ts
deadtous speak [USER]make a dead user say something
USAGE
$ deadtous speak [USER]
OPTIONS
-l, --list
-s, --storage=storage (required) storage path
See code: src/commands/speak.ts
Content type
Image
Digest
Size
351.6 MB
Last updated
about 5 years ago
docker pull jonoh/deadtous