https://github.com/desjare/tabarnak

tabarnak is a python3 ffmpeg wrapper that aims at easily transcode a batch of media files from a directory to another without fuss. It will use default parameters for each supported codecs. You can also specify a lot of parameters yourself to control stream mapping, codec encoding parameters, and metadata.
https://github.com/desjare/tabarnak

audio codec encoding ffmpeg ffmpeg-wrapper hevc modern-codecs opus python3 transcodes transcoding video vp9

Last synced: 3 months ago
JSON representation

tabarnak is a python3 ffmpeg wrapper that aims at easily transcode a batch of media files from a directory to another without fuss. It will use default parameters for each supported codecs. You can also specify a lot of parameters yourself to control stream mapping, codec encoding parameters, and metadata.

• Host: GitHub
• URL: https://github.com/desjare/tabarnak
• Owner: desjare
• License: lgpl-2.1
• Created: 2020-10-20T09:17:01.000Z (over 3 years ago)
• Default Branch: main
• Last Pushed: 2020-12-28T14:55:29.000Z (over 3 years ago)
• Last Synced: 2024-03-23T08:22:06.114Z (4 months ago)
• Topics: audio, codec, encoding, ffmpeg, ffmpeg-wrapper, hevc, modern-codecs, opus, python3, transcodes, transcoding, video, vp9
• Language: Python
• Homepage: https://github.com/desjare/tabarnak
• Size: 815 KB
• Stars: 4
• Watchers: 1
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Lists

• awesome-from-stars - desjare/tabarnak

README

        
# tabarnak - transcoder [FFmpeg](https://ffmpeg.org/) based utility tool

![Port au Persil](https://github.com/desjare/tabarnak/blob/main/.www/tabarnak.png?raw=true)

![Build Status](https://travis-ci.com/desjare/tabarnak.svg?branch=main)

![Pylint](https://github.com/desjare/tabarnak/workflows/Pylint/badge.svg)

![codecov](https://codecov.io/gh/desjare/tabarnak/branch/main/graph/badge.svg?token=OTM2MYLPOM)

# Description

In the Province of Québec tabarnak is a swear derived from the tabernacle but it is an acronym for:

**T**ranscoder **A**ll **B**asically **A**ccessible **R**esolutely **N**ot **A**ll **K**lingon

> Le tact dans l'audace, c'est de savoir jusqu'où on peut aller trop loin. 

Jean Cocteau

This script is used to convert video or audio media files to modern codecs such as HEVC, VP9, AV1 (experimental) or Opus. It walks into a directory and probes media files for video or audio that are not encoded with specified codec (default HEVC). Then it transcodes them. The idea is to use a more modern codec that has a better quality/bitrate ratio. Resulting files are significantly smaller than original h264, mpeg2, mpeg4 or likely any other formats that they are currently encoded to.

tabarnak uses [crf](https://trac.ffmpeg.org/wiki/Encode/H.265) encoding. All channels are copied. The audio is converted by ffmpeg to ogg vorbis by default.

tabarnak won’t delete or clean up your files. It will skip files that are already done. Basic sanity check is performed after encoding and it will print a warning if the input and output size do not match.

If you plan to use your media files with a chrome cast, be sure the buy **chromecast ultra** since the 3rd generation chromecast does not support HEVC.

## Features

* Easy to use out of the box

  * input & output directory support

  * keep relative path option for transcoding entire hierarchy of media files

  * copy your metadata (default) or not

* Basic default configuration for basic codecs such as h264, hevc, vp9 & opus

* Custom configuration workflow using either json or yaml

* Configurable logging including basic [prometheus](https://prometheus.io/) support

* Transcoder stats output (yaml)

* Automatic tests

## Usage

### Install

pip3 install tabarnak-desjare

### Getting help

For help:

tabarnak -h

### Example usage

#### transcode all media files recursively using h264 codec and output them to the output directory 

tabarnak --input-dir . --output-dir output --h264

#### transcode your entire music library recursively using opus codec in ogg container while keeping your directory structure and copy non media files

tabarnak --copy --opus --keep-relative-path --map-args "-map 0:0 " --output-dir your_output_dir

Note that the mapping argument is necessary since iTunes files may contain unwanted tracks that prevent files to be recognised by music players.

## Requirements

* [python3](https://www.python.org/) (tested with python 3.7 and 3.8)

* [ffmpeg](https://ffmpeg.org/) in your path

I prepared a tutorial video to learn how to do that on Windows 10:

https://gist.github.com/desjare/adc1514d46bcb38414a5e2a602f6d12d