https://github.com/rlaphoenix/chapsnap

Resync Chapters by snapping them to Scene Changes
https://github.com/rlaphoenix/chapsnap

chapters matroska python scene-detection video

Last synced: about 1 year ago
JSON representation

Resync Chapters by snapping them to Scene Changes

• Host: GitHub
• URL: https://github.com/rlaphoenix/chapsnap
• Owner: rlaphoenix
• License: gpl-3.0
• Created: 2023-04-26T00:12:41.000Z (about 3 years ago)
• Default Branch: master
• Last Pushed: 2023-04-30T19:50:33.000Z (about 3 years ago)
• Last Synced: 2025-03-31T01:41:36.804Z (about 1 year ago)
• Topics: chapters, matroska, python, scene-detection, video
• Language: Python
• Homepage:
• Size: 35.2 KB
• Stars: 31
• Watchers: 2
• Forks: 1
• Open Issues: 3
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# ChapSnap

Resync Chapters by snapping them to Scene Changes.

## Usage

```

Usage: chapsnap [OPTIONS] VIDEO [CHAPTERS]

  Snap Chapters to Scene Changes.

  VIDEO       The video file to snap chapters to scene changes. All video formats are

              supported. You may alternatively provide a directory path to process

              video files in batch.

  [CHAPTERS]  Optional chapters file if you want to use chapters from a file

              rather than ones already muxed with the video.

Options:

  -t, --threshold FLOAT  Threshold on Scene Change probability scores. The

                         lower the value, the more unlikely the frame is to be

                         a Scene Change. Range: 0.0 (Impossible) - 1.0

                         (Definite).

  -o, --offset FLOAT     Offset to apply to each Chapter. A negative offset

                         may result in fewer Chapters.

  --trim INTEGER         Remove n Chapters from the start of the Video. A

                         negative value will remove n Chapters from the end of

                         the Video. Timestamps will be offset respectively.

  -nf, --no-forward      Do not try to resync Chapters forward in time.

  -nb, --no-backward     Do not try to resync Chapters backward in time.

  -k, --keyframes        Only sync to Scene Changes on Keyframes (I-frames).

  -0, --zero             Force the first chapter to be at `00:00:00.000`, even

                         after offsets and trims.

  -c, --chain            Chain sync adjustments from one Chapter to the next.

                         E.g., Chapter 1 had -2, so Chapter 2 will begin with

                         an offset of -2. Chapter 2 with -2 has a change of

                         -1, so Chapter 3 will begin with an offset of -3 and

                         so on.

  --overwrite            Apply new Chapters to the input video file in-place,

                         without making a duplicate.

  --help                 Show this message and exit.

```

## Contributors



## License

© 2023 rlaphoenix — [GNU General Public License, Version 3.0](LICENSE)