Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/feuster/ffchapters2

FFchapters2 is a FFmpeg based video chapter generation tool
https://github.com/feuster/ffchapters2

chapter chapter-backend chapter-creation chapter-frontend chapter-generation chapters cli ffchapters ffchapters2 ffmpeg ffmpeg-metadata film-editing matroska matroska-chapters matroska-files metadata mkv-chapters mkv-files movie-chapters video

Last synced: about 1 month ago
JSON representation

FFchapters2 is a FFmpeg based video chapter generation tool

Awesome Lists containing this project

README

        

# FFchapters2

## Introduction
FFchapters2 is a FFmpeg based video chapter generation tool.

FFchapters2 uses FFmpeg for frame accurate movie scene change detection and creates a chapter file, suitable for e.g. for Matroska
and/or a metafile for use directly with ffmpeg (add ```-i "\.meta" -map_metadata 1``` to your ffmpeg commandline).

As alternative you can use the [AddChaptersToMovieFile.cmd](./AddChaptersToMovieFile.cmd) Windows script by drag & drop your movie file on it to create a copy with generated markers.

There is also the optional raw mode creates an additional timestamp raw file for independent use.

An optional validation can inform you if the created chapters differ from the chapter assumption.

## FFmpeg Installation
The required FFmpeg is not be bundled with the FFchapters2 Linux release.
In that case or if you intend to use another ffmpeg binary for the Windows version you can download a FFmpeg binary
at the [FFmpeg homepage](https://ffmpeg.org/download.html).

The FFmpeg binary can be utilized by FFchapter2 via the following options:
- the FFmpeg binary is situated in the same folder as the FFchapters2 binary
- the FFmpeg binary can be globally accessed in the OS for e.g. when situated in a $PATH environment variable defined folder
- the path to the FFmpeg binary can be in FFchapters2 configured with the commandline switch -f or --ffmpeg, for e.g. ```-f "\ffmpeg.exe"```
- as default ffmpeg binary is "ffmpeg.exe" searched in Windows and "ffmpeg" (without extension) in Linux, you can override this also with ```-f "\<.OPTIONALEXTENSION>"```

## Hint
For a better representation it is recommended to use a "Nerd" font in your terminal. See the [Nerdfonts Homepage](https://www.nerdfonts.com/) for details.

## License / Copyright
FFchapters2 is licensed under [GPL-2.0-only](./LICENSE).

© Alexander Feuster 2023-2024

## Demo screenshots

Chapter creation

![Running Demo](./Running.gif)

Chapter validation

![Validation Demo](./Validation.png)