Documentation

Learn the app visually, from first playlist to final export.

Fragments is built around small media fragments, not a full timeline editor. This guide shows the core workflow with the same layout and controls users see in the app.

Your original media files are not modified. Export uses FFmpeg; the Linux Flatpak includes it.

Fragments Playlist view
Scrub the media and set the range visually
Start End
1 Add media
2 Trim range
3 Reorder fragments

Workflow

The short path from source file to playlist.

1

Add media

Open local video or audio files and create fragment rows from the source material.

2

Trim and label

Set start/end visually, then add labels and notes so the playlist stays readable later.

3

Arrange playback

Move fragments, add delay, decide whether audio stays on, and set the playback speed.

4

Preview and export

Check the draft in the preview, save it, then export MP4 or GIF when it is ready.

Editor

Use the playlist table to keep fragments organized.

Each row is a fragment. The table is meant for quick scanning, not long-form editing. Put the important details next to the timings so you can find the right cue fast.

#Use the row number to scan quickly.
LabelGive fragments a short human name.
DelayKeep lead-in time attached to the fragment.
AudioMute or keep the sound for each cue.
#LabelRangeDelayAudio
01Opening beat00:01.250 - 00:08.5000.0 sOn
02Presenter00:12.000 - 00:18.4001.5 sOn
03Silent transition00:21.100 - 00:25.0000.8 sOff
04Closing title00:30.000 - 00:38.5000.0 sOn
Duplicate Move up/down Recover missing

Preview

Scrub the media, then adjust the start and end handles.

Delay Start End

What the source preview shows

The video area shows the selected source media so you can choose the exact fragment range. The handles mark where the cue begins and ends.

Delay behavior

Delay appears before the fragment in playback and export. The color helps you see the lead-in space instantly.

Audio choices

Keep audio for video fragments when needed, or use audio-only fragments for cue-style playlist sections.

Fragment metadata

The inspector edits the selected fragment, not the whole playlist.

Use this panel to refine one cue at a time. Source status shows whether the file is ready or needs relinking, and the remaining fields stay attached to that fragment so the playlist stays readable.

SourceShows the file name and whether the media is available or missing.
Start / EndTrim the exact range that belongs in the final fragment.
DelayKeep the lead-in before this cue in the same fragment row.
AudioMute the fragment or keep its sound when you play the playlist.
Volume / SpeedAdjust how loud or fast the fragment plays.
Label / NotesAdd names and notes so the list is easy to scan later.
Delay colorUse color to spot lead-in space quickly in preview and export.

Play All

Playback follows the playlist from top to bottom.

1 Current fragment
2 Delay phase
3 Next fragment

What happens when you press Play All

Fragments plays the playlist in row order, one fragment after another, so it feels like one independent video assembled from the fragments instead of separate standalone clips.

Delay and transitions

If a fragment has delay before it, the app shows that pause first, then starts the fragment range when the delay ends.

Audio and preview differences

Audio follows the fragment settings, including audio-only cues and muted fragments. Preview is for checking a draft; Play All is the sequence users experience in order.

Recovery and export

Handle missing files and finish with a clean render.

Fragments keeps the playlist editable even when files move. You can relink one source or scan a folder for matches, then export the playlist once everything is resolved.

Missing media recovery

Batch relink missing sources with the recovery panel instead of fixing one file at a time.

Export target

Render the playlist to MP4 or GIF. MP4 normalizes mixed source sizes and frame rates; GIF export lets you choose frame rate and quality.

Playlist JSON

Playlist files use a documented JSON structure. If a file does not match it, Fragments reports the problem instead of silently loading bad data.

Shortcuts

Keep the common actions on the keyboard.

Ctrl+OOpen playlist
Ctrl+SSave playlist
Ctrl+Shift+SSave as
Ctrl+ZUndo
Ctrl+YRedo
PPreview selected fragment
DeleteRemove selected fragment
Ctrl+DDuplicate selected fragment
Ctrl+Up / Ctrl+DownMove selected fragment
ISet draft start from playhead
OSet draft end from playhead
Ctrl+EnterSave selected fragment draft