summaryrefslogtreecommitdiffstats
path: root/wiki/src/contribute/how/user_experience/recording.mdwn
blob: ed74a73441275ca143f44358430910994afd3ef7 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
[[!meta title="Recording usability testing"]]

[[!toc levels=2]]

<a id="camera"></a>

Recording with a camera using <span class="application">VLC</span>
==================================================================

Recording the screen with an external camera has the following
advantages over recording with a screencast:

- Recording a whole session, even if the user restarts Tails.
- Saving the video directly to your computer and not relying on the
  computer used for the tests.

You can use a document camera. The [Ziggi-HD Plus by
IPEVO](https://www.ipevo.com/) works fine from Tails.

1. Move the <span class="guilabel">AF</span> switch of the camera to <span class="guilabel">C</span> to have continuous autofocus.

1. Install <span class="application">VLC</span>:

   <p class="pre command">apt install vlc</p>

### Prepare the camera for recording

1. In <span class="application">VLC</span>, choose
   <span class="menuchoice">
     <span class="guimenu">Media</span>&nbsp;▸
     <span class="guimenuitem">Open Capture Device...</span></span>.

1. In the <span class="guilabel">Capture Device</span> tab, select:

   - <span class="guilabel">Video device name</span>: /dev/video1
   - <span class="guilabel">Audio device name</span>: hw:1,0

1. Click the <span class="button">Play</span> button.

1. Make sure that the microphone of the camera is captured as well.

1. Adjust the orientation of the camera to capture as much of the screen as
   possible while not obfuscating the light of sight of the participant.

### Start recording

1. In <span class="application">VLC</span>, choose
   <span class="menuchoice">
     <span class="guimenu">Media</span>&nbsp;▸
     <span class="guimenuitem">Convert / Save...</span></span>.

1. In the <span class="guilabel">Capture Device</span> tab, select:

   - <span class="guilabel">Video device name</span>: /dev/video1
   - <span class="guilabel">Audio device name</span>: hw:1,0

1. Click the <span class="button">Convert / Save</span> button.

1. In the <span class="guilabel">Convert</span> dialog:

   - Select the
     <span class="guilabel">Video - H.264 + MP3 (MP4)</span> profile.

   - Specify a destination file under
     <span class="filename">~/Persistent/</span>.

<a id="screencast"></a>

Recording a screencast
======================

Recording the screen with a screencast has the following advantages over
recording with an external camera:

- Better image quality
- Lighter setup

Using <span class="application">Kazam</span>
--------------------------------------------

You can use [*Kazam*](http://recordmydesktop.sourceforge.net/) from Tails:

1. Install *Kazam*:

   <p class="pre command">apt install kazam</span>

1. Start *Kazam* and edit the *Kazam* preferences:

   - In the **General** tab:

     - Adjust the capture microphone

   - In the **Screencast** tag:

     - Lower the framerate to 10 to avoid data loss.

     - Change the file format to WEBM.

     - Enable **Automatic file saving**.

     <div class="bug">
     <p>The directory preferences is reset to <em>~/Videos</em> every time by <em>Kazam</em>.</p>
     </div>

### To autosave the recordings in persistence

1. Create a *Persistent/Videos* directory.

1. Then, either:

   - Temporarily, mount the *Videos* directory on *Persistent/Videos*.

     To do so, execute the following command:

     <p class="pre command">sudo mount --bind ~/Persistent/Videos ~/Videos</p>

   - Permanently, map the *Videos* directory to *Persistent/Videos* in your
     persistence settings.

     To do so, add the following line to your */live/persistence/TailsData_unlocked/persistence.conf*:

     <p class="pre">/home/amnesia/Videos        source=Persistent/Videos</p>

Using GNOME Shell
-----------------

Press <span class="keycap">Ctrl+Alt+Shift+R</span> in GNOME to start or stop
capturing a screencast.

The video is saved to <span class="filename">~/Videos/</span>.

<div class="bug">

<p>The screencast stops after 30 seconds. See [[!tails_ticket
12723]].</p>

<p>The screencast has no sound.</p>

</div>