A tool to record every participant of a legacy or new matrix, call to separate audio and video files.
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Marcel Radzio e9a525f1a5
„.github/dependabot.yml“ hinzufügen
4 weeks ago
.github „.github/dependabot.yml“ hinzufügen 4 weeks ago
.vscode Initial version (missing renegotiation of streams) 2 months ago
matrix_call_multitrack_recorder FOSDEM fixes 2 months ago
tests Initial version (missing renegotiation of streams) 2 months ago
.editorconfig Initial version (missing renegotiation of streams) 2 months ago
.gitignore Send Recording Duration as video stream 2 months ago
LICENSE Update readme and add license 2 months ago
README.md Add requirements 4 weeks ago
black.png FOSDEM fixes 2 months ago
pyproject.toml Improve state keeping by using futures instead of while loops and sleep 2 months ago

README.md

matrix-call-multitrack-recorder

PyPI - Version PyPI - Python Version


Table of Contents

Production-readyness

This bot currently is missing some polishing especially on stability and usability. Also it doesnt work with rejoining currently or changing streams. Therefor I do recommend it should not be used in production just yet.

Installation

Due to changes to the nio dependency I currently cant upload it to pypi. For now you have to install it from git directly:

Requirements

Ubuntu

  • python3-pip
  • git
  • libolm-dev
pip3 install git+https://git.nordgedanken.dev/mtrnord/matrix-call-multitrack-recorder.git

Usage

Please Note that this is still in alpha. State inconsistencies are to be expected.

Starting/Stopping a recording

1-1 Rooms

In 1-1 Rooms the recording starts automatically after ~1-2s. Currently it will keep saying it is connecting. There is a fix for this in the pipeline but yet to be written.

A call stops when the call ends.

Matrix-Call Rooms

Here the call doesn't automatically start. Instead you need to run !start. This can happen before or after joining. The bot will write a message when the recording was successfully started. In case the time isn't shown by the bot you should be able to make it update by changing rooms.

To stop the recording you run !stop.

The bot should record everyone joining late as well. There may be a slight delay due to call handshaking before it actually starts. New joining people may not see the Video currently. A fix is planned.

Where are the recordings?

Currently they get stored to the working directory of the bot in a folder named recordings. In that folder you find a folder per call or conference id. In there you find each stream separate. Note that changing the audio device, webcam being turned off and on again or screensharing may cause new recording files as the webrtc connection might be rengotiated. There is also a chance that this fails currently. A fix is on the way.

Later it is planned to be able to download them as well as optionally postprocess and merge them.

Please note that if you have a Element-Call Room in Element clients the call doesn't end when everyone leaves. The bot currently therefor does not create a new folder.

License

matrix-call-multitrack-recorder is distributed under the terms of the AGPL-3.0-or-later license.