Matrix Live - Liveblogging based on Matrix by KABI.tk

How to use it

How do you get your own liveblog using Matrix Live? Start by setting up the Matrix room you want to use, afterwards generate the link or embed code to Matrix Live, include it on your website / blog and you are ready to go.

Step 1: Set-up Matrix room

If you are not yet a Matrix user, head over to Riot by KABI.tk and use either the web or one of the mobile clients to register an account in the Matrix ecosystem. Within Riot (screenshots are from Riot Web) you can then create a new room to liveblog in by clicking on the “Plus” sign. You can assign a room name and should end up with an empty room as in the screenshot below.

Afterwards, you need to set this room to publicly viewable (such that Matrix Live and your visitors can access it) and obtain its internal ID, which is used to access the room in Matrix Live:

Access settings for the room
Access settings for the room

In the room settings, you can set the room to world viewable but keep it as invite-only (to avoid others posting on your live blog):

Set room to readable by anyone, then scroll down
Set room to readable by anyone, then scroll down

Scroll down to find your internal room ID:

Write down your internal room ID and save your changes
Write down your internal room ID and save your changes

If everything has saved correctly, Riot should inform you that your room history is now viewable by anyone:

Alex made future room history visible to anyone.
Alex made future room history visible to anyone.

Using the internal room ID, you are now ready to generate your Matrix Live link or embed code.

Step 2: Generate link or embed code

Just head over to the Matrix Live Generator. Fill in the home server and room ID you want to use and the other optional fields and click on “Generate”. The tool will check whether the homeserver and room ID are valid and correctly configured (you need to use a homeserver that allows guest access and your room needs to be configured as world-readable as per the above). If everything checks out, you will receive two options to use Matrix Live:

  1. A link that you can link to and that will display your liveblog on a separate page.
  2. Pieces of HTML code that you can embed in your website or blog post and which will make your live blog appear within your website at the point where you insert the <hello-matrix> tag.

Step 3: Use on your website or link to from social media

You can use either the link or the embed code to make your liveblog go “on air”. As soon as you have promoted the link or embedded the embed code, you already to start liveblogging!

Step 4: Start liveblogging

When a visitor visits your liveblog, he or she will see the latest entries you made (the newest will be at the top; by default a bit less than sixty are displayed, see the generator for details) immediately. Afterwards, the connection remains active as long as the visitor remains on the site and any new stuff you write or pictures you send to your room in Matrix will be pushed to the visitor and displayed at the top of the liveblog.

So just go ahead, grab the Matrix client of your choice (we recommend Riot) and start liveblogging! If you have invited other users into your room, they can also write and upload pictures, those will also be displayed to your readers (so be careful who you let into your room).

You can use Markdown to format text in your messages. If you want to embed videos, Matrix Live supports YouTube, Vimeo and DailyMotion. You can add the link to the video’s page using Markdown’s syntax for inline images:

![Video](https://vimeo.com/161820611)

Matrix Live will recognise that this is a reference to a video site and will embed this site’s inline player for you.

You can also upload pictures, videos and other files directly using your Matrix client. If you upload pictures, a thumbnail will be displayed in the live blog. If the picture is larger than the thumbnail size, a hyperlink will allow the user to access the full-size picture. For videos, a HTML5 video player will be displayed. For other files, a generic download link will be generated.

If you have made a mistake and want to remove a message you have written, you can do so with any Matrix client that supports redactions, as long as you are administrator in your room (you will be if you have created the room yourself as described above). In Vector Web, click on the three dots next to the message you want to remove and then on “Redact”:

Click on the "three dots" and then on "Redact"
Click on the "three dots" and then on "Redact"

The message will disappear for users who are receiving the live stream and will not be displayed for any new visitors accessing the liveblog. As Matrix is a messaging application, you cannot edit existing messages or backdate new ones.