Paws offers a unique interface that bridges the gap between your favored mail clients like Mutt or mu4e and Slack. By using a sendmail-like command, you can send messages effortlessly, while receiving them in your maildir. Enhance your workflow by integrating Slack into the tools you already love, all while maintaining familiarity and efficiency.
Paws: Integrate Slack with Your Mail Client
Paws offers a seamless interface between your mail client (like Mutt or mu4e) and Slack. This project enables you to send and receive messages through Slack directly from your email client, making it ideal for users who prefer to manage communications from a single platform.
Key Features
- Send Messages: Use a sendmail-like command to send Slack messages conveniently.
- Receive Messages: Capture messages into maildirs for easy access and processing using a Mail Delivery Agent (MDA).
- User-Friendly Setup: Generate workspace tokens easily through
paws-register
and configure with a simple YAML file.
Configuration Example
Paws allows for comprehensive configuration using a .paws/config.yaml
file. A minimal setup can be structured as follows:
user_email: "user@example.org"
workspaces:
myworkspace:
token: "xoxp-..."
conversations:
- "im/slackbot"
- "channel/general"
receivers:
- type: "maildir"
workspace: "myworkspace"
name: "default"
path: "/home/user/mailbox/slack"
sender:
fallback_sendmail: "/usr/sbin/sendmail"
bounce_dir: "/home/user/mailbox/slack-bounce"
Once set up, simply run paws-receive
to fetch all messages from your Slack workspace, or specify a date with the --since=YYYY-MM-DD
parameter to filter messages by time. To send messages, configure your email client to use paws-send
as the sendmail command.
Flexible Delivery Options
For ongoing message reception, paws-receive
can be run with a --persist
option that maintains a connection to Slack, improving efficiency by reducing periodic polling. This is particularly beneficial for workspaces with infrequent updates.
Additional Configuration
Paws supports various configuration options, including rate limiting, message editing windows, and domain customization, allowing for tailored use to fit individual needs.
Debugging and Support
Set the PAWS_DEBUG
environment variable for detailed execution logs. For issue tracking and feature requests, please visit the GitHub issue tracker.
Experience a streamlined Slack communication workflow with Paws!
For more details, check out the repository on GitHub.