Neosay is an easy CLI tool that allows you to send messages and code from files or stdin to Matrix.

Download a copy of Neosay for your system by clicking the big green banner above.

To build Neosay, you'll need to clone the repository and build the binary:

git clone https://github.com/donuts-are-good/neosay.git
cd neosay
go build

You may want to use Neosay with environment variables instead of a config file.

echo "Hello, world!" | ./neosay

You can load in your configuration details as environment variables like this in your environment:

export MATRIX_HOMESERVER_URL="https://matrix.example.com"
export MATRIX_USER_ID="@yourusername:example.com"
export MATRIX_ACCESS_TOKEN="your_access_token"
export MATRIX_ROOM_ID="!yourroomid:example.com"

Neosay can optionally use a JSON configuration file to store the Matrix homeserver URL, user ID, access token, and room ID. This makes it easy to switch between rooms.

Note: Be careful using this method, anybody can inmpersonate you with this information. It's best to make a different account for this.

Here's an example of the JSON configuration file:

{
  "homeserverURL": "https://matrix.example.com",
  "userID": "@yourusername:example.com",
  "accessToken": "your_access_token",
  "roomID": "!yourroomid:example.com"
}

echo "Hello, world!" | ./neosay config.json

cat yourfile.txt | ./neosay config.json

echo "Hello, world!" | ./neosay -c config.json

cat yourcodefile.py | ./neosay --code config.json

Here are some other ways to use Neosay:

• Share code snippets with your team in a Matrix room
• Send logs or debugging information from a script
• Share inspirational quotes or jokes
• Send notifications from your CI/CD pipelines or monitoring tools

I'll take help however you can get it to me, whether that be a pull request, a .patch file, a sticky note, smoke signals, bribes, you name it.

neosay is licensed under the MIT license. Check out the LICENSE file for more info. If you dont get it don't worry about it.