Skip to content

Setup Information

shsorbom edited this page Jul 16, 2020 · 4 revisions

Prerequisites

This guide assumes you have followed the installation instructions first.

Step 1: Bot Account Setup

sMythbot should operate on a separate matrix account from your main one. Before doing anything else, you should have an account ready specifically for sMythbot's use.

Step 2: Invite your main account into a room with sMythbot

Log into the smythbot account you created and send an invitation to your main account. Apply this step for all user accounts you wish to allow to control sMythbot.
Warning: As mentioned in the readme, sMythbot does not currently implement any permission security at all. Be aware of this when inviting friends or family. Save your account information somewhere and logout

Step 3 The First Run

Navigate to where you downloaded the sMythbot source code and run ithe file smythbot-main.py in Python 3. The program will display a message informing you that a template configuration has been written to ~/.smythbot/config.ini. Open the config file in a text editor. Under [Matrix Settings], set the username, password, and homeserver information to match the account information you created in step 1. Close the config file.
You should now be prepared to run sMythbot.
Note for experienced matrix users: You do not need to put your full MXID in the username field, just the username of the account.

Step 4: Setting up your Myth Tv

When you are ready, execute the smythbot-main.py file again.
Log into your main matrix account from the client of your choice, navigate to the room sMythbot invited you to, and type the following into your chat client:
!smythbot set mythbackend address "your-mythtv-backend-address".
Note: Do not include http:// or https:// in your backend URL. If you do, you will get a message saying: Malformed Command.
If you are running your Myth Tv back end on a non-standard port (anything other than 6544) you will also need to set the custom port using the !smythbot set mythbackend port command.

Step 5: Getting Help

In order to see a current list of supported commands, navigate to the smythbot room and type !smythbot help into your chat client. You should be ready yo go!

If you need any further assistance, you can find me in the sMythbot Matrix Help Room on element.io.

Clone this wiki locally