Timeline Editor
Multi-track timeline editing with frame-accurate precision for professional audio and video production
Coming Soon
The Timeline Editor is currently under development and will be available soon. This documentation provides a preview of the features that will be included.
Overview
The Timeline Editor is the central workspace for arranging, editing, and synchronizing audio, video, and transcript content in Wubble Studio. Built for professional workflows, it provides frame-accurate precision combined with intuitive visual controls that make complex editing tasks simple and efficient.
Whether you're editing a podcast, producing music, mixing film audio, or creating content for social media, the Timeline Editor gives you complete control over timing, arrangement, and synchronization. Work visually with drag-and-drop simplicity or use natural language commands for rapid editing.
What You Can Do
Core Features
Multi-Track Arrangement
Organize your project across unlimited audio, video, and transcript tracks. Each track can contain multiple clips, arranged horizontally across time. Stack tracks vertically to build complex, layered productions.
- Unlimited tracks: Add as many tracks as your project needs
- Track types: Audio, video, transcript, and marker tracks
- Track controls: Solo, mute, lock, and visibility toggles per track
- Color coding: Assign colors to tracks for quick visual identification
- Track height: Adjust individual track heights for detailed editing
Precision Editing Tools
Professional editing tools give you sample-accurate control over every aspect of your timeline. Cut, trim, split, and arrange with precision or speed.
Split & Trim
Cut clips at any point, trim start/end times, and remove unwanted sections with single clicks or keyboard shortcuts.
Drag & Drop
Rearrange clips by dragging them to new positions. Move between tracks, snap to grid, or free-form placement.
Ripple Editing
Enable ripple mode to automatically adjust subsequent clips when you insert, delete, or trim content.
Selection Tools
Select multiple clips, create range selections, or use marquee selection for batch operations.
Integrated Waveform Display
Every audio clip displays high-resolution waveforms directly on the timeline. Visualize audio content, identify peaks and transients, and make informed editing decisions at a glance.
- High-resolution waveforms update in real-time as you zoom
- Color-coded amplitude visualization for quick level assessment
- Clip peaks and transients are immediately visible
- Waveform density adjusts automatically based on zoom level
Zoom & Navigation
Navigate projects of any length with efficient zoom and scrolling controls. Work at sample-level precision or view your entire project at once.
Flexible Zoom
Zoom from millisecond-level detail to hours-long overview. Mouse wheel, pinch gestures, and keyboard shortcuts supported.
Playhead Control
Scrub through your timeline by dragging the playhead. Click anywhere to jump instantly to that position.
Mini-Map View
Overview of your entire timeline at the top shows your current position and allows quick navigation.
Follow Playback
Timeline automatically scrolls to follow playback or stays centered on the playhead as you work.
Markers & Regions
Organize your timeline with markers and regions to mark important moments, sections, and structural elements of your project.
- Markers: Single-point indicators for scene changes, events, or notes
- Regions: Time ranges for sections like intro, verse, chorus, or scenes
- Color coding: Assign colors to markers and regions for visual organization
- Navigation: Jump between markers with keyboard shortcuts or the marker list
- Export support: Markers can be used as chapter points in exports
Clip Properties & Effects
Every clip on the timeline has adjustable properties and can have effects applied independently. Fine-tune individual clips without affecting others.
Volume
Adjust clip volume independently from track level
Speed/Pitch
Time-stretch or pitch-shift individual clips
Fades
Add fade-in, fade-out, or custom fade curves
Pan
Position audio in the stereo field
Effects
Apply EQ, compression, and effects per-clip
Reverse
Play clips backwards for creative effects
Working with the Timeline
Basic Timeline Operations
Adding Content to Timeline
Drag audio or video files from your library, file system, or asset browser directly onto the timeline. Clips automatically snap to the playhead or grid positions. You can also add content programmatically via API or by asking the AI assistant.
Moving and Arranging Clips
Click and drag clips to reposition them in time or move them to different tracks. Hold Shift while dragging to constrain movement to horizontal or vertical only. Enable snap-to-grid to align clips to beat divisions, markers, or other clips.
Trimming Clip Edges
Hover over the start or end of a clip until the cursor changes to a trim tool. Drag to adjust the in or out point. The original audio is preserved—you're simply choosing which portion to use.
Splitting Clips
Position the playhead where you want to split, select the clip, and press the split shortcut (S) or use the split tool. This creates two independent clips that can be moved, trimmed, or deleted separately.
Creating Crossfades
Overlap two clips on the same track to automatically create a crossfade. Adjust the crossfade duration by changing the overlap amount. Choose from linear, exponential, or custom fade curves.
Copying and Duplicating
Copy clips with standard keyboard shortcuts (Cmd/Ctrl+C, Cmd/Ctrl+V) or hold Option/Alt while dragging to create a duplicate. Paste to the playhead position or a specific time.
Advanced Timeline Techniques
Ripple Editing Mode
When ripple mode is enabled, deleting or trimming a clip automatically shifts all subsequent clips to fill the gap or make room. This maintains timing relationships and is essential for dialogue and narrative editing.
Snap to Grid and Markers
Enable snap mode to automatically align clips to grid divisions (bars, beats, seconds), markers, or other clip boundaries. This ensures precise rhythmic alignment and organized arrangements.
Multi-Clip Selection
Select multiple clips by shift-clicking or dragging a selection rectangle. Perform batch operations: move, delete, apply effects, or adjust properties on all selected clips simultaneously.
Track Grouping
Group related tracks together to edit them as a unit. Moving, muting, or adjusting grouped tracks affects all members of the group, perfect for maintaining sync between multi-mic recordings or stems.
Automation Lanes
Draw automation curves directly on the timeline to control volume, panning, or effect parameters over time. Create dynamic mixes that evolve throughout your project.
Using the API
All timeline operations are available programmatically through the Wubble Studio API. Automate editing workflows, create custom tools, or integrate timeline editing into your production pipeline.
// Timeline-like edits using track edit endpoint
const response = await fetch('https://prod-backup-backend.wubble.ai/v1/music/tracks/edit', {
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.WUBBLE_API_KEY}`,
'Content-Type': 'application/json',
},
body: JSON.stringify({
track_id: 'track_123',
edit_start: 20000,
edit_end: 35000,
prompt: 'Tighten this section, smooth transition, and reduce clashing frequencies',
}),
});
const payload = await response.json();
console.log(payload.data.request_id);Conversational Timeline Control
Use natural language to control the timeline through the AI assistant:
"Split the dialogue track at 2 minutes and 15 seconds"
"Add a 2-second fade-in to the music at the beginning"
"Move the sound effect clip 5 seconds earlier"
"Trim the ending of track 3 to remove the last 10 seconds"
"Snap all clips to the nearest beat"API Documentation
See the Timeline API Reference for complete documentation of all timeline operations, clip manipulation methods, and track management functions.
Keyboard Shortcuts
Master these keyboard shortcuts to dramatically speed up your timeline editing workflow:
Playback
Editing
Selection
Zoom
Navigation
Tools
Best Practices
Organize Tracks Logically
Group similar content together and use a consistent track order across projects. For example: dialogue on top, music in the middle, sound effects below. Label tracks clearly and use color coding for quick visual identification.
Use Markers for Structure
Add markers at key points: scene changes, section boundaries, important events. This makes navigation faster and helps maintain structure in long projects. Use descriptive marker names and color coding.
Work Non-Destructively
Original audio files are never modified—all edits are non-destructive. Feel free to experiment with splits, trims, and effects knowing you can always undo or access the full original file.
Leverage Keyboard Shortcuts
Learn and use keyboard shortcuts to dramatically speed up your workflow. Focus on the most common operations first: play/pause, split, delete, zoom, and selection.
Zoom Appropriately for the Task
Use different zoom levels for different tasks. Zoom out for arrangement and structure. Zoom in for precise edits, fades, and cleanup. Learn to quickly toggle between overview and detail views.
Use Ripple Mode Strategically
Enable ripple mode when editing dialogue or narrative content where timing relationships must be maintained. Disable it when working with music or layered sound design where independent timing is important.
Create Crossfades at Transitions
Smooth transitions between clips with crossfades. Even short crossfades (10-50ms) can eliminate clicks and pops. Longer crossfades work well for music and ambience transitions.
Save Project Versions
Before major changes, save a project version or duplicate the project. This allows you to experiment freely and return to earlier versions if needed.
Use Reference Tracks
Import reference material to a dedicated track to compare timing, arrangement, and structure. Mute it during final export but use it as a guide during production.
Combine Manual and AI Editing
Use visual timeline editing for precise control and creative decisions. Use AI commands for repetitive tasks, bulk operations, or quick adjustments. The best workflow combines both approaches.