Leak_Technologies/VideoTools
Leak_Technologies/VideoTools
2
0
Fork 1
Code Issues 6 Pull Requests Actions Packages Projects Releases Wiki Activity
Simple GUI toolset for FFmpeg
472 Commits 1 Branch 17 Tags 122 MiB
Go 83.6%
Shell 10.7%
PowerShell 3.3%
Batchfile 2.4%
02c2e389e0
Go to file
Stu Leak 02c2e389e0 perf(queue): Fix Windows button lag and optimize UI performance 
Queue View Improvements:
- Fix Windows-specific button lag after conversion completion
- Remove redundant refreshQueueView() calls in button handlers
- Queue onChange callback now handles all refreshes automatically
- Add stopQueueAutoRefresh() before navigation to prevent conflicts
- Reduce auto-refresh interval from 500ms to 1000ms
- Result: Instant button response (was 1-3 second lag on Windows)

Main Menu Performance:
- Implement 300ms throttling for main menu rebuilds
- Cache jobQueue.List() to eliminate multiple expensive copies
- Smart conditional refresh: only update when history actually changes
- Add refreshMainMenuThrottled() and refreshMainMenuSidebar()
- Result: 3-5x improvement in responsiveness, especially on Windows

Queue Position Display:
- Fix confusing priority labeling in queue view
- Change from internal priority (3,2,1) to user-friendly positions (1,2,3)
- Display "Queue Position: 1" for first job, "Position: 2" for second, etc.
- Apply to both Pending and Paused jobs

Remux Safety System:
- Add comprehensive codec compatibility validation before remux
- Validate container/codec compatibility (MP4, MKV, WebM, MOV)
- Auto-detect and block incompatible combinations (VP9→MP4, etc.)
- Automatic fallback to re-encoding for WMV/ASF and legacy FLV
- Auto-fix timestamp issues for AVI, MPEG-TS, VOB with genpts
- Add enhanced FFmpeg safety flags for all remux operations:
  * -fflags +genpts (regenerate timestamps)
  * -avoid_negative_ts make_zero (fix negative timestamps)
  * -map 0 (preserve all streams)
  * -map_chapters 0 (preserve chapters)
- Add codec name normalization for accurate validation
- Result: Fool-proof remuxing with zero risk of corruption

Technical Changes:
- Add validateRemuxCompatibility() function
- Add normalizeCodecName() function
- Add mainMenuLastRefresh throttling field
- Optimize queue list caching in showMainMenu()
- Windows-optimized rendering pipeline

Reported-by: Jake (Windows button lag)
Reported-by: Stu (main menu lag)

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2025-12-28 06:31:16 -05:00
assets/logo Enhance Author module structure and implement drag-and-drop support 2025-12-22 20:09:43 -05:00
cmd/player_demo Implement VT_Player module with frame-accurate video playback 2025-12-21 16:31:44 -05:00
docs Rewrite Author module docs for accessibility 2025-12-26 19:33:51 -05:00
internal perf(queue): Fix Windows button lag and optimize UI performance 2025-12-28 06:31:16 -05:00
scripts Fix subtitle module drag and drop and remove emojis from scripts 2025-12-26 20:17:24 -05:00
.gitattributes Enforce LF endings for shell scripts 2025-12-13 21:30:17 -05:00
.gitignore Turned GIT Converter Modular 2025-12-14 03:00:44 +00:00
author_dvd_functions.go Finalize authoring workflow and update install docs 2025-12-23 14:24:09 -05:00
author_module.go fix(author): Clear DVD title when loading new file or clearing clips 2025-12-28 06:30:48 -05:00
config_helpers.go Add persistent configs for author/subtitles/merge/rip 2025-12-24 15:39:22 -05:00
DONE.md feat(author): Implement real-time progress, add to queue, clear title 2025-12-27 01:34:57 -05:00
filters_module.go Extract filters module from main.go 2025-12-23 21:35:06 -05:00
FyneApp.toml Mark dev20 across metadata 2025-12-23 14:39:44 -05:00
go.mod Implement in-app playback with ffmpeg frame pump and Go audio 2025-11-20 16:11:56 -05:00
go.sum Implement in-app playback with ffmpeg frame pump and Go audio 2025-11-20 16:11:56 -05:00
inspect_module.go Extract inspect module from main.go 2025-12-23 20:51:42 -05:00
main.go perf(queue): Fix Windows button lag and optimize UI performance 2025-12-28 06:31:16 -05:00
main.go.backup-before-inspect-extraction Add thumb module files 2025-12-23 21:57:41 -05:00
merge_config.go Add persistent configs for author/subtitles/merge/rip 2025-12-24 15:39:22 -05:00
naming_helpers.go Add queue error copy, auto naming helper, and metadata templating 2025-12-07 12:03:21 -05:00
platform.go Hide ffmpeg console windows on Windows and fix inspect clear button 2025-12-08 11:26:14 -05:00
PLAYER_PERFORMANCE_ISSUES.md Document and fix player module stuttering issues 2025-12-23 21:09:21 -05:00
README.md Update README.md 2025-12-24 00:31:55 +00:00
REFACTORING_PROMPT_FOR_OPENCODE.md Add comprehensive refactoring guide for opencode 2025-12-23 21:30:17 -05:00
rip_module.go Add persistent configs for author/subtitles/merge/rip 2025-12-24 15:39:22 -05:00
setup-windows.bat Add dev14 fixes: progress tracking, AMD AMF support, DVD resolution fix, and Windows build automation 2025-12-04 17:11:15 -05:00
subtitles_module.go Phase 1 Complete: All upscale utilities migrated 2025-12-26 21:15:50 -05:00
thumb_module.go Finish thumb module extraction fixes 2025-12-23 22:05:54 -05:00
TODO_EXTRACTION_NOTES.md Phase 1 Complete: All upscale utilities migrated 2025-12-26 21:15:50 -05:00
TODO.md feat(author): Implement real-time progress, add to queue, clear title 2025-12-27 01:34:57 -05:00
upscale_module.go Fix build blockers and continue refactoring 2025-12-23 23:50:51 -05:00
VideoTools.desktop Add app icon support and window sizing improvements 2025-12-20 14:13:18 -05:00
WINDOWS_BUILD_PERFORMANCE.md Update Windows build guide for Git Bash users 2025-12-23 20:55:47 -05:00

README.md

VideoTools - 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 scripts/install.sh

The installer will build, install, and set up everything automatically with a guided wizard!

After installation:

source ~/.bashrc    # (or ~/.zshrc for zsh)
VideoTools

Alternative: Developer Setup

If you already have the repo cloned (dev workflow):

cd /path/to/VideoTools
bash scripts/build.sh
bash scripts/run.sh

For detailed installation options, troubleshooting, and platform-specific notes, see INSTALLATION.md. For upcoming work and priorities, see docs/ROADMAP.md.

How to Create a Professional DVD

  1. Start VideoTools → VideoTools
  2. Load a video → Drag & drop into Convert module
  3. Select format → Choose "DVD-NTSC (MPEG-2)" or "DVD-PAL (MPEG-2)"
  4. Choose aspect → Select 4:3 or 16:9
  5. Name output → Enter filename (without .mpg)
  6. Queue → Click "Add to Queue"
  7. Encode → Click "View Queue" → "Start Queue"
  8. 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 encoding
  • internal/queue/ - Job queue system
  • internal/ui/ - User interface components
  • internal/player/ - Media playback
  • scripts/ - 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=1 for 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

  1. Read BUILD_AND_RUN.md for setup issues
  2. Read DVD_USER_GUIDE.md for how-to questions
  3. Check videotools.log for error details
  4. Review documentation in project root