VibEdit - simple video cutter
=============================

Cut clips out of one or more videos and join them together (or save each
clip as its own file). Uses ffmpeg, which is included in this folder.

Start
-----
Open a terminal in this folder and run ./vibedit. To start it from your
applications menu instead, run ./install.sh once (./install.sh --uninstall
removes the entry again).

The editor opens in its own window when Google Chrome, Chromium, Microsoft
Edge or Brave is installed, otherwise in a tab of your default browser.
Closing the editor window quits VibEdit after a few seconds; in a terminal,
Ctrl+C quits it right away.

To add videos VibEdit uses the zenity (GNOME and most desktops) or kdialog
(KDE) file dialog. If neither is installed it shows its own file browser;
install one for the usual dialog, for example: sudo apt install zenity

How to cut
----------
1. Click "Add videos" and pick one or more source files.
2. Move the playhead (click the timeline, arrow keys = one frame,
   Shift+arrows = one second, Up/Down = keyframes).
3. Press I to set the In point and O to set the Out point, then Enter to
   add the clip. Repeat for every part you want - from any source video.
   Or click "+ Whole" on a source and press S to split it at the playhead,
   then delete the pieces you don't want.
4. Drag the clips into order, click Export and choose:
   - Lossless: copies the original video/audio. No quality loss and very
     fast, but cuts can only start on keyframes (shown as ticks under the
     timeline), so a clip may start a little early.
   - Re-encode: frame-exact cuts; choose codec (H.264, H.265, AV1, VP9 and
     NVIDIA/Intel/AMD GPU encoders when your drivers support them),
     quality, resolution, frame rate and audio.
   - Animated GIF: a looping animation without sound, with frame-exact
     cuts; choose resolution, frame rate, dithering and whether it loops.
     Keep GIFs short - the files get large quickly.
   - Join everything into one file, or save each clip separately.
5. Captions: click "+ CC" on a source video and pick its .srt subtitle
   file. The captions show in the viewer, and Re-encode and Animated GIF
   exports burn them into the picture, timed to each clip (choose their
   size and style in the Export window). Lossless export can't add them.

Press the ? button in the editor for all keyboard shortcuts. Your project is
saved automatically (in ~/.config/vibedit) and restored the next time you
start VibEdit.

Options
-------
  ./vibedit -default-browser   open in the default browser instead
  ./vibedit -no-browser        just print the address
  ./vibedit -ffmpeg /path/to/ffmpeg -ffprobe /path/to/ffprobe

If you delete ffmpeg and ffprobe from this folder, VibEdit uses the ones
installed on your system instead.

ffmpeg is licensed separately, see ffmpeg-LICENSE.txt.