summaryrefslogtreecommitdiff
path: root/tools/timeline_editor/README.md
AgeCommit message (Collapse)Author
21 hoursdocs(timeline-editor): Document WAV source and music.track visualization taskskal
Updated documentation: README.md: - Added waveform visualization to implemented features list - Added section on loading audio waveform with usage instructions - Documented wav_dump_backend integration: ./demo64k --dump_wav output.wav - Added snap-to-beat and resize handles to feature list - Updated Future Enhancements with music.track visualization ROADMAP.md: - Added Phase 2.5: Music.track Visualization & Overlay - Detailed implementation plan for tracker score overlay - Visual design specifications (colored bars, sample markers) - Use case: Align visual sequences with tracker events - Effort: 12-15 hours, Priority: MEDIUM The timeline editor now has clear guidance on: 1. How to generate WAV files from demo64k for visual reference 2. Future feature: Display tracker patterns/samples for alignment
23 hoursdocs(timeline-editor): Reference SEQUENCE.md and add priority editing taskskal
Documentation improvements: 1. Added reference to doc/SEQUENCE.md in README 2. Added comment in parser pointing to format spec 3. Updated README with complete format examples including: - Priority modifiers (+, =, -) - Time notation (beats vs seconds) - Optional sequence names - BPM declaration New feature task (Phase 1): Task 1.2b: Priority Editing UI (HIGH PRIORITY, 6-8h) - Edit sequence priority (0-9 for scene, 10+ for post-processing) - Toggle effect priority modifiers (+/=/-) - Visual priority indicators and z-order visualization - Computed priority display - Priority conflict warnings Implementation details: - Radio buttons for priority modifiers - Up/down buttons for sequence priority - Color-coded priority levels - Priority badges on timeline items - Automatic priority recalculation Rationale: Priority control is essential for proper render order and z-stacking. Currently, priorities are shown but not easily editable. This task makes priority a first-class editable property. Updated effort estimates: - Phase 1: 28-36 hours (was 22-28) - Total: ~117-161 hours for full feature set
23 hoursfeat(tools): Implement Task #57 - Interactive Timeline Editorskal
Created a functional web-based timeline editor for demo.seq files. Features implemented: ✅ Load/save demo.seq files via browser file API ✅ Visual Gantt-style timeline with time markers ✅ Drag & drop sequences and effects along timeline ✅ Properties panel for editing timing, priorities, arguments ✅ Zoom controls (10% - 200%) ✅ Add/delete sequences and effects ✅ Real-time statistics (sequence count, effect count, duration) ✅ Dark theme matching VSCode aesthetic ✅ Color-coded items (sequences blue, effects gray) ✅ Selection highlighting Technical details: - Pure HTML/CSS/JavaScript (no dependencies, no build step) - ~600 lines in single self-contained HTML file - Works offline, no backend needed - Parser converts demo.seq text → JavaScript objects - Serializer converts JavaScript objects → demo.seq text Usage: 1. Open tools/timeline_editor/index.html in browser 2. Load assets/demo.seq 3. Drag items, edit properties 4. Save modified file 5. Copy to assets/demo.seq and rebuild Limitations (acceptable for v1): - No undo/redo yet - No effect creation UI (must use properties panel) - No overlap detection warnings - No snap-to-grid - No preview rendering (intentional - editor only) This provides a quick way to experiment with demo timing without recompiling, and better visualization of sequence/effect relationships. Size: ~25KB (HTML + embedded JS/CSS) Status: Task #57 basic implementation complete