forked from Leak_Technologies/VideoTools
Fork of VideoTools focused on player/inspection. VT Player lets us iterate on playback, navigation, and analysis workflows independently of the full suite.
Stu Leak
71a282b828
This commit implements two new features:
1. Compare Module:
- New UI module for side-by-side video comparison
- Loads two video files and displays detailed metadata comparison
- Shows format, resolution, codecs, bitrates, frame rate, color info, etc.
- Accessible via GUI module button or CLI: videotools compare <file1> <file2>
- Added formatBitrate() helper function for consistent bitrate display
2. Target File Size Encoding Mode:
- New bitrate mode "Target Size" for convert module
- Allows users to specify desired output file size (e.g., "25MB", "100MB", "8MB")
- Automatically calculates required video bitrate based on:
* Target file size
* Video duration
* Audio bitrate
* Container overhead (3% reserved)
- Implemented ParseFileSize() to parse size strings (KB, MB, GB)
- Implemented CalculateBitrateForTargetSize() for bitrate calculation
- Works in both GUI convert view and job queue execution
Additional changes:
- Updated printUsage() to include compare command
- Added compare button to module grid with pink color
- Added compareFile1 and compareFile2 to appState
- Consistent "Target Size" naming throughout (UI and code)
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
|
||
|---|---|---|
| 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 | ||
| INSTALLATION.md | ||
| INTEGRATION_GUIDE.md | ||
| LATEST_UPDATES.md | ||
| main.go | ||
| QUEUE_SYSTEM_GUIDE.md | ||
| README.md | ||
| TEST_DVD_CONVERSION.md | ||
| TODO.md | ||
VideoTools - Professional Video Processing Suite
What is VideoTools?
VideoTools is a professional-grade video processing application with a modern GUI. It specializes in creating DVD-compliant videos for authoring and distribution.
Key Features
DVD-NTSC & DVD-PAL Output
- Professional MPEG-2 encoding (720×480 @ 29.97fps for NTSC, 720×576 @ 25fps for PAL)
- AC-3 Dolby Digital audio (192 kbps, 48 kHz)
- DVDStyler compatible (no re-encoding warnings)
- PS2 compatible (PS2-safe bitrate limits)
- Region-free format (works worldwide)
Batch Processing
- Queue multiple videos
- Pause/resume jobs
- Real-time progress tracking
- Job history and persistence
Smart Features
- Automatic framerate conversion (23.976p, 24p, 30p, 60p, VFR → 29.97fps)
- Automatic audio resampling (any rate → 48 kHz)
- Aspect ratio preservation with intelligent handling
- Comprehensive validation with helpful warnings
Quick Start
Installation (One Command)
bash install.sh
The installer will build, install, and set up everything automatically!
After installation:
source ~/.bashrc # (or ~/.zshrc for zsh)
VideoTools
Alternative: Developer Setup
If you already have the repo cloned:
cd /path/to/VideoTools
source scripts/alias.sh
VideoTools
For detailed installation options, see INSTALLATION.md.
How to Create a Professional DVD
- Start VideoTools →
VideoTools - Load a video → Drag & drop into Convert module
- Select format → Choose "DVD-NTSC (MPEG-2)" or "DVD-PAL (MPEG-2)"
- Choose aspect → Select 4:3 or 16:9
- Name output → Enter filename (without .mpg)
- Queue → Click "Add to Queue"
- Encode → Click "View Queue" → "Start Queue"
- Export → Use the .mpg file in DVDStyler
Output is professional quality, ready for:
- DVDStyler authoring (no re-encoding needed)
- DVD menu creation
- Burning to disc
- PS2 playback
Documentation
Getting Started:
- INSTALLATION.md - Comprehensive installation guide (read this first!)
For Users:
- BUILD_AND_RUN.md - How to build and run VideoTools
- DVD_USER_GUIDE.md - Complete guide to DVD encoding
For Developers:
- DVD_IMPLEMENTATION_SUMMARY.md - Technical specifications
- INTEGRATION_GUIDE.md - System architecture and integration
- QUEUE_SYSTEM_GUIDE.md - Queue system reference
Requirements
- Go 1.21+ (for building)
- FFmpeg (for video encoding)
- X11 or Wayland display server (for GUI)
System Architecture
VideoTools has a modular architecture:
internal/convert/- DVD and video encodinginternal/queue/- Job queue systeminternal/ui/- User interface componentsinternal/player/- Media playbackscripts/- Build and run automation
Commands
Build & Run
# One-time setup
source scripts/alias.sh
# Run the application
VideoTools
# Force rebuild
VideoToolsRebuild
# Clean build artifacts
VideoToolsClean
Legacy (Direct commands)
# Build
go build -o VideoTools .
# Run
./VideoTools
# Run with debug logging
VIDEOTOOLS_DEBUG=1 ./VideoTools
# View logs
go run . logs
Troubleshooting
- See BUILD_AND_RUN.md for detailed troubleshooting
- Check videotools.log for detailed error messages
- Use
VIDEOTOOLS_DEBUG=1for verbose logging
Professional Use Cases
- Home video archival to physical media
- Professional DVD authoring workflows
- Multi-region video distribution
- Content preservation on optical media
- PS2 compatible video creation
Professional Quality Specifications
DVD-NTSC
- Resolution: 720 × 480 pixels
- Framerate: 29.97 fps (NTSC standard)
- Video: MPEG-2 codec, 6000 kbps
- Audio: AC-3 stereo, 192 kbps, 48 kHz
- Regions: USA, Canada, Japan, Australia
DVD-PAL
- Resolution: 720 × 576 pixels
- Framerate: 25.00 fps (PAL standard)
- Video: MPEG-2 codec, 8000 kbps
- Audio: AC-3 stereo, 192 kbps, 48 kHz
- Regions: Europe, Africa, Asia, Australia
Getting Help
- Read BUILD_AND_RUN.md for setup issues
- Read DVD_USER_GUIDE.md for how-to questions
- Check videotools.log for error details
- Review documentation in project root