/usr/share/doc/libavifile-0.7c2/configuration.html is in libavifile-0.7c2 1:0.7.48~20090503.ds-9.1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
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 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279 280 281 282 283 284 285 286 287 288 289 290 | <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<title>Avicap Configuration</title>
<meta http-equiv="content-type"
content="text/html; charset=ISO-8859-1">
</head>
<body>
<h2>Configuring Avicap</h2>
<br>
docu by: Alexander Rawass (<a
href="mailto:alexannika@users.sourceforge.net">alexannika@users.sourceforge.net</a>)<br>
if anyone can write a better documentation - please do it and tell
me<br>
<br>
To configure Avicap, press the right mouse button and select 'Configure'
from the pop-up menu.<br>
<br>
If overlay mode is enabled, the overlay TV-picture may be drawn above
the menues, so can't read/use them.<br>
Best is, to go to the very right of the TV-window and click right mouse
there, so the menu will pop up beside the TV window.<br>
<br>
The configure dialog will show these Tabs:<br>
<br>
<ul>
<li>Device<br>
you can set up your v4l device here, select video input, color mode, capturing
size and color space</li>
<li>File</li>
<ul>
<li>Destination file<br>
this will be the default destination file if you do 'Capture Avi'</li>
<li>never overwrite existing files<br>
<does not work fully yet></li>
<li><a href="#dirpool">Directory Pool</a><br>
you can add directories there that you want to use for your recordings</li>
<li>Segmentation<br>
you should always use segmentation, because the filesystem you might use
might not allow files greater than 2 or 4MB or whatever<br>
I've set the segmentation size to 1900000 Kb (1.9GB), so I can be sure
that the files work fine on linux as well as my windows-partitions</li>
</ul>
<li>Video</li>
<ul>
<li>Video Compression Format<br>
you can select between different video-encoders and there options, when
you press 'Change'</li>
<li>Video frame rate</li>
</ul>
<li>Audio</li>
<ul>
<li>Audio compression format<br>
is not yet implemented<br>
you can only record to uncompressed PCM audio, you have to recompress
the audio later with tools like qtrecompress, mencoder or transcode or else</li>
<li>Audio format</li>
</ul>
<li>Limits</li>
<ul>
<li>you can limit the duration and file size of your recordings<br>
I might advise you to leave these options unchecked, but others might
think different<br>
if you want to record for a specific time, better use the programmable
timertable<br>
to limit the size of the file, so that your HD doesn't overflow, better
use segmentation together with the Directory Pool</li>
</ul>
<li><a href="shutdown_resume.html">Shutdown & Resume</a><br>
here you can allow Avicap to shutdown/poweroff and poweron/reboot your
computer automatically<br>
read here in full length about the <a href="shutdown_resume.html">shutdown
& resume modes</a><br>
read this, if you want to know about the options to <a
href="shutdown_resume.html">configure shutdown & resume</a></li>
<li>other</li>
<ul>
<li>Log to file<br>
all important actions get logged into ~/.avm/avicap-userlog.log<br>
you have to restart avicap for changes to have effect</li>
<li><a href="#password_lock">Password Lock</a><br>
here you can set the Lock password or lock avicap<br>
if Avicap is locked, programs which are blocked by the EPG cannot be watched<br>
</li>
</ul>
</ul>
<br>
<h3><a name="dirpool"></a>Directory Pool</h3>
The direcory pool is a list of directories, where you want Avicap to save
your recordings.<br>
<br>
Enter the name of a directory and select, how much space should be always
free on this device, then click 'add'<br>
<br>
The directory will be shown in the Direcory pool table, along with the
keep-free setting and the currently free disk space.<br>
<br>
You can enable or disable each entry per checkbox, disabled entries will
not be used for saving.<br>
<br>
With these checkboxes, you can easilty disable a directory for now and
turn it on back later.<br>
<br>
To actually use the DirPool feature, you have to learn about the 'special
way' Avicap uses to select how your files are named, and in which dir they
go:<br>
<br>
<h4><a name="naming_files"></a>Naming your files</h4>
Avicap saves files in different ways, depending on the way you name them
(either in the Configure/File/File Destionation dialog or in the Timertable/Filename
entry:<br>
<ul>
<li>absolute or relative paths (filename starts with either '/' or '.')<br>
the file will get written to that absolute or relative path, like you'd
expect it<br>
the filename might get changed if you enabled 'never overwrite existing
files'<br>
examples:
<ul>
<li>/home/alex/video/record/movie.avi</li>
<li>/windata/record/movie.avi</li>
<li>./movie.avi</li>
<li>./subdir/movie.avi</li>
</ul>
</li>
</ul>
<ul>
<li>filename has no path and ends on .avi<br>
avicap will select the <a href="#best_directory">'best' directory</a>
from the dirpool and write the file into that direcory<br>
examples:</li>
<ul>
<li>movie.avi -> /path/from/dirpool/movie.avi</li>
<li>movie123.avi -> /another/path/from/dirpool/movie123.avi<br>
<br>
</li>
</ul>
<li>filename has got no path and hasn't got an .avi ending<br>
avicap will select the 'best' directory from the dirpool<br>
avicap will append the current date as '-yymmdd-hhmmss.avi' to the filename<br>
examples:</li>
<ul>
<li>movie -> /path/from/dirpool/movie-030401-190000.avi</li>
<li>movie347beta -> /another/path/from/dirpool/movie347beta-030402-201500.avi<br>
<br>
</li>
</ul>
<li>no filename at all<br>
avicap will select the 'best' directory from the dirpool<br>
avicap will name the file 'avicap-yymmdd-hhmmss.avi' , depending on your
date<br>
use this to never care for filenames any more<br>
no example ;-)</li>
</ul>
<br>
Warning:<br>
If you use absolute or relative paths, the dirpool doesn't get used and
Avicap also doesn't check for free space on disk or segements to different
directory<br>
<br>
When you use the dirpool, avicap will try to find a directory with enough
free space and then segments there.<br>
<br>
It is recommended to not use absolute/relative paths at all.<br>
<br>
<h4><a name="best_directory"></a>How Avicap finds the 'best' directory</h4>
Avicap will select the directory from the dirpool as 'best' , where Avicap
has the most free space to write to.<br>
<br>
Avicap respect the 'keep free' setting, and will stop recording into that
directory if the 'keep free' limit is reached.<br>
Avicap will then try to select another dir from the dirpool, and continue
the current recording by segmenting it.<br>
<br>
<noy yet> If Avicap cannot find free space anymore, avicap will abort
the current recording and disable all other recordings, then it will go into
shutdown (if selected).<br>
<br>
<br>
<h3><a name="password_lock"></a>Password Lock</h3>
The password lock is a feature for parents, who don't have the time to care
about their children and simply park them before the TV (or rather Avicap),
so they don't have to communicate with their children.<br>
<br>
If you don't want to care what your children are watching, or if you have
better things to do than be with your children, you can use the password
lock to simply forbid your children to watch any TV shows you don't like
them to watch.<br>
<br>
<h4>Setting up your unix system for use with password lock</h4>
<br>
First, you need separate accounts for parent 'parent' and child 'child'.<br>
<br>
Install avicap as root like you normally do.<br>
<br>
Now change the owner of your /dev/video device to 'parent' and make sure
that your children have no access to /dev/video at all.<br>
<br>
Then make sure that the home dir of 'parent', the dir ~parent/.avm and especially
the files<br>
~parent/.avm/default and ~parent/.avm/avicap-regexps<br>
are not readable (or writable) for your children.<br>
<br>
Then change (as root) the owner of the avicap binary (usually /usr/local/bin/avicap
) to 'parent' and set the setuid-bit on the binary.<br>
<br>
That way, when avicap is started, it runs as user 'parent'<br>
<br>
Now start avicap as parent.<br>
<br>
Go to config/others and do 'Set Password'<br>
<br>
You get prompted for a password, enter it twice and click the button.<br>
<br>
Then click 'press to lock'.<br>
<br>
After that, Avicap will get locked, with those effects:<br>
<ul>
<li>the epg window will start up</li>
<li>on a channel switch, avicap will verify what program/show is currently
running on this channel.</li>
<li>if the current program is blocked in the EPG, avicap will not allow
to switch to that channel</li>
<li>avicap won't allow free editing of the regexps file (deleting blocked
regeps is not possible)</li>
<li>avicap won't allow changing of the EPG provider</li>
<li>avicap won't allow unlocking unless password given</li>
<li>at a restart of avicap, avicap is still locked</li>
</ul>
Your children can now use Avicap to watch TV, but it is not possible for
them to switch to a blocked channel.<br>
<br>
WARNING: the timertable has still full access to all channels YET!!<br>
<br>
You have to have a valid EPG provier, you should have sensible regexps for
blocking, and you should make sure that the epg xml date is updated at least
every day.<br>
<br>
If the epg data doesn't get updated, or if avicap cannot find the epg xml
file, the lock will not be able to block channels any more.<br>
<br>
Make also sure that your children also cannot read/write the epg xml data
and the nxtvepg data directory etc<br>
<br>
<br>
Security thoughts:<br>
<ul>
<li>your children could download, compile, run or use other TV software<br>
BUT since /dev/video is setuid of 'parent', only TV software which runs as
root or 'parent' can access the video device, and your children have to get
root access for that</li>
<li>the password is saved into the file ~parent/.avm/default unencrypted
(yet)<br>
BUT, if the permissions of 'parent' and its subdirs are okay, it is not possible
for your children to read or write this file</li>
<li>the regexps in ~parent/avicap-regexps can also not be edited or read
without special permissions</li>
<li>you should set the umask of 'parent' to secure values<br>
</li>
</ul>
If you've got ideas to improve security or a flaw in the password lock feature,
tell us.<br>
<br>
</body>
</html>
|