otr-0.6.1 is not a library.

otr

otr is a command line tool that decodes and cuts video files from Online TV Recorder (OTR). It is running on Linux.

Features

Decoding

otr decodes OTRKEY files (i.e., encoded video files downloaded from OTR). 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].

Decoding includes verifying the checksums of the OTRKEY file and the decoded file.

Cutting

For cutting videos, there are two different options:

otr downloads cut lists from the cut list provider cutlist.at automatically
Cut intervals can be specified on the command line

This option can make sense if cutlist.at cannot provide a cut list for a certain video. In this case, the cut intervals could be determined (manually) with a video editor such as Avidemux, OpenShot or Shotcut and fed into otr on the command line.

otr cuts videos by using MKVmerge.

Fast, concurrent processing

otr tries to process files as fast as possible. Video files are decoded sequentially (i.e., one by one), but each files is decoded using concurrent threads to leverage the cpu capabilities to full extend. Cutting is done for many files simultaneously via concurrent threads as well.

Automated handling of otrkey files

It's possible to create a dedicated mime type for otrkey files. otr can be defined as default application for it.

Simple usage

Though being a command line application, the usage of otr is quite simple. If, for example, you have downloaded some OTRKEY files from OTR, the command otr process processes all files (i.e., they are decoded, cut lists are downloaded and the files are cut). With the dedicated mime type, it's even simpler: A double click on an OTRKEY file starts otr.

Installation

Manual installation

To download otr, enter

git clone https://gitlab.com/mipimipi/otr.git

After that, build otr by executing

cd otr
cargo build --release

Finally, execute

cp target/release/otr /usr/bin/otr
cp resources/otr.desktop /usr/share/applications/otr.desktop
cp resources/otrkey_mime.xml usr/share/mime/packages/otrkey_mime.xml

as root.

Since otr is the only application that can process files of the new mime type, it should now be called automatically if you double click on an otrkey file.

Installation with package managers

For Arch Linux (and other Linux distros, that can install packages from the Arch User Repository) there is a otr package in AUR.

Usage

otr process processes all video files that are submitted as command line parameters and the files stored in the working directory (see below). otr cut allows cutting a single video specifying the cut intervals on command line. See the command line help for details.

otr requires a certain schema for the name of video files (that's the schema OTR uses as well). See schema in pseudo regular expression notation for encoded and decoded files:

<name-of-video>_YY.MM.DD_hh-mm_<TV-station>_<a-number>_TVOON_DE.mpg(.|.HQ|.HD).<format>(.otrkey)?

MKVToolNix is required to cut videos. Thus, the resulting files have the Matroska container format (.mkv).

Configuration

otr requires only 3 pieces of information:

the working directory (see below)
your OTR user
your OTR password

These parameters can either be submitted on the command line or (more convenient) stored in a JSON configuration file. The path of this file can also either be submitted on the command line when otr is called or (again more convenient), the default path is used. That's <XDG-CONFIG-HOME-DIR>/otr.json, in most of the cases <XDG-CONFIG-HOME-DIR> equals to ~/.config.

Working Directory

otr requires a working directory (~/Videos/OTR, for example). In this directory, the sub directories Encoded, Decoded and Cut are created. Thus, the directory structure is like so:

<otr working dir>
    |
    |- Encoded
    |
    |- Decoded
    |   |- Archive
    |    
    |- Cut

There, video files are stored depending on their processing status. I.e., Cut contains the video files that have been cut, Decoded the decoded files that have not been cut yet (it can happen that a video can be decoded but cannot be cut because cut lists don't exist yet). If videos have been cut, the uncut version is stored under Decoded/Archive to allow users to repeat the cutting if they are not happy with the result.

otr 0.6.1

otr