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.
 
 
 
 
Magnus Walbeck 11e830117b
Bump version number and update Changelog. Release v0.2.0 (#17)
4 weeks ago
.github Update code to match the Nextcloud coding style and add php-cs-fixer check to lint workflow. Fixes #11 (#13) 2 months ago
.vscode Initial command 3 months ago
appinfo Bump version number and update Changelog. Release v0.2.0 (#17) 4 weeks ago
css Update code to match the Nextcloud coding style and add php-cs-fixer check to lint workflow. Fixes #11 (#13) 2 months ago
js Update code to match the Nextcloud coding style and add php-cs-fixer check to lint workflow. Fixes #11 (#13) 2 months ago
lib Add support for providing arguments to the start recording command (#15) 4 weeks ago
templates Allow connecting to Talked server over a unix socket. Fixes #9 2 months ago
.editorconfig Update code to match the Nextcloud coding style and add php-cs-fixer check to lint workflow. Fixes #11 (#13) 2 months ago
.gitignore Add github workflows and issue templates, update readme, add editorconfig, add package.json for prettier and stylelint as well as config files for those. Add Makefile for handling releases. 2 months ago
.php_cs.dist Initial command 3 months ago
.prettierrc Add github workflows and issue templates, update readme, add editorconfig, add package.json for prettier and stylelint as well as config files for those. Add Makefile for handling releases. 2 months ago
.stylelintrc.json Add github workflows and issue templates, update readme, add editorconfig, add package.json for prettier and stylelint as well as config files for those. Add Makefile for handling releases. 2 months ago
CHANGELOG.md Bump version number and update Changelog. Release v0.2.0 (#17) 4 weeks ago
LICENSE Initial commit 3 months ago
Makefile Add github workflows and issue templates, update readme, add editorconfig, add package.json for prettier and stylelint as well as config files for those. Add Makefile for handling releases. 2 months ago
README.md Add support for providing arguments to the start recording command (#15) 4 weeks ago
composer.json Initial command 3 months ago
composer.lock Initial command 3 months ago
package-lock.json Add github workflows and issue templates, update readme, add editorconfig, add package.json for prettier and stylelint as well as config files for those. Add Makefile for handling releases. 2 months ago
package.json Add github workflows and issue templates, update readme, add editorconfig, add package.json for prettier and stylelint as well as config files for those. Add Makefile for handling releases. 2 months ago

README.md

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.