Linux versino and Gif output

linux/README.txt

@@ -0,0 +1,56 @@
+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.
+
+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.

linux/install.sh

@@ -0,0 +1,37 @@
+#!/bin/sh
+# Adds VibEdit to your applications menu. Run it again after moving this
+# folder; "./install.sh --uninstall" removes the menu entry.
+set -eu
+dir=$(cd "$(dirname "$0")" && pwd)
+apps=${XDG_DATA_HOME:-$HOME/.local/share}/applications
+entry=$apps/vibedit.desktop
+
+if [ "${1:-}" = "--uninstall" ]; then
+  rm -f "$entry"
+  echo "Removed $entry"
+  exit 0
+fi
+
+# These would need escaping in the desktop entry's Exec line.
+case $dir in
+  *[\"\`\$\\]*)
+    echo "Move this folder to a path without \" \` \$ or \\ in it, then run install.sh again." >&2
+    exit 1 ;;
+esac
+
+mkdir -p "$apps"
+cat > "$entry" <<EOF
+[Desktop Entry]
+Type=Application
+Name=VibEdit
+GenericName=Video Cutter
+Comment=Cut clips out of videos and join them with ffmpeg
+Exec="$(printf '%s' "$dir" | sed 's/%/%%/g')/vibedit"
+Icon=$dir/vibedit.png
+Terminal=false
+Categories=AudioVideo;Video;AudioVideoEditing;
+EOF
+if command -v update-desktop-database >/dev/null 2>&1; then
+  update-desktop-database -q "$apps" || true
+fi
+echo "Added VibEdit to your applications menu ($entry)"