#decode #file-format #otrkey #online-tv-recorder

otr-utils

Utilities for decoding and cutting video files that were downloaded from Online TV Recorder https://onlinetvrecorder.com/

11 unstable releases (3 breaking)

0.4.0 Nov 10, 2024
0.3.2 Nov 9, 2024
0.2.1 Oct 31, 2024
0.1.4 Oct 27, 2024
0.1.0 May 8, 2024

#195 in Video

Download history 8/week @ 2024-07-29 2/week @ 2024-08-05 10/week @ 2024-09-23 464/week @ 2024-09-30 41/week @ 2024-10-07 3/week @ 2024-10-14 80/week @ 2024-10-21 470/week @ 2024-10-28 306/week @ 2024-11-04 69/week @ 2024-11-11

925 downloads per month
Used in otr

GPL-3.0-or-later

110KB
2.5K SLoC

Crates.io REUSE status

otr-utils

otr-utils provides tools to decode and cut video files from Online TV Recorder (OTR). It is the basis of the commandline tool otr.

Decoding

Decoding of OTRKEY files (i.e., encoded video files downloaded from OTR) is supported. The decoding functionality is based on the work of eddy14, who reverse-engineered the OTRKEY file format, see his blog post [German, mirrored by PyroPeter].

Cutting

Cutting of decoded videos is done by using FFmpeg together with FFMS2. It is done accurate to frames. I.e., even if a boundary of a cut interval is not at a key frame, cutting is done exactly at that boundary. To achieve this, parts of the video might have to be re-encoded.

With respect to cut list determination and selection, there are two different options:

  1. Cut lists are downloaded from the cut list provider cutlist.at and selected automatically

    If multiple cut lists are available, those with a high rating are preferred.

  2. A cut list is passed explicitely to the cut function as vector of cut intervals

    This option can make sense if cutlist.at cannot provide a cut list for a video. In this case, the cut function can upload such cut lists to cutlist.at to make them publicly available. This requires a registration at cutlist.at (i.e., an access token - $$FRED).

License

GNU Public License v3.0

Dependencies

~13–27MB
~432K SLoC