PitchHut
Log in / Sign up
paws
7 views
Seamlessly connect Slack and your favorite mail client.
Pitch

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.

Description

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.