snowstorm-matrix/README.md

Description

Matrix Room: #snowstorm-matrix:imninja.net

This bot will send news about Blizzard games to Matrix room they got invited to.

Information about which URLs already got posted is also saved into the admin room via state events.

Public Instances

These bots are publicly hosted. Just invite them to a room and they should start doing their job.
Just kick them, when you don't want to receive updates anymore.

Diablo
Heroes of the Storm
Inside Blizzard
Overwatch
World of Warcraft

Configuration

First create all users you want to use.

Next you have to create a new room you can use as admin room. You have to specify the room id of that room later. Invite all bot users to that room.
Additionally you have to allow every user to post to the cache state:

"de.lubiland.snowstorm-matrix.cache": 0

Multiple bots of different categories can share the same admin room.

Running it

After initial configuration you can run it manually:

docker run --rm \
    -v $(pwd)/heroesofthestorm:/heroesofthestorm:ro \
    -e HOMESERVER=https://example.org
    -e MIXD=@heeeroooooooes:example.org
    -e ACCESSTOKEN_FILE=/heroesofthestorm \
    -e ADMIN_ROOM='!iesofojasief90429ewiofj:example.org' \
    -e CATEGORY=heroesofthestorm
    gitea.lubiland.de/lub/snowstorm-matrix:latest

Or via docker-compose/swarm:

    snowstorm-matrix_overwatch:
        image: gitea.lubiland.de/lub/snowstorm-matrix:latest
        deploy:
            replicas: 1
        secrets:
            - snowstorm-matrix_overwatch
        environment:
            - HOMESERVER=http://synapse:8008
            - ACCESSTOKEN_FILE=/run/secrets/snowstorm-matrix_overwatch
            - MXID=@bastionrulez:example.com
            - ADMIN_ROOM=!jjpPluoxZoAOBQeYer:example.org
            - CATEGORY=overwatch
    snowstorm-matrix_worldofwarcraft:
        image: gitea.lubiland.de/lub/snowstorm-matrix:latest
        deploy:
            replicas: 1
        secrets:
            - snowstorm-matrix_worldofwarcraft
        environment:
            - HOMESERVER=http://synapse:8008
            - ACCESSTOKEN_FILE=/run/secrets/snowstorm-matrix_worldofwarcraft
            - MXID=@forthehorde:example.com
            - ADMIN_ROOM=!jjpPluoxZoAOBQeYer:example.org
            - CATEGORY=worldofwarcraft