Simple GUI toolset for FFmpeg
Stu Leak
0bd704d7dc
Complete documentation for building and running VideoTools: Sections: • Quick start (2-minute setup) • Making VideoTools permanent (bash/zsh setup) • Script documentation (what each does) • Build requirements and versions • Troubleshooting guide • Development workflow • DVD encoding complete workflow • Performance notes • Production deployment guide • Getting help and reporting issues Easy setup: source scripts/alias.sh VideoTools That's all users need to run the application! |
||
|---|---|---|
| assets/logo | ||
| docs | ||
| internal | ||
| scripts | ||
| .gitignore | ||
| BUILD_AND_RUN.md | ||
| COMPLETION_SUMMARY.md | ||
| DONE.md | ||
| DVD_IMPLEMENTATION_SUMMARY.md | ||
| DVD_USER_GUIDE.md | ||
| go.mod | ||
| go.sum | ||
| install.sh | ||
| INTEGRATION_GUIDE.md | ||
| main.go | ||
| QUEUE_SYSTEM_GUIDE.md | ||
| README.md | ||
| TODO.md | ||
| videotools | ||
VideoTools Prototype
Requirements
- Go 1.21+
- Fyne 2.x (pulled automatically via
go mod tidy) - FFmpeg (not yet invoked, but required for future transcoding)
Running
Launch the GUI:
go run .
Run a module via CLI:
go run . convert input.avi output.mp4
go run . combine file1.mov file2.wav / final.mp4
go run . logs
Add -debug or VIDEOTOOLS_DEBUG=1 for verbose stderr logs.
Logs
- All actions log to
videotools.log(override withVIDEOTOOLS_LOG_FILE=/path/to/log). - CLI command
videotools logs(orgo run . logs) prints the last 200 lines. - Each entry is tagged (e.g.
[UI],[CLI],[FFMPEG]) so issues are easy to trace.
Notes
- GUI requires a running display server (X11/Wayland). In headless shells it will log
[UI] DISPLAY environment variable is empty. - Convert screen accepts drag-and-drop or the "Open File…" button; ffprobe metadata populates instantly, the preview box animates extracted frames with simple play/pause + slider controls (and lets you grab cover art), and the "Generate Snippet" button produces a 20-second midpoint clip for quick quality checks (requires ffmpeg in
PATH). - Simple mode now applies smart inverse telecine by default—automatically skipping it on progressive footage—and lets you rename the target file before launching a convert job.
- Other module handlers are placeholders; hook them to actual FFmpeg calls next.