Media¶

Import media¶

Move the playhead to the desired start time, then select the destination track. Click Add in that track’s controls and choose Import Media… or Import Captions…. The file is inserted at the playhead on the track whose menu you opened. If several tracks of that type are selected, the file goes on all of them.

Video and audio files can only be imported to video or audio tracks. WebVTT files can only be imported to caption tracks. MKV and WebM imports ask for confirmation before losslessly remuxing to MP4 in the source file’s directory. An existing MP4 is never overwritten. The timeline uses the new MP4, and after a successful import a dialog offers to keep or delete the original. Keeping the original is the default; cancelling or failing the import never deletes it.

Supported formats¶

Shrimply recognizes these source types:

Type	Formats
Video containers	MP4, MOV, MKV, and WebM
Video codecs	H.264/AVC, H.265/HEVC, AV1, VP8, VP9, and other codecs with FFmpeg CUDA decoding
Images and documents	JPEG, PNG, WebP, AVIF, GIF, SVG, and PDF
Audio	AAC, AIFF, ALAC, FLAC, M4A, MP3, Ogg, Opus, and WAV
Captions	WebVTT
Layered images	PSD and Krita
3D content	OBJ, GLB, and PLY
Application sources	Blender files and Manim scenes

Project opening additionally accepts native Shrimply projects, Shrimply JSON, OpenTimelineIO, and Kdenlive projects.

Video decoding requires both a matching FFmpeg CUDA decoder and codec support from the installed NVIDIA GPU.

Create media¶

Move the playhead to an empty point on the destination track and click Add. The new item starts at the playhead, uses the default visual duration, and ends early rather than overlapping the next item. Nothing is created if the playhead is already inside an item on that track.

On a video track, the menu provides:

Icon	Description
	Text creates a text layer using the default font.
	Shape creates a vector shape. Rectangle, ellipse, triangle, star, arrow, diamond, polygon, heart, and cross shapes are available in the inspector.
	Paint creates a layer for drawing strokes directly on the canvas.
	Background creates a full-canvas background layer.
	3D Scene creates a scene that can contain shapes, text, models, lights, and a ground plane.
	Video Generation creates an AI video-generation item. This requires the Shrimply server.

On an audio track, the menu provides:

Icon	Description
	Text to Speech creates an item that generates speech from text using the Shrimply server.
	Audio Generator creates a procedural audio item configured in the inspector.

Record content¶

On a video track, click Screen Recording, choose a screen or application in the system capture dialog, and click the same button again to stop. The recording starts at the playhead and stops before the next item on the track.
On an audio track, click Microphone to start recording from the default microphone. Click the same button again to stop.

The active recording button turns red. Recording advances playback and places the finished item on that track at the original playhead position. Start from an empty point so the recording does not overlap an existing item.