/talked-client

Client for Talked

Primary LanguagePHPGNU Affero General Public License v3.0AGPL-3.0

Talked client

Call recording for Nextcloud Talk. This app provides a chat based interface to interact with the Talked server component that handles the actual recording.

Check out the Talked server repo for more information on how this works and what the current limitations are.

Installation and setup

It's available in the Nextcloud app store, just search for Talked and you should be able to find it.

Or you can clone this repo into your app folder and enable it in the app menu in Nextcloud.

Register chat command

To use the chat command to interact with the Talked server, the command first needs to be registered with Talk. You can register a command using the occ command. The exact command depends on how you have installed Nextcloud. Below I'll have an example for the official docker container and the snap. For more information about registering a chat command, check out the Talk documenation: https://nextcloud-talk.readthedocs.io/en/latest/commands/

You will find two examples for both the docker container and snap. The only difference is whether you want to allow all registered users in a room to start a recording, or only the moderators.

Docker container

Only moderators can use
php occ talk:command:add recording Talked "php /var/www/html/occ talked:record {ROOM} {ARGUMENTS}" 2 1
All registered users can use
php occ talk:command:add recording Talked "php /var/www/html/occ talked:record {ROOM} {ARGUMENTS}" 2 2

Snap

Only moderators can use
occ talk:command:add recording Talked "php /var/www/html/occ talked:record {ROOM} {ARGUMENTS}" 2 1
All registered users can use
occ talk:command:add recording Talked "php /var/www/html/occ talked:record {ROOM} {ARGUMENTS}" 2 2

Configuring Talked

After you have registered the Talk command you should configure Talked. If you head to Admin settings > Talk, then you will find the settings for Talked near the bottom. Here you can specify the URI for your Talked server and whether to use HTTP Basic auth, and the credentials for HTTP Basic auth.

The http / https should be included in the url, for example: https://talked.example.com

You can also connect to the Talked server over a unix socket. To specify the path to a unix socket prefix the path with unix: for example: unix:/tmp/talked.sock.

Please note that abstract sockets aren't supported.

Usage

To use Talked, simply use the /recording command in a chat room. If you don't specify any options or run /recording help you will get a help message telling you about the different options. The following options are available:

  • /recording start - starts a recording in the current room.
  • /recording stop - stops the active recording.
  • /recording status - checks if there is an active recording.
  • /recording info - prints the version number of the Talked server.
  • /recording help - prints a help message with the different options.

Audio only

When starting a recording you can also supply a audio_only options which allows you to configure whether the recording should be with or without video. The default is to record with video, so to record just audio you could use the following start command:

/recording start audio_only=true

If you have the changed the default to be audio only recordings you can simply change the true to false to create a recording with video.

License

This program is licensed under the AGPLv3 or later.