orbis-reframe Manual Camera formats Download Source code

The manual of orbis-reframe 0.10.1, the newest release. What has changed since is in the development version on GitHub.

The timeline

The timeline is your edit: which clips play, in which order, and what plays alongside them. This page covers moving around in it, arranging and cutting the 360° clips, and adding music, other sound and picture-in-picture overlays. For the names of the window's parts, see The main window.

The timeline with three clips and their sound, a music track and an overlay track

  1. The ruler, with the time in minutes and seconds.
  2. The playhead: the frame shown in the viewport.
  3. The video track, with your clips. The white diamonds along the bottom edge are reframe keyframes; a hollow diamond (◇) before a clip's name means it has none, and exports looking straight ahead. A ✦ before a clip's name means it has an effect on. Yellow dots along the top edge are highlight marks: set while recording, or by you.
  4. The Camera mic track: the clips' sound, linked to them (the chain icon).
  5. An audio track, with a music file. The waveform shows how loud it is, and the slanted lines at its ends are fades.
  6. An overlay track, with a picture-in-picture clip.
  7. The track headers: each track's name and its M (mute) or H (hide) box. An overlay track also shows its layer number (1 is in front).

The video track sets the length of your video: the export runs from the start of the first clip to the end of the last. Audio and overlay clips that reach past that end are cut off.

Moving around

Only the ruler (and the player bar's progress bar under the viewport) moves the playhead. Click on it to jump to a frame, or drag along it to scrub through the video. Clicking a clip selects it but leaves the playhead where it is.

Key Moves the playhead
Space Play / pause.
← / → One frame back / forward (pauses playback).
Shift+← / Shift+→ One second back / forward.
↑ / ↓ To the previous / next cut or clip edge.
Ctrl+↑ / Ctrl+↓ To the previous / next highlight mark.
M / Shift+M Add / delete a highlight mark at the playhead.
Home / End To the start / end of the timeline.

Zooming. Hold Ctrl and turn the mouse wheel over the timeline to zoom in or out around the pointer. Ctrl++ and Ctrl+- zoom around the playhead, and Ctrl+0 fits the whole edit in the window again. The same commands are the zoom buttons at the right end of the edit toolbar, and in the menu you get by right-clicking an empty part of a track.

While zoomed in, turn the mouse wheel (without Ctrl) or drag the scroll bar under the tracks to move along the timeline. When the playhead runs off the edge, for example during playback, the view follows it. While you drag a clip or a trim handle past the left or right edge, the view scrolls along until you move back.

More tracks than fit. Turn the mouse wheel over the track names, or hold Shift and turn it anywhere on the timeline, to scroll the tracks up and down; the scroll bar at the right edge does the same. While you drag a clip to another track, a track name to reorder, or files from the media pool onto a track, hold the pointer near the top or bottom of the tracks and they scroll until the one you want comes into view. To make the timeline taller, drag the line between it and the viewport up.

The video track

The video track holds your clips, one after another, with a hard cut from each clip to the next: 360° .insv clips, and flat videos from a phone or an action camera if you like (below). There are never gaps between them: when you shorten or remove a clip, the clips after it move up. A cut can go over from one clip to the next instead, with a crossfade or a dip to black: see Transitions. A transition shows as a box over its cut.

The menu you get by right-clicking a clip on the video track, with the Speed submenu open

Right-click a clip for its menu: split it, change its speed, duplicate it, insert another clip before or after it, copy or paste its colour grade (Colour) or its stabilization (Stabilization), move it, or remove it.

Adding clips

You can add the same .insv file more than once, for example to use two different parts of a long recording.

Flat videos on the video track

A flat video (.mp4, .mov, .mkv, .m4v, .webm or .avi, for example from a phone or an action camera) can be a clip on the video track like an .insv: a whole project of phone videos, or a ride that cuts from the 360° camera to a phone and back. Its sound goes on the Camera mic track, linked to it.

A flat video is shown as it is. If its shape differs from your video's (a phone video filmed upright in a 16:9 project), it's shown whole with black bars at the sides. To fill the frame instead, cropping the edges that don't fit, select the clip and set Fit in the Reframe section to Fill the frame, edges cropped (Reframing).

Trimming, splitting, speed, colour, effects, overlays over it, its sound and the export work as for any clip. The parts that need a 360° clip don't apply, and their sections say so: reframing and Track subject, stabilization, the number-plate blur, and stitching.

Selecting a clip

Click a clip to select it. The settings sidebar's sections (stabilization, colour, audio and so on) now change this clip, even when the playhead is somewhere else. Press Esc to clear the selection. The sections then follow the clip under the playhead again. The clip they're changing always has an orange outline.

Reordering

Drag a clip to another place on the video track. You can also right-click it and choose Move left or Move right.

Trimming

Trimming cuts frames off the start or end of a clip. Nothing is deleted from the file: you can always get the frames back. The clip's keyframes in the part you cut off are deleted, though, and don't come back when you trim the clip longer again (Ctrl+Z does bring them back).

[, ] and Restore work on the selected clip, or on the clip under the playhead if none is selected. With a selected clip, the playhead has to be inside that clip.

Splitting

Splitting cuts a clip in two at the playhead, so you can remove the middle of a recording, or give each part its own settings.

Both halves keep everything the clip had: its stabilization, colour and audio settings, and its highlight marks. Each half keeps the keyframes inside it; a keyframe right on the cut goes to both.

Duplicating

Right-click a clip and choose Duplicate. A copy goes right after it, with everything the clip has: trims, speed, reframe keyframes, highlight marks, stabilization, stitching, colour, privacy blur, and its sound on the audio tracks. The clips after it move up to make room. The copy is selected, so the settings sidebar changes the copy, not the original. Use it to show the same moment twice, say once from the front and once from behind, with different reframe keyframes.

Speed: slow motion and fast forward

Right-click a clip and choose a speed under Speed: 0.25×, 0.5×, 0.75×, 1× (normal), 1.5× or 2×. The clip gets longer or shorter on the timeline to match. Its sound is sped up or slowed down without changing its pitch.

Slow motion looks smoothest with footage shot at a high frame rate: a clip recorded at 120 fps, played at 0.25×, shows every frame it recorded in a 30 fps export.

Highlight marks

Highlight marks are yellow dots on a clip's top edge (dark gold in the Light theme) that help you find the moments worth keeping in a long recording. Some come from the camera: while recording, you can mark a moment, and orbis-reframe reads those marks from the file. You can add your own too, say while watching a ride through before you edit it.

Only clips from cameras whose marks orbis-reframe knows how to read show the camera's marks; so far that's the X5.

Removing

Select the clip and press Delete (or Backspace), or right-click it and choose Remove clip. Its linked audio (see below) is removed with it.

The camera's sound

The video track holds only the picture. The sound the camera recorded goes onto an audio track right under it, Camera mic, as one audio clip per video clip, linked to it (see below). A clip recorded with an external microphone such as the Insta360 Mic Air has a second recording, which goes onto an External mic track under that. Click the M box in a track's header to mute that microphone for all clips, for example when your video should only have music. The Audio tab sets the volume and reduces noise and wind for each clip: see Audio and noise reduction.

Audio and overlay tracks

Besides the video track, you can add any number of other tracks:

So from top to bottom the timeline has three groups of tracks, with a little space between them: the video track and its sound, the audio tracks, and the overlay tracks with their sound. The names of the tracks that hold a video's own sound (Camera mic, External mic, a PiP's audio track) are indented under their video.

To make room, a video's own sound tracks can be folded away under it: click the Video track's header, or the triangle in front of an overlay track's name (or right-click the track and choose Fold sound tracks away). The triangle then points right. Click it again (or choose Show sound tracks) to bring them back. Folded tracks are only hidden: they still play and are exported. Whether the video track's sound is folded is remembered for all your projects; an overlay track's opens again the next time you start orbis-reframe.

Unlike the video track, these tracks can have gaps: each clip sits at its own time.

You need at least one clip on the video track before you can add audio or overlays.

Adding audio and overlays

There are four ways:

Titles come from the Overlays tab instead; see Titles.

If there's no track of the right kind with room, orbis-reframe makes a new one. To make an empty track yourself, choose Media ▸ Add audio track or Media ▸ Add overlay track, or right-click the timeline and choose one of them.

Editing clips on these tracks

To Do
Select a clip Click it.
Move it in time Drag it left or right. It snaps to the playhead, the cuts on the video track and the edges of other clips.
Move it to another track Drag it up or down onto another track of the same kind. Camera mic, External mic and a PiP's audio track only take that video's own sound (see Linked audio).
Trim it Drag its left or right edge, or select it and use [ and ] as on the video track.
Split it Select it and press S, or right-click it and choose Split here.
Remove it Select it and press Delete, or right-click it and choose Remove audio clip / Remove overlay clip.
Change its volume or fade it in and out Select it and use the settings sidebar's Audio tab.
Change an overlay's size, position or look Select it and use the settings sidebar's Picture in picture tab (a title: the Overlay tab).

S, [, ] and Delete act on the selected audio or overlay clip if there is one, and on the video track otherwise.

Managing tracks

To Do
Mute an audio track Click the M box in its header. Click it again to hear it.
Hide an overlay track Click the H box in its header.
Rename a track Double-click its name, type the new name and press Enter (Esc cancels). Or right-click it and choose Rename track….
Change the order of tracks Drag a track header up or down, or right-click the track and choose Move track up / Move track down. A track stays in its group: Camera mic and External mic under the video track, audio tracks among the audio tracks, overlay tracks among the overlay tracks. An overlay track takes its audio track along; that audio track can't be moved on its own. For an overlay track the menu says Bring forward / Send backward: its place is its layer, the number in its header (1 is drawn in front, see Several overlays).
Remove a track and everything on it Right-click the track and choose Remove track. Removing an overlay track removes its audio track too.

Linked audio

An audio clip can be linked to a clip on the video track or on an overlay track. A linked clip keeps in step with that clip: when you move, trim, split or speed up the video, its linked audio does the same, and when you remove the video clip, the linked audio goes with it. Linked clips show a chain icon before their name. A linked clip can't be moved, neither to another time nor to another track.

You get linked audio in two ways:

To link or unlink an audio clip yourself, right-click it and choose Link to video clip or Unlink from video clip. Link is only offered when a video clip shows the same recording, for example after you've unlinked the clip. Unlinking never moves the clip. Linking keeps it at its time, and if it isn't on its video's own sound track any more, puts it back there. To shift a clip's sound against its picture, unlink it, move it, and link it again.

The tracks that hold a video's own sound -- Camera mic, External mic and a PiP's audio track -- take only that sound, linked or unlinked: music and other audio clips can't be dragged onto them. An unlinked clip can stay where it is, or be dragged onto one of the audio tracks to use it like any other audio clip, and back. When you remove a video clip, only its linked audio goes with it; clips you unlinked stay.

Audio and overlay clips that aren't linked stay at their time when you edit the video track. If you shorten or remove a video clip, check that your music and overlays still line up.