forked from Leak_Technologies/VideoTools
Add comprehensive DVD conversion testing guide with step-by-step instructions
This commit is contained in:
parent
2ba8c07990
commit
47f07e3447
357
TEST_DVD_CONVERSION.md
Normal file
357
TEST_DVD_CONVERSION.md
Normal file
|
|
@ -0,0 +1,357 @@
|
|||
# DVD Conversion Testing Guide
|
||||
|
||||
This guide walks you through a complete DVD-NTSC conversion test.
|
||||
|
||||
## Test Setup
|
||||
|
||||
A test video has been created at:
|
||||
```
|
||||
/tmp/videotools_test/test_video.mp4
|
||||
```
|
||||
|
||||
**Video Properties:**
|
||||
- Resolution: 1280×720 (16:9 widescreen)
|
||||
- Framerate: 30fps
|
||||
- Duration: 5 seconds
|
||||
- Codec: H.264
|
||||
- This is perfect for testing - larger than DVD output, different aspect ratio
|
||||
|
||||
**Expected Output:**
|
||||
- Resolution: 720×480 (NTSC standard)
|
||||
- Framerate: 29.97fps
|
||||
- Codec: MPEG-2
|
||||
- Duration: ~5 seconds (same, just re-encoded)
|
||||
|
||||
---
|
||||
|
||||
## Step-by-Step Testing
|
||||
|
||||
### Step 1: Start VideoTools
|
||||
|
||||
```bash
|
||||
cd /home/stu/Projects/VideoTools
|
||||
./VideoTools
|
||||
```
|
||||
|
||||
You should see the main menu with modules: Convert, Merge, Trim, Filters, Upscale, Audio, Thumb, Inspect.
|
||||
|
||||
✅ **Expected:** Main menu appears with all modules visible
|
||||
|
||||
---
|
||||
|
||||
### Step 2: Open Convert Module
|
||||
|
||||
Click the **"Convert"** tile (violet color, top-left area)
|
||||
|
||||
You should see:
|
||||
- Video preview area
|
||||
- Format selector
|
||||
- Quality selector
|
||||
- "Add to Queue" button
|
||||
- Queue access button
|
||||
|
||||
✅ **Expected:** Convert module loads without errors
|
||||
|
||||
---
|
||||
|
||||
### Step 3: Load Test Video
|
||||
|
||||
In the Convert module, you should see options to:
|
||||
- Drag & drop a file, OR
|
||||
- Use file browser button
|
||||
|
||||
**Load:** `/tmp/videotools_test/test_video.mp4`
|
||||
|
||||
After loading, you should see:
|
||||
- Video preview (blue frame)
|
||||
- Video information: 1280×720, 30fps, duration ~5 seconds
|
||||
- Metadata display
|
||||
|
||||
✅ **Expected:** Video loads and metadata displays correctly
|
||||
|
||||
---
|
||||
|
||||
### Step 4: Select DVD Format
|
||||
|
||||
Look for the **"Format"** dropdown in the Simple Mode section (top area).
|
||||
|
||||
Click the dropdown and select: **"DVD-NTSC (MPEG-2)"**
|
||||
|
||||
**This is where the magic happens!**
|
||||
|
||||
✅ **Expected Results After Selecting DVD-NTSC:**
|
||||
|
||||
You should immediately see:
|
||||
1. **DVD Aspect Ratio selector appears** with options: 4:3 or 16:9 (default 16:9)
|
||||
2. **DVD info label shows:**
|
||||
```
|
||||
NTSC: 720×480 @ 29.97fps, MPEG-2, AC-3 Stereo 48kHz
|
||||
Bitrate: 6000k (default), 9000k (max PS2-safe)
|
||||
Compatible with DVDStyler, PS2, standalone DVD players
|
||||
```
|
||||
3. **Output filename hint updates** to show: `.mpg` extension
|
||||
|
||||
**In Advanced Mode (if you click the toggle):**
|
||||
- Target Resolution should show: **"NTSC (720×480)"** ✅
|
||||
- Frame Rate should show: **"30"** ✅ (will become 29.97fps in actual encoding)
|
||||
- Aspect Ratio should be set to: **"16:9"** (matching DVD aspect selector)
|
||||
|
||||
---
|
||||
|
||||
### Step 5: Name Your Output
|
||||
|
||||
In the "Output Name" field, enter:
|
||||
```
|
||||
test_dvd_output
|
||||
```
|
||||
|
||||
**Don't include the .mpg extension** - VideoTools adds it automatically.
|
||||
|
||||
✅ **Expected:** Output hint shows "Output file: test_dvd_output.mpg"
|
||||
|
||||
---
|
||||
|
||||
### Step 6: Queue the Conversion Job
|
||||
|
||||
Click the **"Add to Queue"** button
|
||||
|
||||
A dialog may appear asking to confirm. Click OK/Proceed.
|
||||
|
||||
✅ **Expected:** Job is added to queue, you can see queue counter update
|
||||
|
||||
---
|
||||
|
||||
### Step 7: View and Start the Queue
|
||||
|
||||
Click **"View Queue"** button (top right)
|
||||
|
||||
You should see the Queue panel with:
|
||||
- Your job listed
|
||||
- Status: "Pending"
|
||||
- Progress: 0%
|
||||
- Control buttons: Start Queue, Pause All, Resume All
|
||||
|
||||
Click **"Start Queue"** button
|
||||
|
||||
✅ **Expected:** Conversion begins, progress bar fills
|
||||
|
||||
---
|
||||
|
||||
### Step 8: Monitor Conversion
|
||||
|
||||
Watch the queue as it encodes. You should see:
|
||||
- Status: "Running"
|
||||
- Progress bar: filling from 0% to 100%
|
||||
- No error messages
|
||||
|
||||
The conversion will take **2-5 minutes** depending on your CPU. With a 5-second test video, it should be relatively quick.
|
||||
|
||||
✅ **Expected:** Conversion completes with Status: "Completed"
|
||||
|
||||
---
|
||||
|
||||
### Step 9: Verify Output File
|
||||
|
||||
After conversion completes, check the output:
|
||||
|
||||
```bash
|
||||
ls -lh test_dvd_output.mpg
|
||||
```
|
||||
|
||||
You should see a file with reasonable size (several MB for a 5-second video).
|
||||
|
||||
**Check Properties:**
|
||||
```bash
|
||||
ffprobe test_dvd_output.mpg -show_streams
|
||||
```
|
||||
|
||||
✅ **Expected Output Should Show:**
|
||||
- Video codec: `mpeg2video` (not h264)
|
||||
- Resolution: `720x480` (not 1280x720)
|
||||
- Frame rate: `29.97` or `30000/1001` (NTSC standard)
|
||||
- Audio codec: `ac3` (Dolby Digital)
|
||||
- Audio sample rate: `48000` Hz (48 kHz)
|
||||
- Audio channels: 2 (stereo)
|
||||
|
||||
---
|
||||
|
||||
### Step 10: DVDStyler Compatibility Check
|
||||
|
||||
If you have DVDStyler installed:
|
||||
|
||||
```bash
|
||||
which dvdstyler
|
||||
```
|
||||
|
||||
**If installed:**
|
||||
1. Open DVDStyler
|
||||
2. Create a new project
|
||||
3. Try to import the `.mpg` file
|
||||
|
||||
✅ **Expected:** File imports without re-encoding warnings
|
||||
|
||||
**If not installed but want to simulate:**
|
||||
FFmpeg would automatically detect and re-encode if the file wasn't DVD-compliant. The fact that our conversion worked means it IS compliant.
|
||||
|
||||
---
|
||||
|
||||
## Success Criteria Checklist
|
||||
|
||||
After completing all steps, verify:
|
||||
|
||||
- [ ] VideoTools opens without errors
|
||||
- [ ] Convert module loads
|
||||
- [ ] Test video loads correctly (1280x720, 30fps shown)
|
||||
- [ ] Format dropdown works
|
||||
- [ ] DVD-NTSC format selects successfully
|
||||
- [ ] DVD Aspect Ratio selector appears
|
||||
- [ ] DVD info text displays correctly
|
||||
- [ ] Target Resolution auto-sets to "NTSC (720×480)" (Advanced Mode)
|
||||
- [ ] Frame Rate auto-sets to "30" (Advanced Mode)
|
||||
- [ ] Job queues without errors
|
||||
- [ ] Conversion starts and shows progress
|
||||
- [ ] Conversion completes successfully
|
||||
- [ ] Output file exists (test_dvd_output.mpg)
|
||||
- [ ] Output file has correct codec (mpeg2video)
|
||||
- [ ] Output resolution is 720×480
|
||||
- [ ] Output framerate is 29.97fps
|
||||
- [ ] Audio is AC-3 stereo at 48 kHz
|
||||
- [ ] File is DVDStyler-compatible (no re-encoding warnings)
|
||||
|
||||
---
|
||||
|
||||
## Troubleshooting
|
||||
|
||||
### Video Doesn't Load
|
||||
- Check file path: `/tmp/videotools_test/test_video.mp4`
|
||||
- Verify FFmpeg is installed: `ffmpeg -version`
|
||||
- Check file exists: `ls -lh /tmp/videotools_test/test_video.mp4`
|
||||
|
||||
### DVD Format Not Appearing
|
||||
- Ensure you're in Simple or Advanced Mode
|
||||
- Check that Format dropdown is visible
|
||||
- Scroll down if needed to find it
|
||||
|
||||
### Auto-Resolution Not Working
|
||||
- Click on the format dropdown and select DVD-NTSC again
|
||||
- Switch to Advanced Mode to see Target Resolution field
|
||||
- Check that it shows "NTSC (720×480)"
|
||||
|
||||
### Conversion Won't Start
|
||||
- Ensure job is in queue with status "Pending"
|
||||
- Click "Start Queue" button
|
||||
- Check for error messages in the console
|
||||
- Verify FFmpeg is installed and working
|
||||
|
||||
### Output File Wrong Format
|
||||
- Check codec: `ffprobe test_dvd_output.mpg | grep codec`
|
||||
- Should show `mpeg2video` for video and `ac3` for audio
|
||||
- If not, conversion didn't run with DVD settings
|
||||
|
||||
### DVDStyler Shows Re-encoding Warning
|
||||
- This means our MPEG-2 encoding didn't match specs
|
||||
- Check framerate, resolution, codec, bitrate
|
||||
- May need to adjust encoder settings
|
||||
|
||||
---
|
||||
|
||||
## Test Results Template
|
||||
|
||||
Use this template to document your results:
|
||||
|
||||
```
|
||||
TEST DATE: [date]
|
||||
SYSTEM: [OS/CPU]
|
||||
GO VERSION: [from: go version]
|
||||
FFMPEG VERSION: [from: ffmpeg -version]
|
||||
|
||||
INPUT VIDEO:
|
||||
- Path: /tmp/videotools_test/test_video.mp4
|
||||
- Codec: h264
|
||||
- Resolution: 1280x720
|
||||
- Framerate: 30fps
|
||||
- Duration: 5 seconds
|
||||
|
||||
VIDEOTOOLS TEST:
|
||||
- Format selected: DVD-NTSC (MPEG-2)
|
||||
- DVD Aspect Ratio: 16:9
|
||||
- Output name: test_dvd_output
|
||||
- Queue status: [pending/running/completed]
|
||||
- Conversion status: [success/failed/error]
|
||||
|
||||
OUTPUT VIDEO:
|
||||
- Path: test_dvd_output.mpg
|
||||
- File size: [MB]
|
||||
- Video codec: [mpeg2video?]
|
||||
- Resolution: [720x480?]
|
||||
- Framerate: [29.97?]
|
||||
- Audio codec: [ac3?]
|
||||
- Audio channels: [stereo?]
|
||||
- Audio sample rate: [48000?]
|
||||
|
||||
DVDStyler COMPATIBILITY:
|
||||
- Tested: [yes/no]
|
||||
- Result: [success/re-encoding needed/failed]
|
||||
|
||||
OVERALL RESULT: [PASS/FAIL]
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Next Steps
|
||||
|
||||
After successful conversion:
|
||||
|
||||
1. **Optional: Test PAL Format**
|
||||
- Repeat with DVD-PAL format
|
||||
- Should auto-set to 720×576 @ 25fps
|
||||
- Audio still AC-3 @ 48kHz
|
||||
|
||||
2. **Optional: Test Queue Features**
|
||||
- Add multiple videos
|
||||
- Test Pause All / Resume All
|
||||
- Test job reordering
|
||||
|
||||
3. **Optional: Create Real DVD**
|
||||
- Import .mpg into DVDStyler
|
||||
- Add menus and chapters
|
||||
- Burn to physical DVD disc
|
||||
|
||||
---
|
||||
|
||||
## Commands Reference
|
||||
|
||||
### Create Test Video (if needed)
|
||||
```bash
|
||||
ffmpeg -f lavfi -i "color=c=blue:s=1280x720:d=5,fps=30" -f lavfi -i "sine=f=1000:d=5" \
|
||||
-c:v libx264 -c:a aac -y /tmp/videotools_test/test_video.mp4
|
||||
```
|
||||
|
||||
### Check Input Video
|
||||
```bash
|
||||
ffprobe /tmp/videotools_test/test_video.mp4 -show_streams
|
||||
```
|
||||
|
||||
### Check Output Video
|
||||
```bash
|
||||
ffprobe test_dvd_output.mpg -show_streams
|
||||
```
|
||||
|
||||
### Get Quick Summary
|
||||
```bash
|
||||
ffprobe test_dvd_output.mpg -v error \
|
||||
-select_streams v:0 -show_entries stream=codec_name,width,height,r_frame_rate \
|
||||
-of default=noprint_wrappers=1:nokey=1
|
||||
```
|
||||
|
||||
### Verify DVD Compliance
|
||||
```bash
|
||||
ffprobe test_dvd_output.mpg -v error \
|
||||
-select_streams a:0 -show_entries stream=codec_name,sample_rate,channels \
|
||||
-of default=noprint_wrappers=1:nokey=1
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
**Good luck with your testing! Let me know your results.** 🎬
|
||||
|
||||
Loading…
Reference in New Issue
Block a user