markad(1)

💖 markad(1) — the markad glow-up 💖

okay bestie, gather round, because we're talking about markad — a program for the Video Disk Recorder, and she is that girl. ✨ This is a markad manual page, just... with an actual personality. 💅

---

✨ NAME ✨

MarkAd — marks advertisements in VDR recordings. that's it, that's the whole job, and she does it flawlessly no cap. 👑

---

🦋 SYNOPSIS 🦋

markad [options]

---

🌸 DESCRIPTION 🌸

MarkAd marks advertisements in VDR recordings. periodt. she looks at your recording, she figures out where the ads are, she leaves marks. iconic behaviour fr fr. 🎀

---

👑 OPTIONS 👑

first things first, the shape of a call:

Usage: markad [options] <cmd> <recording>

and now the whole menu, one bullet at a time, because we do not skip anything in this house. 😤

• -b, --background — markad runs as a background process. this gets set automatically if you call it with after, so lowkey you don't have to lift a finger. 🫶
• -l, --logocachedir — the directory where predefined logos were stored, default /var/lib/markad.

Note: Channels sometimes change their logo. If logos kept in the cache are out of date, this will result in bad mark results. 💀 so keep that cache fresh babes.

• --autologo=<option> — picks the whole logo strategy, choose wisely:
  • 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)

If no suitable logo file is found, markad will try to find the logo in the video and store the result in the recording directory. resourceful queen. 🌈

• --fulldecode — decode all video frame types. use it only on powerful CPUs, it will double overall run time. highkey a flex on your hardware, only do it if you can afford it. 🔥
• --cut — cut video based on marks and store it in the recording directory. there are no splits of the target file, so make sure your filesystem can handle big files. bestie, check your filesystem first, i'm serious. 😭
• --smartencode — this option is only available on command line usage, and it requires --cut. it re-encodes only short before and short after cut position. economical, we love her. 💜
• --fullencode=<streams> — this option is only available for command line usage, requires --cut, and it full re-encodes 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
  • <streams> best = only encode best video and best audio stream, drop rest
• -p, --priority=<priority> — software priority of markad when running in background. <priority> goes from -20...19, default 19.
• -r, --ioprio=<class>[,<level>] — I/O priority of markad when running in background:
  • <class> 1 = realtime, <level> from 0..7, default 4
  • <class> 2 = besteffort, <level> from 0..7, default 4
  • <class> 3 = idle (default)

Make sure your I/O scheduler supports scheduling priorities and classes (e.g. BFQ or CFQ). no scheduler support, no priority magic, iykyk. 🌸

• -v, --verbose — increments loglevel by one, can be given multiple times. stack it like it's a fragrance. ✨
• -B, --backupmarks — make a backup of existing marks. be safe, keep a copy, we stan a prepared queen. 🎀
• -L, --extractlogo=<direction>[,width[,height]] — this parameter is deprecated, use autologo instead. it extracts logo to recording directory as pgm files (must be renamed). the details:
  • <direction> 0 = top left, 1 = top right, 2 = bottom left, 3 = bottom right
  • [width] range from 50 to 480, default 192 (SD) / 288 (HD)
  • [height] range from 20 to 250, default 100 (SD) / 180 (HD)

deprecated means deprecated bestie, go use autologo. 💅

• -O, --OSD — markad sends an OSD message for start and end. little pop-up moment, so cute. 🦋
• -R, --log2rec — write log files into recording directory.
• -T, --threads=<number> — number of threads used for decoding, max. 16 (default is the number of CPUs). don't try to sneak past 16, she said what she said. 😌
• -V, --version — print version info and exit. short, sweet, done.
• --loglevel=<level> — sets log level to the specified value:
  • <level> 1 = error
  • <level> 2 = info
  • <level> 3 = debug
  • <level> 4 = trace
• --markfile=<markfilename> — set a different marks filename. your file, your rules. 🌈
• --nopid — disables creation of markad.pid file in the recording directory.
• --online[=1|2] — only used by markad plugin internal call, do not use it for command line start. default is 1. it starts 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. 🫡
• --svdrphost=<ip/hostname> — (default is 127.0.0.1) IP or hostname of a remote VDR for OSD messages.
• --ac3reencode — re-encode AC3 stream to fix low audio level of cut video on same devices. requires --cut. use only if really needed, as this consumes significant CPU resources. fr fr, she's hungry for your CPU. 🔥
• --hwaccel=<hardware_acceleration_methode> — use hardware acceleration for decoding. all methods supported by FFmpeg (ffmpeg -hide_banner -hwaccels), e.g.: vaapi, vdpau, vulkan, cuda ... go find out what your machine can do, main character energy. 💜
• --perftest — run decoder performance test and compare software and hardware decoder. science. ✨
• --vps — use VPS events from markad.vps to optimize start and stop marks.
• --svdrpport=<port> — ( default is 6419 ) port of a remote VDR for OSD messages.
• <cmd> is 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. only used by markad plugin internal call, do not use it for command line start
  • before — markad started by VDR before the recording is complete, only valid together with --online. only used by markad plugin internal call, do not use it for command line start
  • edited — markad started by VDR in edit function and exits immediately. only used by markad plugin internal call, do not use it for command line start
• <record> — is the name of the directory where the recording is stored.

---

🌟 EXIT STATUS 🌟

• 0 — Successful program execution. she ate and left no crumbs. 🎉
• 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. she tapped out, check the receipts. 😭

---

💜 AUTHOR 💜

Written by Jochen Dolze <vdr@dolze.de>. the original icon, we thank her. 🙌

---

🐛 REPORTING BUGS 🐛

Report bugs to https://github.com/kfb77/vdr-plugin-markad/issues. don't be shy, the issue tracker is a safe space. 🫶

---

📜 COPYRIGHT 📜

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. free as in freedom, babes. 🌈

---

and that's the whole page!! markad version 24.2.0, dated 25 September 2024. go mark some ads bestie, you're gonna slay. 💖✨🎀