Differences

This shows you the differences between two versions of the page.

--- features:file-recorder [2017/05/17 11:19] – created tw
+++ features:file-recorder [2019/07/09 16:18] (current) – external edit 127.0.0.1
@@ Line 17: / Line 17: @@
 To start a new recording manually, click the //Add// button in the File Recorder window. A dialog will appear:
- {{ :features:pasted:20170517-131908.png?400 }}
+{{ :features:pasted:20170517-132948.png?400 }}
-  * Audio input: Select one of the available File Recorder Inputs. The actual routing to these inputs is done in the configuration app or Control Panel, on the //Audio Devices// page. There are currently 8 inputs available. (This can easily be increased, please contact support if you need more inputs.)
+  * **Audio input:** Select one of the available File Recorder Inputs. The actual routing to these inputs is done in the configuration app or Control Panel, on the //Audio Devices// page. There are currently 8 inputs available. (This can easily be increased, please contact support if you need more inputs.)
   * **Output filename:** Select the file where the recording should be saved to.
   * **Duration:** Enter an optional duration, in seconds, after which the recording should stop automatically. Leave this field empty to record for an unlimited time, until the recording is stopped manually or programmatically.
@@ Line 28: / Line 28: @@
 The recording will start as soon as you click //OK//. You can stop it manually by selecting it in the list, then clicking //Stop// in the toolbar.
+===== Timed Recordings =====
+The File Recorder can also be used to make timed, automated recordings, using the //Start recording// and //Stop recording// actions, e.g. in the [[features:event-scheduler|Event Scheduler]], or as //Actions on start// or //Actions on stop// in the playback settings of any playlist item.
+==== Start recording ====
+Starting a recording is done using the //Start recording// action, found in the //File Recorder// section of any //Add Action// menu.
+In the properties dialog of that action, you will see the same settings as described in the section on manual recording above.
+Notes:
+  * You can use [[reference:logging_variables|Logging Variables]] inside the filename; e.g. ''Recording-%Y%M%D%h%m%s.mp3'' will incorperate the current date/time in the filename.
+  * Logging variables can also be used in the //Save copy as// filename; the date and time of the **start** of the recording is being used when resolving the variables.
+  * If you want to stop the recording programmatically using a //Stop recording// action (see below), make sure to enter a unique **Recording ID** for all recordings.
+==== Stop recording ====
+Use the //Stop recording// action to stop any running recording. Enter the same //Recording ID// as being used in the matching //Start recording// action. You can also use //*// as a wildcard to stop all running recordings.