Skip to main content
Version: 2.0.0-preview

Editor

Automatically Adjust Scene Length​

When enabled, the scene length will be automatically adjusted when an element is added if necessary.

Auto-Save​

Edits are saved automatically after changes are committed. Auto-save is always enabled; the former Enable Auto-Save switch has been removed.

See Editing Elements for how Beutl protects element files that could not be fully restored.

Show Precise Boundaries​

When enabled, the boundaries displayed during the preview will be shown precisely.

For objects like rectangles, the boundary lines might overlap with the drawing content, making the boundaries invisible.

Move the Playhead with a Click on the Timeline​

When on, a click on the timeline moves the playhead. When off, the playhead moves only from the ruler or by dragging its line, so an accidental click on an empty part of the timeline leaves it where it is, and a plain drag on an empty part selects elements without a modifier key. See Timeline.

The default setting is "On".

Time Display Format​

How times are shown in the preview, the rulers of the timeline and the graph editor, and the marker lists. You can also switch it by right-clicking the time in the preview.

  • Time (00:00:02.50): hours, minutes, seconds, and hundredths of a second
  • Timecode (00:00:02:15) (default value): hours, minutes, seconds, and frames
  • Frame number (75): the number of the frame from the start of the timeline

At 29.97 and 59.94 fps, a timecode counts its frames in drop-frame and puts a semicolon before them, as in 00:01:00;02, so it stays within two frames of the clock. Other frame rates, 23.976 fps included, count every frame. When you type a position to jump to, you can type it as it is shown; see Playback and playhead navigation.

Show Timeline Thumbnails by Default​

Shows filmstrips and waveforms on timeline elements. When off, elements show none until you turn off Disable Thumbnails in an element's right-click menu, which keeps zooming a timeline full of media responsive. An element's own choice is kept only where it differs from this setting, so the other elements follow the setting when it changes.

The default setting is "On".

Frame Cache​

Enable Frame Cache​

When enabled, frame caching is activated.

The default setting is "Off".

Maximum Byte Size​

Adjust the cache size to not exceed this byte size (in megabytes).

The default value is half of the memory available to the .NET runtime. This follows a container or job memory limit when one is configured, rather than always using the device's physical memory.

Scale​

When saving the cache to memory, use this setting to reduce resolution to save memory.

  • Original
  • Match preview screen (default value)
  • Half
  • Quarter
tip

If the preview screen size is equal to or larger than the original size, the resolution remains unchanged.

Color Space​

When saving the cache to memory, use this setting to change the color space to save memory.

  • RGBA (default value)
  • YUV
tip

YUV uses I420.

Node Cache​

Enable Node Cache​

When enabled, node caching is activated.

The default setting is "Off".

Maximum Pixel Count​

Nodes exceeding this pixel count will not be cached.

The default value is "1000000".

Minimum Pixel Count​

Nodes below this pixel count will not be cached.

The default value is "1".

Proxy Media​

These settings control the proxy media workflow.

Preview Source​

Controls whether the preview uses proxy media.

  • Prefer proxy (default value)
  • Force original

Store Location​

Proxy files are stored in this folder.

The default location is the proxies folder in Beutl's home directory. A change takes effect after Beutl restarts.

Maximum Store Size​

When the store exceeds this size (in GiB), Beutl removes the least-recently-used proxies.

The default value is "50" GiB (allowed range: 5–500). A change takes effect after Beutl restarts.

Default Preset​

Sets the quality preset initially selected in the Proxies tool tab.

  • Half proxy (1/2)
  • Quarter proxy (1/4) (default value)
  • Eighth proxy (1/8)

Property Editor​

Enable Pointer Lock​

Hides the cursor while you drag a value, such as a number box or its label in the property editor or a color wheel in the Color Grading tab, and puts it back where the drag began. This works on Windows and macOS.

The default setting is "On".

Tone Mapping​

These settings control how the preview fits frames to the display. They affect the preview, the preview window, and the mobile preview's SDR stream, but not exports.

HDR Preview​

Uses HDR rendering for the preview, so values above SDR white can show on a display with headroom. The HDR preview works like the SDR one: transform handles, the path editor, guides, and the crop rectangle appear over the frame, the frame zooms and pans, and the preview takes clicks, drags, the wheel, and its context menu. On macOS it draws at the display's device pixels.

The default setting is "Off".

Tone mapping​

Selects how the preview fits values the display cannot show.

  • Auto (default value)
  • None
  • Reinhard
  • ACES
  • Hable
  • Fit to display

Auto works as Fit to display while the HDR preview is on a display that shows HDR, and as None everywhere else: the SDR preview, the mobile preview's SDR stream, and the HDR preview on an SDR display. On macOS it follows the screen the preview is on, also when the window moves to another screen. On Windows a display in SDR mode counts as SDR.

Fit to display rolls off only what the display cannot show and keeps hue, where the other modes clip each channel or compress the whole range. Colors outside the display's gamut move toward the gray of their own luminance, and colors the display can show stay as they are. It treats content as peaking at 1000 nits with reference white at 203 nits.

PreviewHighlightsColors
HDR Preview on macOSCore Animation tone maps the frame into the screen's current headroom and follows brightness changes.Fit into the screen's own gamut, so P3 colors show on a P3 screen.
HDR Preview on Windows, display in HDR modeRolled off into the display's peak, or Display peak luminance when set.Fit into the display's primaries.
HDR Preview on Windows, display not in HDR modeRolled off into the display's white.Fit into sRGB in SDR mode, or the display's primaries with Auto Color Management.
HDR Preview on LinuxPassed through, because the display's headroom is not known.Left as they are.
Without HDR Preview, on a surface without HDR support, and the mobile preview's SDR streamRolled off into SDR white.Fit into sRGB.
note

Auto uses Fit to display only where the display shows HDR because on a display with no headroom the curve also lowers SDR white to about 0.78, so an SDR project would look darker in the preview than it exports. A None saved by an earlier version, which was the old default, reads as Auto.

On a Windows HDR display, the HDR preview shows reference white at the display's SDR white level in every mode, so it matches the white of the editor's UI.

Exposure​

Adjusts the exposure level for tone mapping, from -5 to 5.

The default value is "0".

Display peak luminance (nits)​

The peak that Fit to display rolls highlights off into on a Windows HDR display, for a monitor that reports a wrong peak or none. 0 uses the peak Windows reports. Values range from 0 to 10000. The description shows what the display reports, or that it is not in HDR mode.

This setting appears on Windows only. The default value is "0".

Guides​

The safe areas and composition guides over the preview. These are the same settings as in the Preview Settings tab, which describes each guide.

  • Show guides: turns all guides on or off. The default setting is "Off".
  • Guides to show: Title safe, Action safe, Rule of thirds, Center cross, Diagonals, Custom grid, and Aspect ratios.
  • Guide color, Guide opacity, Grid columns, Grid rows, and Aspect ratio frames.

Source​