Skip to main content

Pipe command output to Slack from your terminal!

Project description

<p align="center">
<img src="" height="64">
<h2 align="center">SlackCat</h3>
<p align="center">Concatenate files(s), or <code>stdin</code>, directly to Slack.<br>
3-minute setup & no third-party integration required.
<p align="center">
<a href=""><img src="" alt="pypi"></a>
<a href=""><img src="" alt="pypi"></a>
<img src="" alt="pip dependencies">

### Get SlackCat

Download using pip via pypi.

pip install slackcat

Next, head to the [Slack Incoming WebHooks Configuration](, click
the ``Add Configuration`` button and set the default configuration values to your
liking. Once complete, copy the Webhook URL which we'll need in the next step.

Open your ``~/.bash_profile`` file add following:



_Make sure to replace the "" with the one provided above._

### Usage


# - "Hey what's your public key dog?"
slackcat @doug ~/.ssh/

# - "Do we still use that crypto library written by the Cheese Cake Factory?"
grep -r 'from cheesecake.factory import x509' ./ | slackcat @paul

# - "Are you sure it's on your path?"
echo $PATH | slackcat "#general"

# - "These queries filling up in syslog look suspicious"
tail -f /var/log/syslog | slackcat "#general" -f

### Customization

If you would like to override the bot's username, add the following line to your ``~/.bash_profile`` file:


export SLACKCAT_USERNAME="abraham-linksys"

If you would like to override the bot's icon image, add the following line to your ``~/.bash_profile`` file:



### Development
Development of "SlackCat" is facilitated exclusively on GitHub. Contributions in the form of patches, tests and feature creation and/or requests are very welcome and highly encouraged. Please open an issue if this tool does not function as you'd expect.

**How to release updates**

If this is the first time you're releasing to pypi, you'll need to run: ``pip install -r tests/dev_requirements.txt``.

Once complete, execute the following commands:


git checkout master

# Increment the version number and tag the release.
bumpversion [major|minor|patch]

# Upload the distribution to PyPi
python sdist bdist_wheel upload

# Since master often contains work-in-progress changes, increment the version
# to a patch release to prevent inaccurate attribution.
bumpversion --no-tag patch

git push origin master --tags

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

slackcat-2.0.0.tar.gz (5.5 kB view hashes)

Uploaded source

Built Distribution

slackcat-2.0.0-py3-none-any.whl (9.9 kB view hashes)

Uploaded 3 6

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page