turt2live / matrix-alias-bot

A matrix bot that allows users to add aliases on the homeserver it runs on.
GNU General Public License v3.0
7 stars 0 forks source link
alias bot homeserver matrix room

matrix-alias-bot

TravisCI badge API Documentation

Run in Postman

A matrix bot that allows users to add aliases on the homeserver it runs on.

Questions? Ask away in #aliasbot:t2bot.io

Usage

  1. Invite @alias:t2bot.io to a room
  2. Give the bot permission to add aliases (configure the room)
  3. Add your desired alias: !alias #my_cool_alias

For information on what the bot can do, say !alias help.

Building your own

Note: You'll need to have access to an account that the bot can use to get the access token.

  1. Clone this repository
  2. npm install
  3. npm run build
  4. Copy config/default.yaml to config/production.yaml
  5. Run the bot with NODE_ENV=production node lib/index.js

Docker

# Create the directory structure
# This is all the information kept in the volume: config, logs, and cache
mkdir -p /matrix-alias-bot/config
mkdir -p /matrix-alias-bot/logs
mkdir -p /matrix-alias-bot/storage

# Create the configuration file. Use the default configration as a template.
# Be sure to change the log path to /data/logs
# Be sure to point the dataPath at /data/storage
nano /matrix-alias-bot/config/production.yaml

# Run the container
docker run -v /matrix-alias-bot:/data turt2live/matrix-alias-bot