VT_Player/docs/README.md
Stu 18a14c6020 Refactor to modular architecture with rainbow UI (v0.1.0-dev8)
Major refactoring to improve code organization and enhance UI:

Architecture:
- Split monolithic main.go into modular internal/ package structure
- Created internal/logging for centralized logging system
- Created internal/modules for module handler functions
- Created internal/ui for UI components and layouts
- Created internal/utils for shared utility functions

UI Enhancements:
- Implemented rainbow gradient across 8 module buttons (violet→red)
- Increased module button text size to 20 for better readability
- Fixed text centering on module tiles
- Converted Simple/Advanced mode toggle to tabs to save vertical space
- Added vertical scrollbars to prevent UI overflow
- Added metadata copy button (📋) to copy all metadata to clipboard

Video Processing:
- Fixed aspect ratio conversion to default to center-crop behavior
- Added 6 aspect handling modes: Auto, Crop, Letterbox, Pillarbox, Blur Fill, Stretch
- Fixed blur fill to maintain source resolution with padding (no scaling)
- Ensured all FFmpeg filters produce even-numbered dimensions for H.264

Known Issues:
- WMV files still produce FFmpeg error 234 during aspect conversions
  (requires codec-specific handling in future update)

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-23 14:56:37 -05:00

43 lines
1.8 KiB
Markdown

# VideoTools Documentation
VideoTools is a comprehensive FFmpeg GUI wrapper that provides user-friendly interfaces for common video processing tasks.
## Documentation Structure
### Core Modules (Implemented/Planned)
- [Convert](convert/) - Video transcoding and format conversion
- [Merge](merge/) - Join multiple video clips
- [Trim](trim/) - Cut and split videos
- [Filters](filters/) - Video and audio effects
- [Upscale](upscale/) - Resolution enhancement
- [Audio](audio/) - Audio track operations
- [Thumb](thumb/) - Thumbnail generation
- [Inspect](inspect/) - Metadata viewing and editing
- [Rip](rip/) - DVD/Blu-ray extraction
### Additional Modules (Proposed)
- [Subtitle](subtitle/) - Subtitle management
- [Streams](streams/) - Multi-stream handling
- [GIF](gif/) - Animated GIF creation
- [Crop](crop/) - Video cropping tools
- [Screenshots](screenshots/) - Frame extraction
## Design Documents
- [Persistent Video Context](PERSISTENT_VIDEO_CONTEXT.md) - Cross-module video state management
- [Module Overview](MODULES.md) - Complete module feature list
- [Custom Video Player](VIDEO_PLAYER.md) - Embedded playback implementation
## Development
- [Architecture](architecture/) - Application structure and design patterns *(coming soon)*
- [FFmpeg Integration](ffmpeg/) - FFmpeg command building and execution *(coming soon)*
- [Contributing](CONTRIBUTING.md) - Contribution guidelines *(coming soon)*
## User Guides
- [Getting Started](getting-started.md) - Installation and first steps *(coming soon)*
- [Workflows](workflows/) - Common multi-module workflows *(coming soon)*
- [Keyboard Shortcuts](shortcuts.md) - Keyboard shortcuts reference *(coming soon)*
## Quick Links
- [Module Feature Matrix](MODULES.md#module-coverage-summary)
- [Persistent Video Context Design](PERSISTENT_VIDEO_CONTEXT.md)