@t3lnet/sceneforge 1.0.11 → 1.0.12
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
|
@@ -104,6 +104,8 @@ sceneforge split --demo <name> [options]
|
|
|
104
104
|
| `--demo` | Demo name (folder in output) |
|
|
105
105
|
| `--output`, `-o` | Output directory |
|
|
106
106
|
|
|
107
|
+
**Video Quality:** Encodes with H.264 (libx264), CRF 18, medium preset for high-quality output.
|
|
108
|
+
|
|
107
109
|
### voiceover
|
|
108
110
|
Generate voiceover audio from scripts.
|
|
109
111
|
|
|
@@ -136,6 +138,8 @@ sceneforge add-audio --demo <name> [options]
|
|
|
136
138
|
| `--demo` | Demo name |
|
|
137
139
|
| `--output`, `-o` | Output directory |
|
|
138
140
|
|
|
141
|
+
**Video Quality:** Re-encodes with H.264 (libx264), CRF 18, medium preset. Audio encoded as AAC at 192kbps.
|
|
142
|
+
|
|
139
143
|
### concat
|
|
140
144
|
Concatenate step clips into final video.
|
|
141
145
|
|
|
@@ -149,6 +153,8 @@ sceneforge concat --demo <name> [options]
|
|
|
149
153
|
| `--demo` | Demo name |
|
|
150
154
|
| `--output`, `-o` | Output directory |
|
|
151
155
|
|
|
156
|
+
**Video Quality:** Final encode with H.264 (libx264), CRF 18, medium preset. Includes `+faststart` for web streaming optimization. Audio encoded as AAC at 192kbps.
|
|
157
|
+
|
|
152
158
|
### doctor
|
|
153
159
|
Run environment diagnostics.
|
|
154
160
|
|
|
@@ -234,3 +240,27 @@ sceneforge doctor
|
|
|
234
240
|
# Record in headed mode with slow motion
|
|
235
241
|
sceneforge record -d demo.yaml -b http://localhost:3000 --headed --slowmo 500
|
|
236
242
|
```
|
|
243
|
+
|
|
244
|
+
## Video Quality
|
|
245
|
+
|
|
246
|
+
SceneForge uses high-quality FFmpeg encoding settings optimized for multi-pass video processing:
|
|
247
|
+
|
|
248
|
+
| Setting | Value | Purpose |
|
|
249
|
+
|---------|-------|---------|
|
|
250
|
+
| Codec | `libx264` | H.264 for broad compatibility |
|
|
251
|
+
| Preset | `medium` | Balanced quality/speed tradeoff |
|
|
252
|
+
| CRF | `18` | High quality (visually lossless) |
|
|
253
|
+
| Audio | `aac @ 192k` | High-quality audio |
|
|
254
|
+
| Flags | `+faststart` | Web streaming optimization |
|
|
255
|
+
|
|
256
|
+
**Why these settings:**
|
|
257
|
+
- Videos go through multiple processing stages (split → add-audio → concat)
|
|
258
|
+
- Each re-encoding can degrade quality (generation loss)
|
|
259
|
+
- CRF 18 preserves quality across all stages
|
|
260
|
+
- Medium preset provides good compression without sacrificing quality
|
|
261
|
+
|
|
262
|
+
**CRF Reference:**
|
|
263
|
+
- 0 = Lossless (huge files)
|
|
264
|
+
- 18 = Visually lossless (SceneForge default)
|
|
265
|
+
- 23 = FFmpeg default
|
|
266
|
+
- 28+ = Lower quality, smaller files
|
|
@@ -217,6 +217,26 @@ Aim for variance within ±500ms per step:
|
|
|
217
217
|
- [ ] Volume consistent across steps
|
|
218
218
|
- [ ] No unexpected pauses
|
|
219
219
|
|
|
220
|
+
### Video Quality Check
|
|
221
|
+
SceneForge uses high-quality encoding settings to preserve video fidelity:
|
|
222
|
+
- [ ] Video appears sharp (no compression artifacts)
|
|
223
|
+
- [ ] Colors are accurate (no banding)
|
|
224
|
+
- [ ] Text is readable (no blur from compression)
|
|
225
|
+
- [ ] No visible quality degradation between steps
|
|
226
|
+
|
|
227
|
+
**Encoding Settings Used:**
|
|
228
|
+
| Setting | Value | Purpose |
|
|
229
|
+
|---------|-------|---------|
|
|
230
|
+
| Codec | `libx264` | H.264 for compatibility |
|
|
231
|
+
| CRF | `18` | High quality (visually lossless) |
|
|
232
|
+
| Preset | `medium` | Balanced quality/speed |
|
|
233
|
+
| Audio | `aac @ 192k` | High-quality audio |
|
|
234
|
+
|
|
235
|
+
**If you notice quality issues:**
|
|
236
|
+
1. Ensure source recording is high quality (check `output/videos/<demo>.webm`)
|
|
237
|
+
2. Re-run the pipeline to regenerate all clips
|
|
238
|
+
3. Check available disk space (low space can affect encoding)
|
|
239
|
+
|
|
220
240
|
## Final Checklist
|
|
221
241
|
|
|
222
242
|
- [ ] All steps have acceptable timing variance
|
|
@@ -225,4 +245,6 @@ Aim for variance within ±500ms per step:
|
|
|
225
245
|
- [ ] No dead air or overlap issues
|
|
226
246
|
- [ ] Intro provides adequate context
|
|
227
247
|
- [ ] Outro concludes naturally
|
|
248
|
+
- [ ] Video quality is sharp and clear
|
|
249
|
+
- [ ] Audio is clear with consistent volume
|
|
228
250
|
- [ ] Overall demo flows professionally
|