markad(1) A program for the Video Disk Recorder markad(1)

MarkAd - marks advertisements in VDR recordings.

markad [options]

MarkAd marks advertisements in VDR recordings.


markad runs as a background-process
this will be automatically set if called with "after"

directory where predefined logos were stored, default /var/lib/markad
notice: channels sometimes change their logo, you have to to keep the cache up to date
wrong logos will result in bad mark results

if there is no suitable logo file found, markad will try to find the logo from the recording and store the result in the recording directory
<option> 0 = use logo only from logo cache directory
1 = extract logo from recording, if fails use logo from logo cache
2 = use logo from logo cache directory, if missing extract logo from recording (default)

this option is only available on command line usage
decode all video frame types
use it only on powerful CPUs, it will double overall run time

this option is only available for command line usage
full re-encode video generated by --cut
use it only on powerful CPUs, it will double overall run time
<streams> all = keep all video and audio streams of the recording
best = only encode best video and best audio stream, drop rest

software priority of markad when running in background
<priority> from -20...19, default 19

io priority of markad when running in background
<class> 1 = realtime, <level> from 0..7, default 4
2 = besteffort, <level> from 0..7, default 4
3 = idle (default)
make sure your I/O scheduler supports scheduling priorities and classes (e.g. BFQ or CFQ)

increments loglevel by one, can be given multiple times

make a backup of existing marks

extracts logo to recording directory as pgm files (must be renamed)
<direction> 0 = top left, 1 = top right
2 = bottom left, 3 = bottom right

markad sends an OSD-Message for start and end

write logfiles into recording directory

number of threads used for decoding, max. 16
(default is the number of cpus)

print version-info and exit

sets loglevel to the specified value
<level> 1=error 2=info 3=debug 4=trace

set a different markfile-name

disables creation of markad.pid file in recdir

start markad immediately when called with "before" as cmd
if online is 1, markad starts online for live-recordings
only, online=2 starts markad online for every recording
live-recordings are identified by having a '@' in the
filename so the entry 'Mark instant recording' in the menu
Setup - Recording of the vdr should be set to 'yes'

ip/hostname of a remote VDR for OSD messages

re-encode AC3 stream to fix low audio level of cutted video on same devices
requires --cut
use it only if you really need it, it is very CPU consuming

cut video based on marks and store it in the recording directory
there are no splits of the target file, make sure your filesystem can handle big files

use hardware acceleration for decoding
all methods supported by FFmpeg (ffmpeg -hide_banner -hwaccels)
e.g.: vaapi, vdpau, vulkan, cuda ...

run decoder performance test and compare software and hardware decoder

use VPS events from markad.vps to optimize start and stop marks

port of a remote VDR for OSD messages


cmd: one of
- dummy-parameter if called directly
nice runs markad directly and with nice(19)
after markad started by vdr after the recording is complete
before markad started by vdr before the recording is complete, only valid together with --online
edited markad started by vdr in edit function and exits immediately
<record> is the name of the directory where the recording is stored

0
Successful program execution
1
An non-recoverable error has been detected, markad has given up. See stderr, syslog or log file in the recording directory for more information

Written by Jochen Dolze <vdr@dolze.de>

Report bugs to https://github.com/kfb77/vdr-plugin-markad/issues

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version. See the file COPYING for more information.

25 May 2012 0.1.4