Skip to content

🎥 Make videos programmatically with React

`@remotion/studio`: Add `defaultPremountInSeconds` option

Jonny Burgerd80ebbe7dce7
diff --git a/packages/cli/src/config/index.ts b/packages/cli/src/config/index.ts
index 652bec2d7b..bd77e6a345 100644
--- a/packages/cli/src/config/index.ts
+++ b/packages/cli/src/config/index.ts
@@ -139,6 +139,7 @@ const {
darkModeOption,
defaultCodingAgentOption,
defaultEditorOption,
+ defaultPremountInSecondsOption,
askAIOption,
publicLicenseKeyOption,
interactivityOption,
@@ -667,6 +668,11 @@ type FlatConfig = RemotionConfigObject &
* Set the editor used when opening files from Remotion Studio.
*/
setDefaultEditor: (editor: DefaultEditor) => void;
+ /**
+ * Set the default premount duration in seconds in Remotion Studio.
+ * Default: 0 in v4, 2 in v5.
+ */
+ setDefaultPremountInSeconds: (seconds: number) => void;
/**
* Set the coding agent used by Remotion Studio.
*/
@@ -893,6 +899,7 @@ export const Config: FlatConfig = {
setPublicLicenseKey: publicLicenseKeyOption.setConfig,
setDefaultCodingAgent: defaultCodingAgentOption.setConfig,
setDefaultEditor: defaultEditorOption.setConfig,
+ setDefaultPremountInSeconds: defaultPremountInSecondsOption.setConfig,
setForceNewStudioEnabled: forceNewStudioOption.setConfig,
setIPv4: ipv4Option.setConfig,
setBundleOutDir: outDirOption.setConfig,
diff --git a/packages/cli/src/parsed-cli.ts b/packages/cli/src/parsed-cli.ts
index 029ddc57ad..7fe0fda49a 100644
--- a/packages/cli/src/parsed-cli.ts
+++ b/packages/cli/src/parsed-cli.ts
@@ -33,6 +33,7 @@ const {
darkModeOption,
defaultCodingAgentOption,
defaultEditorOption,
+ defaultPremountInSecondsOption,
publicLicenseKeyOption,
forceNewStudioOption,
experimentalKeepAudioContextAliveOption,
@@ -110,6 +111,9 @@ export type CommandLineOptions = {
typeof defaultCodingAgentOption
>;
[defaultEditorOption.cliFlag]: TypeOfOption<typeof defaultEditorOption>;
+ [defaultPremountInSecondsOption.cliFlag]: TypeOfOption<
+ typeof defaultPremountInSecondsOption
+ >;
[disableWebSecurityOption.cliFlag]: TypeOfOption<
typeof disableWebSecurityOption
> | null;
diff --git a/packages/cli/src/print-help.ts b/packages/cli/src/print-help.ts
index 83b54c3d18..2b0a6b14bc 100644
--- a/packages/cli/src/print-help.ts
+++ b/packages/cli/src/print-help.ts
@@ -130,6 +130,7 @@ const studioOptions = options(
'beep-on-finish',
'ipv4',
'number-of-shared-audio-tags',
+ 'default-premount-in-seconds',
'experimental-keep-audio-context-alive',
'preview-sample-rate',
'cross-site-isolation',
diff --git a/packages/cli/src/studio.ts b/packages/cli/src/studio.ts
index 6a3c04431e..8c6bb85f10 100644
--- a/packages/cli/src/studio.ts
+++ b/packages/cli/src/studio.ts
@@ -57,6 +57,7 @@ const {
previewSampleRateOption,
defaultCodingAgentOption,
defaultEditorOption,
+ defaultPremountInSecondsOption,
publicLicenseKeyOption,
beepOnFinishOption,
logLevelOption,
@@ -166,6 +167,9 @@ export const studioCommand = async (
return {
maxTimelineTracks: ConfigInternals.getMaxTimelineTracks(),
+ defaultPremountInSeconds: defaultPremountInSecondsOption.getValue({
+ commandLine: parsedCli,
+ }).value,
keyboardShortcuts: ConfigInternals.getKeyboardShortcuts(),
askAIEnabled: askAIOption.getValue({
commandLine: parsedCli,
@@ -194,6 +198,8 @@ export const studioCommand = async (
commandLine: parsedCli,
}).value,
configFileStudioSettings: {
+ defaultPremountInSeconds:
+ defaultPremountInSecondsOption.getConfigValue(),
askAIEnabled: askAIOption.getConfigValue(),
audioLatencyHint: audioLatencyHintOption.getConfigValue(),
beepOnFinish: beepOnFinishOption.getConfigValue(),
diff --git a/packages/core/src/DefaultPremountContext.ts b/packages/core/src/DefaultPremountContext.ts
new file mode 100644
index 0000000000..017724ea29
--- /dev/null
+++ b/packages/core/src/DefaultPremountContext.ts
@@ -0,0 +1,6 @@
+import {createContext} from 'react';
+import {DEFAULT_PREMOUNT_IN_SECONDS} from './default-premount-in-seconds.js';
+
+export const DefaultPremountContext = createContext(
+ DEFAULT_PREMOUNT_IN_SECONDS,
+);
diff --git a/packages/core/src/Sequence.tsx b/packages/core/src/Sequence.tsx
index e9a483243a..153e8065ac 100644
--- a/packages/core/src/Sequence.tsx
+++ b/packages/core/src/Sequence.tsx
@@ -16,6 +16,7 @@ import type {
SequenceRegistrationControls,
TSequence,
} from './CompositionManager.js';
+import {DefaultPremountContext} from './DefaultPremountContext.js';
import type {EffectDefinition} from './effects/effect-types.js';
import {getStackForControls} from './enable-sequence-stack-traces.js';
import {Freeze, useIsInsideNonPremountFreeze} from './freeze.js';
@@ -54,7 +55,6 @@ import {usePremounting} from './use-premounting.js';
import {useRemotionEnvironment} from './use-remotion-environment.js';
import {useSequenceRegistration} from './use-sequence-registration.js';
import {useVideoConfig} from './use-video-config.js';
-import {ENABLE_V5_BREAKING_CHANGES} from './v5-flag.js';
import {withInteractivitySchema} from './with-interactivity-schema.js';
const SeriesContentVisibilityContext = createContext(true);
@@ -973,7 +973,7 @@ const PremountedPostmountedSequenceRefForwardingFunction: React.ForwardRefRender
active={isPremountingOrPostmounting}
_remotionInternalIsPremounting={premountingActive}
>
- <SequenceInner
+ <RegularSequence
ref={ref}
from={from}
durationInFrames={durationInFrames}
@@ -998,10 +998,10 @@ const SequenceRefForwardingFunction: React.ForwardRefRenderFunction<
> = (props, ref) => {
const env = useRemotionEnvironment();
const {fps} = useVideoConfig();
+ const defaultPremountInSeconds = useContext(DefaultPremountContext);
if (props.layout !== 'none' && !env.isRendering) {
- const effectivePremountFor = ENABLE_V5_BREAKING_CHANGES
- ? (props.premountFor ?? fps)
- : props.premountFor;
+ const effectivePremountFor =
+ props.premountFor ?? Math.round(defaultPremountInSeconds * fps);
if (effectivePremountFor || props.postmountFor) {
return (
<PremountedPostmountedSequence
diff --git a/packages/core/src/default-premount-in-seconds.ts b/packages/core/src/default-premount-in-seconds.ts
new file mode 100644
index 0000000000..8eccc255b3
--- /dev/null
+++ b/packages/core/src/default-premount-in-seconds.ts
@@ -0,0 +1,11 @@
+import {ENABLE_V5_BREAKING_CHANGES} from './v5-flag.js';
+
+export const DEFAULT_PREMOUNT_IN_SECONDS = ENABLE_V5_BREAKING_CHANGES ? 2 : 0;
+
+export const validateDefaultPremountInSeconds = (value: unknown) => {
+ if (typeof value !== 'number' || !Number.isFinite(value) || value < 0) {
+ throw new TypeError(
+ `defaultPremountInSeconds must be a finite, non-negative number, but got ${String(value)}.`,
+ );
+ }
+};
diff --git a/packages/core/src/internals.ts b/packages/core/src/internals.ts
index 6abd25f45e..52eb1602f7 100644
--- a/packages/core/src/internals.ts
+++ b/packages/core/src/internals.ts
@@ -41,6 +41,7 @@ import {
import {CompositionManagerProvider} from './CompositionManagerProvider.js';
import * as CSSUtils from './default-css.js';
import {OBJECTFIT_CONTAIN_CLASS_NAME} from './default-css.js';
+import {DefaultPremountContext} from './DefaultPremountContext.js';
import {
EditorPropsContext,
EditorPropsProvider,
@@ -333,6 +334,7 @@ const compositionSelectorRef = createRef<{
// Mark them as Internals so use don't assume this is public
// API and are less likely to use it
export const Internals = {
+ DefaultPremountContext,
evaluateSourceNumericValue,
evaluateSourcePropStatuses,
AbsoluteFillElement,
diff --git a/packages/core/src/no-react.ts b/packages/core/src/no-react.ts
index 8ce7e1b79e..0ee1fc48ef 100644
--- a/packages/core/src/no-react.ts
+++ b/packages/core/src/no-react.ts
@@ -25,6 +25,10 @@ export {random} from './random.js';
export type {RandomSeed} from './random.js';
export type {VideoConfig} from './video-config';
+import {
+ DEFAULT_PREMOUNT_IN_SECONDS,
+ validateDefaultPremountInSeconds,
+} from './default-premount-in-seconds';
import {
DELAY_RENDER_CALLSTACK_TOKEN,
DELAY_RENDER_CLEAR_TOKEN,
@@ -58,6 +62,8 @@ import {getExpectedMediaFrameUncorrected} from './video/get-current-time';
import {getOffthreadVideoSource} from './video/offthread-video-source';
export const NoReactInternals = {
+ DEFAULT_PREMOUNT_IN_SECONDS,
+ validateDefaultPremountInSeconds,
evaluateSourceNumericValue,
evaluateSourcePropStatuses,
processColor,
diff --git a/packages/core/src/use-premounting.ts b/packages/core/src/use-premounting.ts
index 0653f79c27..d7a09d28eb 100644
--- a/packages/core/src/use-premounting.ts
+++ b/packages/core/src/use-premounting.ts
@@ -1,5 +1,6 @@
import {useContext, useMemo} from 'react';
import type React from 'react';
+import {DefaultPremountContext} from './DefaultPremountContext.js';
import {getSequenceBoundaryTolerance} from './get-sequence-boundary-tolerance.js';
import {PremountContext} from './PremountContext.js';
import {SequenceContext} from './SequenceContext.js';
@@ -7,7 +8,6 @@ import {useTimelinePosition} from './timeline-position-state.js';
import {useCurrentFrame} from './use-current-frame.js';
import {useRemotionEnvironment} from './use-remotion-environment.js';
import {useVideoConfig} from './use-video-config.js';
-import {ENABLE_V5_BREAKING_CHANGES} from './v5-flag.js';
export const usePremounting = ({
from,
@@ -33,9 +33,9 @@ export const usePremounting = ({
useCurrentFrame() - parentPremountContext.premountFramesRemaining;
const environment = useRemotionEnvironment();
const {fps} = useVideoConfig();
- const effectivePremountFor = ENABLE_V5_BREAKING_CHANGES
- ? (premountFor ?? fps)
- : (premountFor ?? 0);
+ const defaultPremountInSeconds = useContext(DefaultPremountContext);
+ const effectivePremountFor =
+ premountFor ?? Math.round(defaultPremountInSeconds * fps);
const effectivePostmountFor = postmountFor ?? 0;
const endExclusive = from + durationInFrames;
const sequenceContext = useContext(SequenceContext);
diff --git a/packages/core/src/wrap-remotion-context.tsx b/packages/core/src/wrap-remotion-context.tsx
index c7ae11f95f..87a66f03ea 100644
--- a/packages/core/src/wrap-remotion-context.tsx
+++ b/packages/core/src/wrap-remotion-context.tsx
@@ -6,6 +6,7 @@ import React, {useMemo} from 'react';
import {BufferingContextReact} from './buffering.js';
import {CanUseRemotionHooks} from './CanUseRemotionHooks.js';
import {CompositionManager} from './CompositionManagerContext.js';
+import {DefaultPremountContext} from './DefaultPremountContext.js';
import {LogLevelContext} from './log-level-context.js';
import {PreloadContext} from './prefetch-state.js';
import {RenderAssetManager} from './RenderAssetManager.js';
@@ -27,6 +28,7 @@ export function useRemotionContexts() {
const timelineContext = React.useContext(TimelineContext);
const setTimelineContext = React.useContext(SetTimelineContext);
const sequenceContext = React.useContext(SequenceContext);
+ const defaultPremountInSeconds = React.useContext(DefaultPremountContext);
const experimentalTracksEnabled = React.useContext(
ExperimentalTracksEnabledContext,
);
@@ -49,6 +51,7 @@ export function useRemotionContexts() {
timelineContext,
setTimelineContext,
sequenceContext,
+ defaultPremountInSeconds,
experimentalTracksEnabled,
timelineTrackContext,
canUseRemotionHooksContext,
@@ -64,6 +67,7 @@ export function useRemotionContexts() {
[
compositionManagerCtx,
sequenceContext,
+ defaultPremountInSeconds,
experimentalTracksEnabled,
timelineTrackContext,
setTimelineContext,
@@ -126,7 +130,11 @@ export const RemotionContextProvider = (
<TimelineTrackContext.Provider
value={contexts.timelineTrackContext}
>
- {children}
+ <DefaultPremountContext.Provider
+ value={contexts.defaultPremountInSeconds}
+ >
+ {children}
+ </DefaultPremountContext.Provider>
</TimelineTrackContext.Provider>
</ExperimentalTracksEnabledContext.Provider>
</BufferingContextReact.Provider>
diff --git a/packages/docs/docs/5-0-migration.mdx b/packages/docs/docs/5-0-migration.mdx
index c22a43248f..da9ca40394 100644
--- a/packages/docs/docs/5-0-migration.mdx
+++ b/packages/docs/docs/5-0-migration.mdx
@@ -40,7 +40,7 @@ If you use `@remotion/eslint-config`, the minimum ESLint version is now <MinEsli
## Telemetry is now mandatory for Company License customers
Previously, we had no idea how many renders our company license customers are making, leading to a lack of accountability.
-If you upgrade to Remotion 5.0, you must [enable telemetry](/docs/telemetry) if you are a company license holder or contact Remotion to arrange a plausible delivery of render counts.
+If you upgrade to Remotion 5.0, you must [enable telemetry](/docs/telemetry) if you are a company license holder or contact Remotion to arrange a plausible delivery of render counts.
**Required action**: Pass license key to rendering APIs and in the [Remotion config file](/docs/config). If you are eligible for the free license, pass `"free-license"` as the license key.
@@ -174,12 +174,12 @@ loadFont('normal', {
**Required action**: Ensure custom fonts are loaded before calling these APIs, or pass `validateFontIsLoaded: false` explicitly to keep the previous behavior. See [layout utils best practices](/docs/layout-utils/best-practices).
-## Sequences are automatically premounted
+## Default premount duration is now 2 seconds
-[`<Sequence>`](/docs/sequence), [`<Series.Sequence>`](/docs/series) and [`<TransitionSeries.Sequence>`](/docs/transitions/transitionseries) components now automatically [premount](/docs/player/premounting) for 1 second (`fps` frames) before they appear.
-This prevents black frames that were commonly seen when a `<Sequence>` containing heavy content (e.g. videos, images) appeared.
+The default [premount duration](/docs/player/premounting) for timed components changes from `0` to `2` seconds in the Studio and Player.
+This prepares assets before components appear. Explicit `premountFor` props continue to take precedence. Premounting does not affect rendering.
-**Required action**: If you don't want this behavior for a specific Sequence, opt out by passing [`premountFor={0}`](/docs/sequence#premountfor).
+**Required action**: To keep the v4 default, set [`Config.setDefaultPremountInSeconds(0)`](/docs/config#setdefaultpremountinseconds) for the Studio and [`defaultPremountInSeconds={0}`](/docs/player/player#defaultpremountinseconds) on the Player. You can also use [`--default-premount-in-seconds=0`](/docs/options/default-premount-in-seconds) or change the Studio settings. For an individual component, pass [`premountFor={0}`](/docs/sequence#premountfor).
## `<Player>` does not create shared audio tags by default
diff --git a/packages/docs/docs/cli/studio.mdx b/packages/docs/docs/cli/studio.mdx
index 83a76174a6..bbfff736e3 100644
--- a/packages/docs/docs/cli/studio.mdx
+++ b/packages/docs/docs/cli/studio.mdx
@@ -131,6 +131,14 @@ npx remotion studio --beep-on-finish
npx remotion studio --ipv4
```
+### `--default-premount-in-seconds`<AvailableFrom v="4.0.534" />
+
+<Options id="default-premount-in-seconds" />
+
+```bash title="Terminal"
+npx remotion studio --default-premount-in-seconds=2
+```
+
### `--number-of-shared-audio-tags`<AvailableFrom v="3.3.2" />
<Options id="number-of-shared-audio-tags" />
diff --git a/packages/docs/docs/config.mdx b/packages/docs/docs/config.mdx
index 04069fff8c..323eef4f95 100644
--- a/packages/docs/docs/config.mdx
+++ b/packages/docs/docs/config.mdx
@@ -292,6 +292,19 @@ Changes apply immediately in the Studio without reloading the page.
The [`--experimental-tracks`](/docs/options/experimental-tracks) flag takes precedence over this option.
+## `setDefaultPremountInSeconds()`<AvailableFrom v="4.0.534" />
+
+<Options id="default-premount-in-seconds" />
+
+```ts twoslash title="remotion.config.ts"
+import {Config} from '@remotion/cli/config';
+// ---cut---
+Config.setDefaultPremountInSeconds(2);
+```
+
+You can also change this value in the Studio settings. Changes apply immediately after saving.
+The [`--default-premount-in-seconds`](/docs/options/default-premount-in-seconds) flag takes precedence over this option.
+
## `setDefaultEditor()`<AvailableFrom v="4.0.503" />
<Options id="editor" />
diff --git a/packages/docs/docs/options/buffer-size.mdx b/packages/docs/docs/options/buffer-size.mdx
index e886e56478..100d60e3a0 100644
--- a/packages/docs/docs/options/buffer-size.mdx
+++ b/packages/docs/docs/options/buffer-size.mdx
@@ -3,7 +3,7 @@ image: /generated/articles-docs-options-buffer-size.png
# Generated by packages/docs/generate-option-docs.ts. Do not edit directly.
# Regenerate: cd packages/docs && bun run generate-option-docs
title: "FFmpeg -bufsize flag"
-sidebar_position: 42
+sidebar_position: 43
crumb: Options
custom_edit_url: https://github.com/remotion-dev/remotion/edit/main/packages/renderer/src/options/encoding-buffer-size.tsx
---
diff --git a/packages/docs/docs/options/bundle-cache.mdx b/packages/docs/docs/options/bundle-cache.mdx
index 3c418bce31..bf319bf86f 100644
--- a/packages/docs/docs/options/bundle-cache.mdx
+++ b/packages/docs/docs/options/bundle-cache.mdx
@@ -3,7 +3,7 @@ image: /generated/articles-docs-options-bundle-cache.png
# Generated by packages/docs/generate-option-docs.ts. Do not edit directly.
# Regenerate: cd packages/docs && bun run generate-option-docs
title: "Webpack Bundle Caching"
-sidebar_position: 96
+sidebar_position: 97
crumb: Options
custom_edit_url: https://github.com/remotion-dev/remotion/edit/main/packages/renderer/src/options/bundle-cache.tsx
---
diff --git a/packages/docs/docs/options/cross-site-isolation.mdx b/packages/docs/docs/options/cross-site-isolation.mdx
index 45c3cd4522..2f9f016daf 100644
--- a/packages/docs/docs/options/cross-site-isolation.mdx
+++ b/packages/docs/docs/options/cross-site-isolation.mdx
@@ -3,7 +3,7 @@ image: /generated/articles-docs-options-cross-site-isolation.png
# Generated by packages/docs/generate-option-docs.ts. Do not edit directly.
# Regenerate: cd packages/docs && bun run generate-option-docs
title: "Enable Cross-Site Isolation"
-sidebar_position: 35
+sidebar_position: 36
crumb: Options
custom_edit_url: https://github.com/remotion-dev/remotion/edit/main/packages/renderer/src/options/cross-site-isolation.tsx
---
diff --git a/packages/docs/docs/options/default-premount-in-seconds.mdx b/packages/docs/docs/options/default-premount-in-seconds.mdx
new file mode 100644
index 0000000000..699961e075
--- /dev/null
+++ b/packages/docs/docs/options/default-premount-in-seconds.mdx
@@ -0,0 +1,33 @@
+---
+image: /generated/articles-docs-options-default-premount-in-seconds.png
+# Generated by packages/docs/generate-option-docs.ts. Do not edit directly.
+# Regenerate: cd packages/docs && bun run generate-option-docs
+title: "Default premount duration in seconds"
+sidebar_position: 24
+crumb: Options
+custom_edit_url: https://github.com/remotion-dev/remotion/edit/main/packages/renderer/src/options/default-premount-in-seconds.tsx
+---
+
+Set the default premount duration in seconds for timed components in the Studio. Defaults to 0 in v4 and 2 in v5. Must be a finite, non-negative number. The duration is converted to frames using the composition FPS and rounded to the nearest frame. An explicit `premountFor` prop takes precedence. Does not affect rendering. In the Player, use the `defaultPremountInSeconds` prop instead.
+
+## CLI flag
+
+```text
+--default-premount-in-seconds <value>
+```
+
+The following CLI commands accept this option:
+
+- [`remotion studio`](/docs/cli/studio)
+
+## Config file
+
+```ts twoslash title="remotion.config.ts"
+import {Config} from '@remotion/cli/config';
+// ---cut---
+Config.setDefaultPremountInSeconds(2);
+```
+
+## See also
+
+- [All options](/docs/options)
diff --git a/packages/docs/docs/options/delete-after.mdx b/packages/docs/docs/options/delete-after.mdx
index e569e12610..61537efa3d 100644
--- a/packages/docs/docs/options/delete-after.mdx
+++ b/packages/docs/docs/options/delete-after.mdx
@@ -3,7 +3,7 @@ image: /generated/articles-docs-options-delete-after.png
# Generated by packages/docs/generate-option-docs.ts. Do not edit directly.
# Regenerate: cd packages/docs && bun run generate-option-docs
title: "Lambda render expiration"
-sidebar_position: 58
+sidebar_position: 59
crumb: Options
custom_edit_url: https://github.com/remotion-dev/remotion/edit/main/packages/renderer/src/options/delete-after.tsx
---
diff --git a/packages/docs/docs/options/disable-ask-ai.mdx b/packages/docs/docs/options/disable-ask-ai.mdx
index 646b5b88b3..7a28cd6882 100644
--- a/packages/docs/docs/options/disable-ask-ai.mdx
+++ b/packages/docs/docs/options/disable-ask-ai.mdx
@@ -3,7 +3,7 @@ image: /generated/articles-docs-options-disable-ask-ai.png
# Generated by packages/docs/generate-option-docs.ts. Do not edit directly.
# Regenerate: cd packages/docs && bun run generate-option-docs
title: "Disable or Enable the Ask AI option"
-sidebar_position: 31
+sidebar_position: 32
crumb: Options
custom_edit_url: https://github.com/remotion-dev/remotion/edit/main/packages/renderer/src/options/ask-ai.tsx
---
diff --git a/packages/docs/docs/options/disable-canvas-tabs.mdx b/packages/docs/docs/options/disable-canvas-tabs.mdx
index 03fb21dc4d..625fa4de0a 100644
--- a/packages/docs/docs/options/disable-canvas-tabs.mdx
+++ b/packages/docs/docs/options/disable-canvas-tabs.mdx
@@ -3,7 +3,7 @@ image: /generated/articles-docs-options-disable-canvas-tabs.png
# Generated by packages/docs/generate-option-docs.ts. Do not edit directly.
# Regenerate: cd packages/docs && bun run generate-option-docs
title: "Disable or enable Studio canvas tabs"
-sidebar_position: 29
+sidebar_position: 30
crumb: Options
custom_edit_url: https://github.com/remotion-dev/remotion/edit/main/packages/renderer/src/options/canvas-tabs.tsx
---
diff --git a/packages/docs/docs/options/disable-git-source.mdx b/packages/docs/docs/options/disable-git-source.mdx
index 44aa5a52ab..f5b63a4732 100644
--- a/packages/docs/docs/options/disable-git-source.mdx
+++ b/packages/docs/docs/options/disable-git-source.mdx
@@ -3,7 +3,7 @@ image: /generated/articles-docs-options-disable-git-source.png
# Generated by packages/docs/generate-option-docs.ts. Do not edit directly.
# Regenerate: cd packages/docs && bun run generate-option-docs
title: "Disable Git source"
-sidebar_position: 26
+sidebar_position: 27
crumb: Options
custom_edit_url: https://github.com/remotion-dev/remotion/edit/main/packages/renderer/src/options/disable-git-source.tsx
---
diff --git a/packages/docs/docs/options/disable-headless.mdx b/packages/docs/docs/options/disable-headless.mdx
index af63f5b14a..5db15d0af5 100644
--- a/packages/docs/docs/options/disable-headless.mdx
+++ b/packages/docs/docs/options/disable-headless.mdx
@@ -3,7 +3,7 @@ image: /generated/articles-docs-options-disable-headless.png
# Generated by packages/docs/generate-option-docs.ts. Do not edit directly.
# Regenerate: cd packages/docs && bun run generate-option-docs
title: "Disable Headless Mode"
-sidebar_position: 27
+sidebar_position: 28
crumb: Options
custom_edit_url: https://github.com/remotion-dev/remotion/edit/main/packages/renderer/src/options/headless.tsx
---
diff --git a/packages/docs/docs/options/disable-interactivity.mdx b/packages/docs/docs/options/disable-interactivity.mdx
index cbf8dfb2fe..1847515ded 100644
--- a/packages/docs/docs/options/disable-interactivity.mdx
+++ b/packages/docs/docs/options/disable-interactivity.mdx
@@ -3,7 +3,7 @@ image: /generated/articles-docs-options-disable-interactivity.png
# Generated by packages/docs/generate-option-docs.ts. Do not edit directly.
# Regenerate: cd packages/docs && bun run generate-option-docs
title: "Disable or enable Studio interactivity"
-sidebar_position: 30
+sidebar_position: 31
crumb: Options
custom_edit_url: https://github.com/remotion-dev/remotion/edit/main/packages/renderer/src/options/interactivity.tsx
---
diff --git a/packages/docs/docs/options/disable-keyboard-shortcuts.mdx b/packages/docs/docs/options/disable-keyboard-shortcuts.mdx
index faa8e80732..5206654a41 100644
--- a/packages/docs/docs/options/disable-keyboard-shortcuts.mdx
+++ b/packages/docs/docs/options/disable-keyboard-shortcuts.mdx
@@ -3,7 +3,7 @@ image: /generated/articles-docs-options-disable-keyboard-shortcuts.png
# Generated by packages/docs/generate-option-docs.ts. Do not edit directly.
# Regenerate: cd packages/docs && bun run generate-option-docs
title: "Disable or Enable keyboard shortcuts"
-sidebar_position: 28
+sidebar_position: 29
crumb: Options
custom_edit_url: https://github.com/remotion-dev/remotion/edit/main/packages/renderer/src/options/keyboard-shortcuts.tsx
---
diff --git a/packages/docs/docs/options/disable-web-security.mdx b/packages/docs/docs/options/disable-web-security.mdx
index 43d0a3bb84..9b90bac90c 100644
--- a/packages/docs/docs/options/disable-web-security.mdx
+++ b/packages/docs/docs/options/disable-web-security.mdx
@@ -3,7 +3,7 @@ image: /generated/articles-docs-options-disable-web-security.png
# Generated by packages/docs/generate-option-docs.ts. Do not edit directly.
# Regenerate: cd packages/docs && bun run generate-option-docs
title: "Disable web security"
-sidebar_position: 32
+sidebar_position: 33
crumb: Options
custom_edit_url: https://github.com/remotion-dev/remotion/edit/main/packages/renderer/src/options/disable-web-security.tsx
---
diff --git a/packages/docs/docs/options/disallow-parallel-encoding.mdx b/packages/docs/docs/options/disallow-parallel-encoding.mdx
index 3abb784d9d..61d0e0bc93 100644
--- a/packages/docs/docs/options/disallow-parallel-encoding.mdx
+++ b/packages/docs/docs/options/disallow-parallel-encoding.mdx
@@ -3,7 +3,7 @@ image: /generated/articles-docs-options-disallow-parallel-encoding.png
# Generated by packages/docs/generate-option-docs.ts. Do not edit directly.
# Regenerate: cd packages/docs && bun run generate-option-docs
title: "Disallow parallel encoding"
-sidebar_position: 33
+sidebar_position: 34
crumb: Options
custom_edit_url: https://github.com/remotion-dev/remotion/edit/main/packages/renderer/src/options/disallow-parallel-encoding.tsx
---
diff --git a/packages/docs/docs/options/duration.mdx b/packages/docs/docs/options/duration.mdx
index 5f7650d790..cd17f80fd7 100644
--- a/packages/docs/docs/options/duration.mdx
+++ b/packages/docs/docs/options/duration.mdx
@@ -3,7 +3,7 @@ image: /generated/articles-docs-options-duration.png
# Generated by packages/docs/generate-option-docs.ts. Do not edit directly.
# Regenerate: cd packages/docs && bun run generate-option-docs
title: "Override Duration"
-sidebar_position: 70
+sidebar_position: 71
crumb: Options
custom_edit_url: https://github.com/remotion-dev/remotion/edit/main/packages/renderer/src/options/override-duration.tsx
---
diff --git a/packages/docs/docs/options/enable-cancellation.mdx b/packages/docs/docs/options/enable-cancellation.mdx
index 6bef1d894f..92cdb5ccd2 100644
--- a/packages/docs/docs/options/enable-cancellation.mdx
+++ b/packages/docs/docs/options/enable-cancellation.mdx
@@ -3,7 +3,7 @@ image: /generated/articles-docs-options-enable-cancellation.png
# Generated by packages/docs/generate-option-docs.ts. Do not edit directly.
# Regenerate: cd packages/docs && bun run generate-option-docs
title: "Enable cancellation"
-sidebar_position: 34
+sidebar_position: 35
crumb: Options
custom_edit_url: https://github.com/remotion-dev/remotion/edit/main/packages/renderer/src/options/enable-cancellation.tsx
---
diff --git a/packages/docs/docs/options/enable-folder-expiry.mdx b/packages/docs/docs/options/enable-folder-expiry.mdx
index cdfc7adf8f..8c81801065 100644
--- a/packages/docs/docs/options/enable-folder-expiry.mdx
+++ b/packages/docs/docs/options/enable-folder-expiry.mdx
@@ -3,7 +3,7 @@ image: /generated/articles-docs-options-enable-folder-expiry.png
# Generated by packages/docs/generate-option-docs.ts. Do not edit directly.
# Regenerate: cd packages/docs && bun run generate-option-docs
title: "Lambda render expiration"
-sidebar_position: 59
+sidebar_position: 60
crumb: Options
custom_edit_url: https://github.com/remotion-dev/remotion/edit/main/packages/renderer/src/options/folder-expiry.tsx
---
diff --git a/packages/docs/docs/options/enable-lambda-insights.mdx b/packages/docs/docs/options/enable-lambda-insights.mdx
index c5f0de4075..c7d49d44dd 100644
--- a/packages/docs/docs/options/enable-lambda-insights.mdx
+++ b/packages/docs/docs/options/enable-lambda-insights.mdx
@@ -3,7 +3,7 @@ image: /generated/articles-docs-options-enable-lambda-insights.png
# Generated by packages/docs/generate-option-docs.ts. Do not edit directly.
# Regenerate: cd packages/docs && bun run generate-option-docs
title: "Enable Lambda Insights"
-sidebar_position: 37
+sidebar_position: 38
crumb: Options
custom_edit_url: https://github.com/remotion-dev/remotion/edit/main/packages/renderer/src/options/enable-lambda-insights.tsx
---
diff --git a/packages/docs/docs/options/enable-multiprocess-on-linux.mdx b/packages/docs/docs/options/enable-multiprocess-on-linux.mdx
index 99ba46c1e1..d54aeaa910 100644
--- a/packages/docs/docs/options/enable-multiprocess-on-linux.mdx
+++ b/packages/docs/docs/options/enable-multiprocess-on-linux.mdx
@@ -3,7 +3,7 @@ image: /generated/articles-docs-options-enable-multiprocess-on-linux.png
# Generated by packages/docs/generate-option-docs.ts. Do not edit directly.
# Regenerate: cd packages/docs && bun run generate-option-docs
title: "Enable Multiprocess on Linux"
-sidebar_position: 38
+sidebar_position: 39
crumb: Options
custom_edit_url: https://github.com/remotion-dev/remotion/edit/main/packages/renderer/src/options/enable-multiprocess-on-linux.tsx
---
diff --git a/packages/docs/docs/options/enforce-audio-track.mdx b/packages/docs/docs/options/enforce-audio-track.mdx
index ddf7470fa5..31288a3f65 100644
--- a/packages/docs/docs/options/enforce-audio-track.mdx
+++ b/packages/docs/docs/options/enforce-audio-track.mdx
@@ -3,7 +3,7 @@ image: /generated/articles-docs-options-enforce-audio-track.png
# Generated by packages/docs/generate-option-docs.ts. Do not edit directly.
# Regenerate: cd packages/docs && bun run generate-option-docs
title: "Enforce Audio Track"
-sidebar_position: 39
+sidebar_position: 40
crumb: Options
custom_edit_url: https://github.com/remotion-dev/remotion/edit/main/packages/renderer/src/options/enforce-audio.tsx
---
diff --git a/packages/docs/docs/options/env-file.mdx b/packages/docs/docs/options/env-file.mdx
index 9844b3a9f2..008fac302d 100644
--- a/packages/docs/docs/options/env-file.mdx
+++ b/packages/docs/docs/options/env-file.mdx
@@ -3,7 +3,7 @@ image: /generated/articles-docs-options-env-file.png
# Generated by packages/docs/generate-option-docs.ts. Do not edit directly.
# Regenerate: cd packages/docs && bun run generate-option-docs
title: "Env File"
-sidebar_position: 40
+sidebar_position: 41
crumb: Options
custom_edit_url: https://github.com/remotion-dev/remotion/edit/main/packages/renderer/src/options/env-file.tsx
---
diff --git a/packages/docs/docs/options/every-nth-frame.mdx b/packages/docs/docs/options/every-nth-frame.mdx
index 47908b6216..bf4fa6f066 100644
--- a/packages/docs/docs/options/every-nth-frame.mdx
+++ b/packages/docs/docs/options/every-nth-frame.mdx
@@ -3,7 +3,7 @@ image: /generated/articles-docs-options-every-nth-frame.png
# Generated by packages/docs/generate-option-docs.ts. Do not edit directly.
# Regenerate: cd packages/docs && bun run generate-option-docs
title: "Every nth frame"
-sidebar_position: 41
+sidebar_position: 42
crumb: Options
custom_edit_url: https://github.com/remotion-dev/remotion/edit/main/packages/renderer/src/options/every-nth-frame.tsx
---
diff --git a/packages/docs/docs/options/experimental-keep-audio-context-alive.mdx b/packages/docs/docs/options/experimental-keep-audio-context-alive.mdx
index 0abf2ba35f..aaf34e8a29 100644
--- a/packages/docs/docs/options/experimental-keep-audio-context-alive.mdx
+++ b/packages/docs/docs/options/experimental-keep-audio-context-alive.mdx
@@ -3,7 +3,7 @@ image: /generated/articles-docs-options-experimental-keep-audio-context-alive.pn
# Generated by packages/docs/generate-option-docs.ts. Do not edit directly.
# Regenerate: cd packages/docs && bun run generate-option-docs
title: "Keep AudioContext alive (experimental)"
-sidebar_position: 57
+sidebar_position: 58
crumb: Options
custom_edit_url: https://github.com/remotion-dev/remotion/edit/main/packages/renderer/src/options/experimental-keep-audio-context-alive.tsx
---
diff --git a/packages/docs/docs/options/experimental-tracks.mdx b/packages/docs/docs/options/experimental-tracks.mdx
index b648ac88af..633194e4ec 100644
--- a/packages/docs/docs/options/experimental-tracks.mdx
+++ b/packages/docs/docs/options/experimental-tracks.mdx
@@ -3,7 +3,7 @@ image: /generated/articles-docs-options-experimental-tracks.png
# Generated by packages/docs/generate-option-docs.ts. Do not edit directly.
# Regenerate: cd packages/docs && bun run generate-option-docs
title: "Enable experimental timeline tracks"
-sidebar_position: 36
+sidebar_position: 37
crumb: Options
custom_edit_url: https://github.com/remotion-dev/remotion/edit/main/packages/renderer/src/options/experimental-tracks.tsx
---
diff --git a/packages/docs/docs/options/for-seamless-aac-concatenation.mdx b/packages/docs/docs/options/for-seamless-aac-concatenation.mdx
index af46eed7d6..f717b4cb76 100644
--- a/packages/docs/docs/options/for-seamless-aac-concatenation.mdx
+++ b/packages/docs/docs/options/for-seamless-aac-concatenation.mdx
@@ -3,7 +3,7 @@ image: /generated/articles-docs-options-for-seamless-aac-concatenation.png
# Generated by packages/docs/generate-option-docs.ts. Do not edit directly.
# Regenerate: cd packages/docs && bun run generate-option-docs
title: "For seamless AAC concatenation"
-sidebar_position: 44
+sidebar_position: 45
crumb: Options
custom_edit_url: https://github.com/remotion-dev/remotion/edit/main/packages/renderer/src/options/for-seamless-aac-concatenation.tsx
---
diff --git a/packages/docs/docs/options/force-new.mdx b/packages/docs/docs/options/force-new.mdx
index c2a0891680..156e0aea65 100644
--- a/packages/docs/docs/options/force-new.mdx
+++ b/packages/docs/docs/options/force-new.mdx
@@ -3,7 +3,7 @@ image: /generated/articles-docs-options-force-new.png
# Generated by packages/docs/generate-option-docs.ts. Do not edit directly.
# Regenerate: cd packages/docs && bun run generate-option-docs
title: "Force New Studio"
-sidebar_position: 45
+sidebar_position: 46
crumb: Options
custom_edit_url: https://github.com/remotion-dev/remotion/edit/main/packages/renderer/src/options/force-new-studio.tsx
---
diff --git a/packages/docs/docs/options/fps.mdx b/packages/docs/docs/options/fps.mdx
index 82287e0839..05e73e526e 100644
--- a/packages/docs/docs/options/fps.mdx
+++ b/packages/docs/docs/options/fps.mdx
@@ -3,7 +3,7 @@ image: /generated/articles-docs-options-fps.png
# Generated by packages/docs/generate-option-docs.ts. Do not edit directly.
# Regenerate: cd packages/docs && bun run generate-option-docs
title: "Override FPS"
-sidebar_position: 71
+sidebar_position: 72
crumb: Options
custom_edit_url: https://github.com/remotion-dev/remotion/edit/main/packages/renderer/src/options/override-fps.tsx
---
diff --git a/packages/docs/docs/options/frame.mdx b/packages/docs/docs/options/frame.mdx
index a2f1241eef..6cab03a0e4 100644
--- a/packages/docs/docs/options/frame.mdx
+++ b/packages/docs/docs/options/frame.mdx
@@ -3,7 +3,7 @@ image: /generated/articles-docs-options-frame.png
# Generated by packages/docs/generate-option-docs.ts. Do not edit directly.
# Regenerate: cd packages/docs && bun run generate-option-docs
title: "Frame"
-sidebar_position: 46
+sidebar_position: 47
crumb: Options
custom_edit_url: https://github.com/remotion-dev/remotion/edit/main/packages/renderer/src/options/still-frame.tsx
---
diff --git a/packages/docs/docs/options/frames.mdx b/packages/docs/docs/options/frames.mdx
index 81f2c8cf36..3f5ca77816 100644
--- a/packages/docs/docs/options/frames.mdx
+++ b/packages/docs/docs/options/frames.mdx
@@ -3,7 +3,7 @@ image: /generated/articles-docs-options-frames.png
# Generated by packages/docs/generate-option-docs.ts. Do not edit directly.
# Regenerate: cd packages/docs && bun run generate-option-docs
title: "Frame Range"
-sidebar_position: 47
+sidebar_position: 48
crumb: Options
custom_edit_url: https://github.com/remotion-dev/remotion/edit/main/packages/renderer/src/options/frames.tsx
---
diff --git a/packages/docs/docs/options/gl.mdx b/packages/docs/docs/options/gl.mdx
index dd1469ccb7..2f399ec116 100644
--- a/packages/docs/docs/options/gl.mdx
+++ b/packages/docs/docs/options/gl.mdx
@@ -3,7 +3,7 @@ image: /generated/articles-docs-options-gl.png
# Generated by packages/docs/generate-option-docs.ts. Do not edit directly.
# Regenerate: cd packages/docs && bun run generate-option-docs
title: "OpenGL renderer"
-sidebar_position: 68
+sidebar_position: 69
crumb: Options
custom_edit_url: https://github.com/remotion-dev/remotion/edit/main/packages/renderer/src/options/gl.tsx
---
diff --git a/packages/docs/docs/options/gop.mdx b/packages/docs/docs/options/gop.mdx
index 4e2a346489..fc9ac63e6d 100644
--- a/packages/docs/docs/options/gop.mdx
+++ b/packages/docs/docs/options/gop.mdx
@@ -3,7 +3,7 @@ image: /generated/articles-docs-options-gop.png
# Generated by packages/docs/generate-option-docs.ts. Do not edit directly.
# Regenerate: cd packages/docs && bun run generate-option-docs
title: "GOP size"
-sidebar_position: 48
+sidebar_position: 49
crumb: Options
custom_edit_url: https://github.com/remotion-dev/remotion/edit/main/packages/renderer/src/options/gop-size.tsx
---
diff --git a/packages/docs/docs/options/hardware-acceleration.mdx b/packages/docs/docs/options/hardware-acceleration.mdx
index c7582afce7..34f689ae3d 100644
--- a/packages/docs/docs/options/hardware-acceleration.mdx
+++ b/packages/docs/docs/options/hardware-acceleration.mdx
@@ -3,7 +3,7 @@ image: /generated/articles-docs-options-hardware-acceleration.png
# Generated by packages/docs/generate-option-docs.ts. Do not edit directly.
# Regenerate: cd packages/docs && bun run generate-option-docs
title: "Hardware Acceleration"
-sidebar_position: 49
+sidebar_position: 50
crumb: Options
custom_edit_url: https://github.com/remotion-dev/remotion/edit/main/packages/renderer/src/options/hardware-acceleration.tsx
---
diff --git a/packages/docs/docs/options/height.mdx b/packages/docs/docs/options/height.mdx
index 4827a2907f..4e51d4367d 100644
--- a/packages/docs/docs/options/height.mdx
+++ b/packages/docs/docs/options/height.mdx
@@ -3,7 +3,7 @@ image: /generated/articles-docs-options-height.png
# Generated by packages/docs/generate-option-docs.ts. Do not edit directly.
# Regenerate: cd packages/docs && bun run generate-option-docs
title: "Override Height"
-sidebar_position: 72
+sidebar_position: 73
crumb: Options
custom_edit_url: https://github.com/remotion-dev/remotion/edit/main/packages/renderer/src/options/override-height.tsx
---
diff --git a/packages/docs/docs/options/ignore-certificate-errors.mdx b/packages/docs/docs/options/ignore-certificate-errors.mdx
index 23ed458767..87a9a2f25f 100644
--- a/packages/docs/docs/options/ignore-certificate-errors.mdx
+++ b/packages/docs/docs/options/ignore-certificate-errors.mdx
@@ -3,7 +3,7 @@ image: /generated/articles-docs-options-ignore-certificate-errors.png
# Generated by packages/docs/generate-option-docs.ts. Do not edit directly.
# Regenerate: cd packages/docs && bun run generate-option-docs
title: "Ignore certificate errors"
-sidebar_position: 50
+sidebar_position: 51
crumb: Options
custom_edit_url: https://github.com/remotion-dev/remotion/edit/main/packages/renderer/src/options/ignore-certificate-errors.tsx
---
diff --git a/packages/docs/docs/options/image-sequence-pattern.mdx b/packages/docs/docs/options/image-sequence-pattern.mdx
index 3253c28eca..2e338bea18 100644
--- a/packages/docs/docs/options/image-sequence-pattern.mdx
+++ b/packages/docs/docs/options/image-sequence-pattern.mdx
@@ -3,7 +3,7 @@ image: /generated/articles-docs-options-image-sequence-pattern.png
# Generated by packages/docs/generate-option-docs.ts. Do not edit directly.
# Regenerate: cd packages/docs && bun run generate-option-docs
title: "Image Sequence Pattern"
-sidebar_position: 52
+sidebar_position: 53
crumb: Options
custom_edit_url: https://github.com/remotion-dev/remotion/edit/main/packages/renderer/src/options/image-sequence-pattern.tsx
---
diff --git a/packages/docs/docs/options/index.mdx b/packages/docs/docs/options/index.mdx
index a7ebd3307c..389ecdbf3f 100644
--- a/packages/docs/docs/options/index.mdx
+++ b/packages/docs/docs/options/index.mdx
@@ -37,6 +37,7 @@ Only the CLI reads the config file. In programmatic APIs, you need to pass all o
- [Dark Mode](/docs/options/dark-mode) (`--dark-mode`)
- [Default coding agent](/docs/options/coding-agent) (`--coding-agent`)
- [Default editor](/docs/options/editor) (`--editor`)
+- [Default premount duration in seconds](/docs/options/default-premount-in-seconds) (`--default-premount-in-seconds`)
- [delayRender() timeout](/docs/options/timeout) (`--timeout`)
- [Disable browser auto-open](/docs/options/no-open) (`--no-open`)
- [Disable Git source](/docs/options/disable-git-source) (`--disable-git-source`)
diff --git a/packages/docs/docs/options/ipv4.mdx b/packages/docs/docs/options/ipv4.mdx
index 3c02a9f07f..949abfeda2 100644
--- a/packages/docs/docs/options/ipv4.mdx
+++ b/packages/docs/docs/options/ipv4.mdx
@@ -3,7 +3,7 @@ image: /generated/articles-docs-options-ipv4.png
# Generated by packages/docs/generate-option-docs.ts. Do not edit directly.
# Regenerate: cd packages/docs && bun run generate-option-docs
title: "IPv4"
-sidebar_position: 54
+sidebar_position: 55
crumb: Options
custom_edit_url: https://github.com/remotion-dev/remotion/edit/main/packages/renderer/src/options/ipv4.tsx
---
diff --git a/packages/docs/docs/options/is-production.mdx b/packages/docs/docs/options/is-production.mdx
index 0e3c8d9d90..dac2a4637f 100644
--- a/packages/docs/docs/options/is-production.mdx
+++ b/packages/docs/docs/options/is-production.mdx
@@ -3,7 +3,7 @@ image: /generated/articles-docs-options-is-production.png
# Generated by packages/docs/generate-option-docs.ts. Do not edit directly.
# Regenerate: cd packages/docs && bun run generate-option-docs
title: "Is Production"
-sidebar_position: 55
+sidebar_position: 56
crumb: Options
custom_edit_url: https://github.com/remotion-dev/remotion/edit/main/packages/renderer/src/options/is-production.tsx
---
diff --git a/packages/docs/docs/options/jpeg-quality.mdx b/packages/docs/docs/options/jpeg-quality.mdx
index 2b87554827..1b82bb5096 100644
--- a/packages/docs/docs/options/jpeg-quality.mdx
+++ b/packages/docs/docs/options/jpeg-quality.mdx
@@ -3,7 +3,7 @@ image: /generated/articles-docs-options-jpeg-quality.png
# Generated by packages/docs/generate-option-docs.ts. Do not edit directly.
# Regenerate: cd packages/docs && bun run generate-option-docs
title: "JPEG Quality"
-sidebar_position: 56
+sidebar_position: 57
crumb: Options
custom_edit_url: https://github.com/remotion-dev/remotion/edit/main/packages/renderer/src/options/jpeg-quality.tsx
---
diff --git a/packages/docs/docs/options/license-key.mdx b/packages/docs/docs/options/license-key.mdx
index c956e7258f..91f3b7b601 100644
--- a/packages/docs/docs/options/license-key.mdx
+++ b/packages/docs/docs/options/license-key.mdx
@@ -3,7 +3,7 @@ image: /generated/articles-docs-options-license-key.png
# Generated by packages/docs/generate-option-docs.ts. Do not edit directly.
# Regenerate: cd packages/docs && bun run generate-option-docs
title: "License key"
-sidebar_position: 60
+sidebar_position: 61
crumb: Options
custom_edit_url: https://github.com/remotion-dev/remotion/edit/main/packages/renderer/src/options/license-key.tsx
---
diff --git a/packages/docs/docs/options/log.mdx b/packages/docs/docs/options/log.mdx
index 75f7796b0d..d13f3d6030 100644
--- a/packages/docs/docs/options/log.mdx
+++ b/packages/docs/docs/options/log.mdx
@@ -3,7 +3,7 @@ image: /generated/articles-docs-options-log.png
# Generated by packages/docs/generate-option-docs.ts. Do not edit directly.
# Regenerate: cd packages/docs && bun run generate-option-docs
title: "Log Level"
-sidebar_position: 61
+sidebar_position: 62
crumb: Options
custom_edit_url: https://github.com/remotion-dev/remotion/edit/main/packages/renderer/src/options/log-level.tsx
---
diff --git a/packages/docs/docs/options/max-rate.mdx b/packages/docs/docs/options/max-rate.mdx
index d799c56b59..eaff86aca4 100644
--- a/packages/docs/docs/options/max-rate.mdx
+++ b/packages/docs/docs/options/max-rate.mdx
@@ -3,7 +3,7 @@ image: /generated/articles-docs-options-max-rate.png
# Generated by packages/docs/generate-option-docs.ts. Do not edit directly.
# Regenerate: cd packages/docs && bun run generate-option-docs
title: "FFmpeg -maxrate flag"
-sidebar_position: 43
+sidebar_position: 44
crumb: Options
custom_edit_url: https://github.com/remotion-dev/remotion/edit/main/packages/renderer/src/options/encoding-max-rate.tsx
---
diff --git a/packages/docs/docs/options/metadata.mdx b/packages/docs/docs/options/metadata.mdx
index 04a16607c9..ed4b7ac089 100644
--- a/packages/docs/docs/options/metadata.mdx
+++ b/packages/docs/docs/options/metadata.mdx
@@ -3,7 +3,7 @@ image: /generated/articles-docs-options-metadata.png
# Generated by packages/docs/generate-option-docs.ts. Do not edit directly.
# Regenerate: cd packages/docs && bun run generate-option-docs
title: "Metadata"
-sidebar_position: 62
+sidebar_position: 63
crumb: Options
custom_edit_url: https://github.com/remotion-dev/remotion/edit/main/packages/renderer/src/options/metadata.tsx
---
diff --git a/packages/docs/docs/options/muted.mdx b/packages/docs/docs/options/muted.mdx
index 0a0c1f6189..4a2ca19ba4 100644
--- a/packages/docs/docs/options/muted.mdx
+++ b/packages/docs/docs/options/muted.mdx
@@ -3,7 +3,7 @@ image: /generated/articles-docs-options-muted.png
# Generated by packages/docs/generate-option-docs.ts. Do not edit directly.
# Regenerate: cd packages/docs && bun run generate-option-docs
title: "Muted"
-sidebar_position: 63
+sidebar_position: 64
crumb: Options
custom_edit_url: https://github.com/remotion-dev/remotion/edit/main/packages/renderer/src/options/mute.tsx
---
diff --git a/packages/docs/docs/options/no-open.mdx b/packages/docs/docs/options/no-open.mdx
index 5e8b1bd799..ddf8b4f6ab 100644
--- a/packages/docs/docs/options/no-open.mdx
+++ b/packages/docs/docs/options/no-open.mdx
@@ -3,7 +3,7 @@ image: /generated/articles-docs-options-no-open.png
# Generated by packages/docs/generate-option-docs.ts. Do not edit directly.
# Regenerate: cd packages/docs && bun run generate-option-docs
title: "Disable browser auto-open"
-sidebar_position: 25
+sidebar_position: 26
crumb: Options
custom_edit_url: https://github.com/remotion-dev/remotion/edit/main/packages/renderer/src/options/no-open.tsx
---
diff --git a/packages/docs/docs/options/number-of-gif-loops.mdx b/packages/docs/docs/options/number-of-gif-loops.mdx
index ecb81e5bc9..66096c0214 100644
--- a/packages/docs/docs/options/number-of-gif-loops.mdx
+++ b/packages/docs/docs/options/number-of-gif-loops.mdx
@@ -3,7 +3,7 @@ image: /generated/articles-docs-options-number-of-gif-loops.png
# Generated by packages/docs/generate-option-docs.ts. Do not edit directly.
# Regenerate: cd packages/docs && bun run generate-option-docs
title: "Number of GIF loops"
-sidebar_position: 64
+sidebar_position: 65
crumb: Options
custom_edit_url: https://github.com/remotion-dev/remotion/edit/main/packages/renderer/src/options/number-of-gif-loops.tsx
---
diff --git a/packages/docs/docs/options/number-of-shared-audio-tags.mdx b/packages/docs/docs/options/number-of-shared-audio-tags.mdx
index 1f0306ab16..61596ded43 100644
--- a/packages/docs/docs/options/number-of-shared-audio-tags.mdx
+++ b/packages/docs/docs/options/number-of-shared-audio-tags.mdx
@@ -3,7 +3,7 @@ image: /generated/articles-docs-options-number-of-shared-audio-tags.png
# Generated by packages/docs/generate-option-docs.ts. Do not edit directly.
# Regenerate: cd packages/docs && bun run generate-option-docs
title: "Number of shared audio tags"
-sidebar_position: 65
+sidebar_position: 66
crumb: Options
custom_edit_url: https://github.com/remotion-dev/remotion/edit/main/packages/renderer/src/options/number-of-shared-audio-tags.tsx
---
diff --git a/packages/docs/docs/options/offthreadvideo-cache-size-in-bytes.mdx b/packages/docs/docs/options/offthreadvideo-cache-size-in-bytes.mdx
index 6de60aa42c..ab9afbb655 100644
--- a/packages/docs/docs/options/offthreadvideo-cache-size-in-bytes.mdx
+++ b/packages/docs/docs/options/offthreadvideo-cache-size-in-bytes.mdx
@@ -3,7 +3,7 @@ image: /generated/articles-docs-options-offthreadvideo-cache-size-in-bytes.png
# Generated by packages/docs/generate-option-docs.ts. Do not edit directly.
# Regenerate: cd packages/docs && bun run generate-option-docs
title: "OffthreadVideo cache size"
-sidebar_position: 66
+sidebar_position: 67
crumb: Options
custom_edit_url: https://github.com/remotion-dev/remotion/edit/main/packages/renderer/src/options/offthreadvideo-cache-size.tsx
---
diff --git a/packages/docs/docs/options/offthreadvideo-video-threads.mdx b/packages/docs/docs/options/offthreadvideo-video-threads.mdx
index 84e33641a1..32a400a669 100644
--- a/packages/docs/docs/options/offthreadvideo-video-threads.mdx
+++ b/packages/docs/docs/options/offthreadvideo-video-threads.mdx
@@ -3,7 +3,7 @@ image: /generated/articles-docs-options-offthreadvideo-video-threads.png
# Generated by packages/docs/generate-option-docs.ts. Do not edit directly.
# Regenerate: cd packages/docs && bun run generate-option-docs
title: "OffthreadVideo threads"
-sidebar_position: 67
+sidebar_position: 68
crumb: Options
custom_edit_url: https://github.com/remotion-dev/remotion/edit/main/packages/renderer/src/options/offthreadvideo-threads.tsx
---
diff --git a/packages/docs/docs/options/out-dir.mdx b/packages/docs/docs/options/out-dir.mdx
index 37d22e8e7a..15679850b4 100644
--- a/packages/docs/docs/options/out-dir.mdx
+++ b/packages/docs/docs/options/out-dir.mdx
@@ -3,7 +3,7 @@ image: /generated/articles-docs-options-out-dir.png
# Generated by packages/docs/generate-option-docs.ts. Do not edit directly.
# Regenerate: cd packages/docs && bun run generate-option-docs
title: "Output Directory"
-sidebar_position: 69
+sidebar_position: 70
crumb: Options
custom_edit_url: https://github.com/remotion-dev/remotion/edit/main/packages/renderer/src/options/out-dir.tsx
---
diff --git a/packages/docs/docs/options/overwrite.mdx b/packages/docs/docs/options/overwrite.mdx
index 16561508ff..0693a0afde 100644
--- a/packages/docs/docs/options/overwrite.mdx
+++ b/packages/docs/docs/options/overwrite.mdx
@@ -3,7 +3,7 @@ image: /generated/articles-docs-options-overwrite.png
# Generated by packages/docs/generate-option-docs.ts. Do not edit directly.
# Regenerate: cd packages/docs && bun run generate-option-docs
title: "Overwrite output"
-sidebar_position: 74
+sidebar_position: 75
crumb: Options
custom_edit_url: https://github.com/remotion-dev/remotion/edit/main/packages/renderer/src/options/overwrite.tsx
---
diff --git a/packages/docs/docs/options/package-manager.mdx b/packages/docs/docs/options/package-manager.mdx
index 1e7cada9fe..156cf07576 100644
--- a/packages/docs/docs/options/package-manager.mdx
+++ b/packages/docs/docs/options/package-manager.mdx
@@ -3,7 +3,7 @@ image: /generated/articles-docs-options-package-manager.png
# Generated by packages/docs/generate-option-docs.ts. Do not edit directly.
# Regenerate: cd packages/docs && bun run generate-option-docs
title: "Package Manager"
-sidebar_position: 75
+sidebar_position: 76
crumb: Options
custom_edit_url: https://github.com/remotion-dev/remotion/edit/main/packages/renderer/src/options/package-manager.tsx
---
diff --git a/packages/docs/docs/options/pixel-format.mdx b/packages/docs/docs/options/pixel-format.mdx
index 132c2fc992..338e00f69b 100644
--- a/packages/docs/docs/options/pixel-format.mdx
+++ b/packages/docs/docs/options/pixel-format.mdx
@@ -3,7 +3,7 @@ image: /generated/articles-docs-options-pixel-format.png
# Generated by packages/docs/generate-option-docs.ts. Do not edit directly.
# Regenerate: cd packages/docs && bun run generate-option-docs
title: "Pixel format"
-sidebar_position: 76
+sidebar_position: 77
crumb: Options
custom_edit_url: https://github.com/remotion-dev/remotion/edit/main/packages/renderer/src/options/pixel-format.tsx
---
diff --git a/packages/docs/docs/options/port.mdx b/packages/docs/docs/options/port.mdx
index 71e136508c..58f38bf02b 100644
--- a/packages/docs/docs/options/port.mdx
+++ b/packages/docs/docs/options/port.mdx
@@ -3,7 +3,7 @@ image: /generated/articles-docs-options-port.png
# Generated by packages/docs/generate-option-docs.ts. Do not edit directly.
# Regenerate: cd packages/docs && bun run generate-option-docs
title: "Port"
-sidebar_position: 77
+sidebar_position: 78
crumb: Options
custom_edit_url: https://github.com/remotion-dev/remotion/edit/main/packages/renderer/src/options/port.tsx
---
diff --git a/packages/docs/docs/options/prefer-lossless.mdx b/packages/docs/docs/options/prefer-lossless.mdx
index 99c32f21f9..3b3fa2d760 100644
--- a/packages/docs/docs/options/prefer-lossless.mdx
+++ b/packages/docs/docs/options/prefer-lossless.mdx
@@ -3,7 +3,7 @@ image: /generated/articles-docs-options-prefer-lossless.png
# Generated by packages/docs/generate-option-docs.ts. Do not edit directly.
# Regenerate: cd packages/docs && bun run generate-option-docs
title: "Prefer lossless"
-sidebar_position: 78
+sidebar_position: 79
crumb: Options
custom_edit_url: https://github.com/remotion-dev/remotion/edit/main/packages/renderer/src/options/prefer-lossless.tsx
---
diff --git a/packages/docs/docs/options/preview-sample-rate.mdx b/packages/docs/docs/options/preview-sample-rate.mdx
index 72090e7a5a..23b101dccf 100644
--- a/packages/docs/docs/options/preview-sample-rate.mdx
+++ b/packages/docs/docs/options/preview-sample-rate.mdx
@@ -3,7 +3,7 @@ image: /generated/articles-docs-options-preview-sample-rate.png
# Generated by packages/docs/generate-option-docs.ts. Do not edit directly.
# Regenerate: cd packages/docs && bun run generate-option-docs
title: "Preview Sample Rate"
-sidebar_position: 79
+sidebar_position: 80
crumb: Options
custom_edit_url: https://github.com/remotion-dev/remotion/edit/main/packages/renderer/src/options/preview-sample-rate.tsx
---
diff --git a/packages/docs/docs/options/props.mdx b/packages/docs/docs/options/props.mdx
index c128a1a405..c4e84fe8c9 100644
--- a/packages/docs/docs/options/props.mdx
+++ b/packages/docs/docs/options/props.mdx
@@ -3,7 +3,7 @@ image: /generated/articles-docs-options-props.png
# Generated by packages/docs/generate-option-docs.ts. Do not edit directly.
# Regenerate: cd packages/docs && bun run generate-option-docs
title: "Input Props"
-sidebar_position: 53
+sidebar_position: 54
crumb: Options
custom_edit_url: https://github.com/remotion-dev/remotion/edit/main/packages/renderer/src/options/props.tsx
---
diff --git a/packages/docs/docs/options/prores-profile.mdx b/packages/docs/docs/options/prores-profile.mdx
index 1e574f50aa..63e5cba6df 100644
--- a/packages/docs/docs/options/prores-profile.mdx
+++ b/packages/docs/docs/options/prores-profile.mdx
@@ -3,7 +3,7 @@ image: /generated/articles-docs-options-prores-profile.png
# Generated by packages/docs/generate-option-docs.ts. Do not edit directly.
# Regenerate: cd packages/docs && bun run generate-option-docs
title: "ProRes profile"
-sidebar_position: 80
+sidebar_position: 81
crumb: Options
custom_edit_url: https://github.com/remotion-dev/remotion/edit/main/packages/renderer/src/options/prores-profile.tsx
---
diff --git a/packages/docs/docs/options/public-dir.mdx b/packages/docs/docs/options/public-dir.mdx
index bb1a7ede58..b0408f56ea 100644
--- a/packages/docs/docs/options/public-dir.mdx
+++ b/packages/docs/docs/options/public-dir.mdx
@@ -3,7 +3,7 @@ image: /generated/articles-docs-options-public-dir.png
# Generated by packages/docs/generate-option-docs.ts. Do not edit directly.
# Regenerate: cd packages/docs && bun run generate-option-docs
title: "Public Directory"
-sidebar_position: 81
+sidebar_position: 82
crumb: Options
custom_edit_url: https://github.com/remotion-dev/remotion/edit/main/packages/renderer/src/options/public-dir.tsx
---
diff --git a/packages/docs/docs/options/public-license-key.mdx b/packages/docs/docs/options/public-license-key.mdx
index 953d887b2d..4585a5518e 100644
--- a/packages/docs/docs/options/public-license-key.mdx
+++ b/packages/docs/docs/options/public-license-key.mdx
@@ -3,7 +3,7 @@ image: /generated/articles-docs-options-public-license-key.png
# Generated by packages/docs/generate-option-docs.ts. Do not edit directly.
# Regenerate: cd packages/docs && bun run generate-option-docs
title: "Public License Key"
-sidebar_position: 82
+sidebar_position: 83
crumb: Options
custom_edit_url: https://github.com/remotion-dev/remotion/edit/main/packages/renderer/src/options/public-license-key.tsx
---
diff --git a/packages/docs/docs/options/public-path.mdx b/packages/docs/docs/options/public-path.mdx
index 3f85d3dd19..226164cfc5 100644
--- a/packages/docs/docs/options/public-path.mdx
+++ b/packages/docs/docs/options/public-path.mdx
@@ -3,7 +3,7 @@ image: /generated/articles-docs-options-public-path.png
# Generated by packages/docs/generate-option-docs.ts. Do not edit directly.
# Regenerate: cd packages/docs && bun run generate-option-docs
title: "Public Path"
-sidebar_position: 83
+sidebar_position: 84
crumb: Options
custom_edit_url: https://github.com/remotion-dev/remotion/edit/main/packages/renderer/src/options/public-path.tsx
---
diff --git a/packages/docs/docs/options/rspack.mdx b/packages/docs/docs/options/rspack.mdx
index fc7bd26edc..4fd307e8c1 100644
--- a/packages/docs/docs/options/rspack.mdx
+++ b/packages/docs/docs/options/rspack.mdx
@@ -3,7 +3,7 @@ image: /generated/articles-docs-options-rspack.png
# Generated by packages/docs/generate-option-docs.ts. Do not edit directly.
# Regenerate: cd packages/docs && bun run generate-option-docs
title: "Rspack"
-sidebar_position: 84
+sidebar_position: 85
crumb: Options
custom_edit_url: https://github.com/remotion-dev/remotion/edit/main/packages/renderer/src/options/rspack.tsx
---
diff --git a/packages/docs/docs/options/sample-rate.mdx b/packages/docs/docs/options/sample-rate.mdx
index bc4eeec589..6e9c965f83 100644
--- a/packages/docs/docs/options/sample-rate.mdx
+++ b/packages/docs/docs/options/sample-rate.mdx
@@ -3,7 +3,7 @@ image: /generated/articles-docs-options-sample-rate.png
# Generated by packages/docs/generate-option-docs.ts. Do not edit directly.
# Regenerate: cd packages/docs && bun run generate-option-docs
title: "Sample Rate"
-sidebar_position: 85
+sidebar_position: 86
crumb: Options
custom_edit_url: https://github.com/remotion-dev/remotion/edit/main/packages/renderer/src/options/sample-rate.tsx
---
diff --git a/packages/docs/docs/options/scale.mdx b/packages/docs/docs/options/scale.mdx
index 2a0476e6e3..ba8e747a0c 100644
--- a/packages/docs/docs/options/scale.mdx
+++ b/packages/docs/docs/options/scale.mdx
@@ -3,7 +3,7 @@ image: /generated/articles-docs-options-scale.png
# Generated by packages/docs/generate-option-docs.ts. Do not edit directly.
# Regenerate: cd packages/docs && bun run generate-option-docs
title: "Scale"
-sidebar_position: 86
+sidebar_position: 87
crumb: Options
custom_edit_url: https://github.com/remotion-dev/remotion/edit/main/packages/renderer/src/options/scale.tsx
---
diff --git a/packages/docs/docs/options/separate-audio-to.mdx b/packages/docs/docs/options/separate-audio-to.mdx
index 1b10378cc0..fca87cc744 100644
--- a/packages/docs/docs/options/separate-audio-to.mdx
+++ b/packages/docs/docs/options/separate-audio-to.mdx
@@ -3,7 +3,7 @@ image: /generated/articles-docs-options-separate-audio-to.png
# Generated by packages/docs/generate-option-docs.ts. Do not edit directly.
# Regenerate: cd packages/docs && bun run generate-option-docs
title: "Separate audio to"
-sidebar_position: 87
+sidebar_position: 88
crumb: Options
custom_edit_url: https://github.com/remotion-dev/remotion/edit/main/packages/renderer/src/options/separate-audio.tsx
---
diff --git a/packages/docs/docs/options/sequence.mdx b/packages/docs/docs/options/sequence.mdx
index 08502574da..8869ebcb4c 100644
--- a/packages/docs/docs/options/sequence.mdx
+++ b/packages/docs/docs/options/sequence.mdx
@@ -3,7 +3,7 @@ image: /generated/articles-docs-options-sequence.png
# Generated by packages/docs/generate-option-docs.ts. Do not edit directly.
# Regenerate: cd packages/docs && bun run generate-option-docs
title: "Image Sequence"
-sidebar_position: 51
+sidebar_position: 52
crumb: Options
custom_edit_url: https://github.com/remotion-dev/remotion/edit/main/packages/renderer/src/options/image-sequence.tsx
---
diff --git a/packages/docs/docs/options/skip-skills.mdx b/packages/docs/docs/options/skip-skills.mdx
index 82709c7712..56fa46655f 100644
--- a/packages/docs/docs/options/skip-skills.mdx
+++ b/packages/docs/docs/options/skip-skills.mdx
@@ -3,7 +3,7 @@ image: /generated/articles-docs-options-skip-skills.png
# Generated by packages/docs/generate-option-docs.ts. Do not edit directly.
# Regenerate: cd packages/docs && bun run generate-option-docs
title: "Skip Skills"
-sidebar_position: 88
+sidebar_position: 89
crumb: Options
custom_edit_url: https://github.com/remotion-dev/remotion/edit/main/packages/renderer/src/options/skip-skills.tsx
---
diff --git a/packages/docs/docs/options/still-image-format.mdx b/packages/docs/docs/options/still-image-format.mdx
index 5167a07710..31c0db59fc 100644
--- a/packages/docs/docs/options/still-image-format.mdx
+++ b/packages/docs/docs/options/still-image-format.mdx
@@ -3,7 +3,7 @@ image: /generated/articles-docs-options-still-image-format.png
# Generated by packages/docs/generate-option-docs.ts. Do not edit directly.
# Regenerate: cd packages/docs && bun run generate-option-docs
title: "Still Image Format"
-sidebar_position: 89
+sidebar_position: 90
crumb: Options
custom_edit_url: https://github.com/remotion-dev/remotion/edit/main/packages/renderer/src/options/still-image-format.tsx
---
diff --git a/packages/docs/docs/options/throw-if-site-exists.mdx b/packages/docs/docs/options/throw-if-site-exists.mdx
index d13096a2f8..32cf8962cf 100644
--- a/packages/docs/docs/options/throw-if-site-exists.mdx
+++ b/packages/docs/docs/options/throw-if-site-exists.mdx
@@ -3,7 +3,7 @@ image: /generated/articles-docs-options-throw-if-site-exists.png
# Generated by packages/docs/generate-option-docs.ts. Do not edit directly.
# Regenerate: cd packages/docs && bun run generate-option-docs
title: "Throw if site exists"
-sidebar_position: 90
+sidebar_position: 91
crumb: Options
custom_edit_url: https://github.com/remotion-dev/remotion/edit/main/packages/renderer/src/options/throw-if-site-exists.tsx
---
diff --git a/packages/docs/docs/options/timeout.mdx b/packages/docs/docs/options/timeout.mdx
index 71433c0d0f..7f60121760 100644
--- a/packages/docs/docs/options/timeout.mdx
+++ b/packages/docs/docs/options/timeout.mdx
@@ -3,7 +3,7 @@ image: /generated/articles-docs-options-timeout.png
# Generated by packages/docs/generate-option-docs.ts. Do not edit directly.
# Regenerate: cd packages/docs && bun run generate-option-docs
title: "delayRender() timeout"
-sidebar_position: 24
+sidebar_position: 25
crumb: Options
custom_edit_url: https://github.com/remotion-dev/remotion/edit/main/packages/renderer/src/options/timeout.tsx
---
diff --git a/packages/docs/docs/options/user-agent.mdx b/packages/docs/docs/options/user-agent.mdx
index d4c39d14ee..41845e006c 100644
--- a/packages/docs/docs/options/user-agent.mdx
+++ b/packages/docs/docs/options/user-agent.mdx
@@ -3,7 +3,7 @@ image: /generated/articles-docs-options-user-agent.png
# Generated by packages/docs/generate-option-docs.ts. Do not edit directly.
# Regenerate: cd packages/docs && bun run generate-option-docs
title: "User agent"
-sidebar_position: 91
+sidebar_position: 92
crumb: Options
custom_edit_url: https://github.com/remotion-dev/remotion/edit/main/packages/renderer/src/options/user-agent.tsx
---
diff --git a/packages/docs/docs/options/version.mdx b/packages/docs/docs/options/version.mdx
index fdaaafe9f6..52c936f826 100644
--- a/packages/docs/docs/options/version.mdx
+++ b/packages/docs/docs/options/version.mdx
@@ -3,7 +3,7 @@ image: /generated/articles-docs-options-version.png
# Generated by packages/docs/generate-option-docs.ts. Do not edit directly.
# Regenerate: cd packages/docs && bun run generate-option-docs
title: "Version"
-sidebar_position: 92
+sidebar_position: 93
crumb: Options
custom_edit_url: https://github.com/remotion-dev/remotion/edit/main/packages/renderer/src/options/version-flag.tsx
---
diff --git a/packages/docs/docs/options/video-bitrate.mdx b/packages/docs/docs/options/video-bitrate.mdx
index 383d1738f4..5404597d91 100644
--- a/packages/docs/docs/options/video-bitrate.mdx
+++ b/packages/docs/docs/options/video-bitrate.mdx
@@ -3,7 +3,7 @@ image: /generated/articles-docs-options-video-bitrate.png
# Generated by packages/docs/generate-option-docs.ts. Do not edit directly.
# Regenerate: cd packages/docs && bun run generate-option-docs
title: "Video Bitrate"
-sidebar_position: 93
+sidebar_position: 94
crumb: Options
custom_edit_url: https://github.com/remotion-dev/remotion/edit/main/packages/renderer/src/options/video-bitrate.tsx
---
diff --git a/packages/docs/docs/options/video-image-format.mdx b/packages/docs/docs/options/video-image-format.mdx
index 0cc344acab..8d91ff2cdf 100644
--- a/packages/docs/docs/options/video-image-format.mdx
+++ b/packages/docs/docs/options/video-image-format.mdx
@@ -3,7 +3,7 @@ image: /generated/articles-docs-options-video-image-format.png
# Generated by packages/docs/generate-option-docs.ts. Do not edit directly.
# Regenerate: cd packages/docs && bun run generate-option-docs
title: "Video Image Format"
-sidebar_position: 94
+sidebar_position: 95
crumb: Options
custom_edit_url: https://github.com/remotion-dev/remotion/edit/main/packages/renderer/src/options/video-image-format.tsx
---
diff --git a/packages/docs/docs/options/webhook-custom-data.mdx b/packages/docs/docs/options/webhook-custom-data.mdx
index 312e588671..0640e602d7 100644
--- a/packages/docs/docs/options/webhook-custom-data.mdx
+++ b/packages/docs/docs/options/webhook-custom-data.mdx
@@ -3,7 +3,7 @@ image: /generated/articles-docs-options-webhook-custom-data.png
# Generated by packages/docs/generate-option-docs.ts. Do not edit directly.
# Regenerate: cd packages/docs && bun run generate-option-docs
title: "Webhook custom data"
-sidebar_position: 95
+sidebar_position: 96
crumb: Options
custom_edit_url: https://github.com/remotion-dev/remotion/edit/main/packages/renderer/src/options/webhook-custom-data.tsx
---
diff --git a/packages/docs/docs/options/webpack-poll.mdx b/packages/docs/docs/options/webpack-poll.mdx
index 689bc6d393..9667ce9067 100644
--- a/packages/docs/docs/options/webpack-poll.mdx
+++ b/packages/docs/docs/options/webpack-poll.mdx
@@ -3,7 +3,7 @@ image: /generated/articles-docs-options-webpack-poll.png
# Generated by packages/docs/generate-option-docs.ts. Do not edit directly.
# Regenerate: cd packages/docs && bun run generate-option-docs
title: "Webpack Polling"
-sidebar_position: 97
+sidebar_position: 98
crumb: Options
custom_edit_url: https://github.com/remotion-dev/remotion/edit/main/packages/renderer/src/options/webpack-poll.tsx
---
diff --git a/packages/docs/docs/options/width.mdx b/packages/docs/docs/options/width.mdx
index 164136a148..79a52b5e86 100644
--- a/packages/docs/docs/options/width.mdx
+++ b/packages/docs/docs/options/width.mdx
@@ -3,7 +3,7 @@ image: /generated/articles-docs-options-width.png
# Generated by packages/docs/generate-option-docs.ts. Do not edit directly.
# Regenerate: cd packages/docs && bun run generate-option-docs
title: "Override Width"
-sidebar_position: 73
+sidebar_position: 74
crumb: Options
custom_edit_url: https://github.com/remotion-dev/remotion/edit/main/packages/renderer/src/options/override-width.tsx
---
diff --git a/packages/docs/docs/options/x264-preset.mdx b/packages/docs/docs/options/x264-preset.mdx
index a11a295dcc..f347abddb6 100644
--- a/packages/docs/docs/options/x264-preset.mdx
+++ b/packages/docs/docs/options/x264-preset.mdx
@@ -3,7 +3,7 @@ image: /generated/articles-docs-options-x264-preset.png
# Generated by packages/docs/generate-option-docs.ts. Do not edit directly.
# Regenerate: cd packages/docs && bun run generate-option-docs
title: "x264 Preset"
-sidebar_position: 98
+sidebar_position: 99
crumb: Options
custom_edit_url: https://github.com/remotion-dev/remotion/edit/main/packages/renderer/src/options/x264-preset.tsx
---
diff --git a/packages/docs/docs/player/api.mdx b/packages/docs/docs/player/api.mdx
index 377bad7ca0..196b473542 100644
--- a/packages/docs/docs/player/api.mdx
+++ b/packages/docs/docs/player/api.mdx
@@ -412,6 +412,12 @@ Either `player-size` (default) or `composition-size`:
- `player-size`: The poster will be rendered in the size of the player. This is useful if you want to render for example a Play button with constant size.
- `composition-size`: The poster will be rendered in the size of the composition and scaled to the size of the Player. This is useful if you want to render a freeze frame of the video as a poster.
+### `defaultPremountInSeconds?`<AvailableFrom v="4.0.534" />
+
+The default [premount duration](/docs/player/premounting) in seconds for timed components inside the Player. Defaults to `0` in v4 and `2` in v5.
+Must be a finite, non-negative number. The duration is converted to frames using `fps` and rounded to the nearest frame.
+An explicit [`premountFor`](/docs/sequence#premountfor) prop takes precedence, including `premountFor={0}` to disable premounting for a component.
+
### `bufferStateDelayInMilliseconds`<AvailableFrom v="4.0.111"/>
After the Player has entered a [buffer state](/docs/player/buffer-state), it will wait for this amount of time before showing the buffering UI.
diff --git a/packages/docs/docs/player/premounting.mdx b/packages/docs/docs/player/premounting.mdx
index a62f63004d..e63a30c090 100644
--- a/packages/docs/docs/player/premounting.mdx
+++ b/packages/docs/docs/player/premounting.mdx
@@ -32,12 +32,20 @@ It carries the style <code>opacity: 0</code> to make it invisible.
It's time defined by{' '}<a href="/docs/use-current-frame"><code>useCurrentFrame()</code></a>{' '}is frozen at <code>0</code>.
:::
-## Premounting components
+## Default premount duration<AvailableFrom v="4.0.534" />
+
+Set `defaultPremountInSeconds` to premount timed components that do not specify `premountFor`. The default is `0` seconds in v4 and `2` seconds in [v5.0](/docs/5-0-migration).
+The duration is converted to frames using the composition FPS and rounded to the nearest frame.
+
+For the Studio, use [`Config.setDefaultPremountInSeconds()`](/docs/config#setdefaultpremountinseconds), the [`--default-premount-in-seconds`](/docs/options/default-premount-in-seconds) CLI flag, or the Studio settings. The empty template sets `2` seconds in its config file.
-From [v5.0](/docs/5-0-migration), all [`<Sequence>`](/docs/sequence) components are premounted for 1 second (`fps` frames) by default.
-You can opt out by passing `premountFor={0}`.
+For the Player, use the [`defaultPremountInSeconds`](/docs/player/player#defaultpremountinseconds) prop.
+Explicit `premountFor` values take precedence, including `premountFor={0}`. Sequences with `layout="none"` do not use the default premount duration.
+
+## Premounting components
-In v4, add the [`premountFor`](/docs/sequence#premountfor) prop to the [`<Sequence>`](/docs/sequence) component to enable premounting.
+Use [`premountFor`](/docs/sequence#premountfor) to set the number of frames a component premounts for.
+When omitted, the [default premount duration](#default-premount-duration) applies. Pass `premountFor={0}` to disable premounting for a component.
[`<Video>`](/docs/media/video) and [`<Audio>`](/docs/media/audio) from `@remotion/media` accept `premountFor` directly from <AvailableFrom v="4.0.495" inline />. They remain layoutless, carry `display: none` while premounted and register the premounted range in the Studio timeline.
@@ -94,7 +102,7 @@ export const PremountedScene: React.FC = () => {
The image and heading mount together at frame 30, become visible at frame 60, and unmount at frame 150.
-`premountFor` defaults to `0` in v4 and `fps` (1 second) in v5.
+When `premountFor` is omitted, the [default premount duration](#default-premount-duration) applies.
Use `styleWhilePremounted` to override styles while premounted, including the default hiding styles.
Premounting only applies in the Player and Studio, not during rendering. A parent must also be mounted for its children to premount; set `premountFor` on the outer timed component when preparing a whole scene.
diff --git a/packages/docs/docs/sequence.mdx b/packages/docs/docs/sequence.mdx
index 9599f522ff..6757a1666f 100644
--- a/packages/docs/docs/sequence.mdx
+++ b/packages/docs/docs/sequence.mdx
@@ -310,7 +310,7 @@ If `layout` is set to `none`, there is no container and setting this style is no
### `premountFor?`<AvailableFrom v="4.0.140" />
[Premount](/docs/player/premounting) the sequence for a set number of frames.
-From [v5.0](/docs/5-0-migration), the default value changes from `0` to `fps` (1 second).
+The default is controlled by [`defaultPremountInSeconds`](/docs/player/premounting#default-premount-duration), converted to frames. It is `0` seconds in v4 and `2` seconds in [v5.0](/docs/5-0-migration).
### `postmountFor?`<AvailableFrom v="4.0.340" />
diff --git a/packages/docs/docs/series.mdx b/packages/docs/docs/series.mdx
index 95e266ab95..c62bbca6af 100644
--- a/packages/docs/docs/series.mdx
+++ b/packages/docs/docs/series.mdx
@@ -110,7 +110,7 @@ Whether this sequence should be shown in the timeline in the Studio. See [`showI
### `premountFor?`<AvailableFrom v="4.0.140"/>
[Premount](/docs/player/premounting) the sequence for a set number of frames.
-From [v5.0](/docs/5-0-migration), the default value changes from `0` to `fps` (1 second).
+The default is controlled by [`defaultPremountInSeconds`](/docs/player/premounting#default-premount-duration), converted to frames. It is `0` seconds in v4 and `2` seconds in [v5.0](/docs/5-0-migration).
### `ref?`<AvailableFrom v="3.3.4" />
diff --git a/packages/docs/src/data/articles.ts b/packages/docs/src/data/articles.ts
index 0288f8d7ab..36f03defd9 100644
--- a/packages/docs/src/data/articles.ts
+++ b/packages/docs/src/data/articles.ts
@@ -828,6 +828,15 @@ export const articles = [
noAi: false,
slug: 'options/dark-mode',
},
+ {
+ id: 'options/default-premount-in-seconds',
+ title: 'Default premount duration in seconds',
+ relativePath: 'docs/options/default-premount-in-seconds.mdx',
+ compId: 'articles-docs-options-default-premount-in-seconds',
+ crumb: 'Options',
+ noAi: false,
+ slug: 'options/default-premount-in-seconds',
+ },
{
id: 'options/delete-after',
title: 'Lambda render expiration',
diff --git a/packages/docs/static/generated/articles-docs-options-default-premount-in-seconds.png b/packages/docs/static/generated/articles-docs-options-default-premount-in-seconds.png
new file mode 100644
index 0000000000..487964ca06
Binary files /dev/null and b/packages/docs/static/generated/articles-docs-options-default-premount-in-seconds.png differ
diff --git a/packages/player/src/Player.tsx b/packages/player/src/Player.tsx
index e07b2b9a92..231ec73b30 100644
--- a/packages/player/src/Player.tsx
+++ b/packages/player/src/Player.tsx
@@ -93,6 +93,7 @@ export type PlayerProps<
readonly showPlaybackRateControl?: boolean | number[];
readonly posterFillMode?: PosterFillMode;
readonly bufferStateDelayInMilliseconds?: number;
+ readonly defaultPremountInSeconds?: number;
readonly hideControlsWhenPointerDoesntMove?: boolean | number;
readonly overflowVisible?: boolean;
readonly browserMediaControlsBehavior?: BrowserMediaControlsBehavior;
@@ -179,6 +180,7 @@ const PlayerFn = <
showPlaybackRateControl = false,
posterFillMode = 'player-size',
bufferStateDelayInMilliseconds,
+ defaultPremountInSeconds = NoReactInternals.DEFAULT_PREMOUNT_IN_SECONDS,
hideControlsWhenPointerDoesntMove = true,
overflowVisible = false,
renderMuteButton,
@@ -196,6 +198,8 @@ const PlayerFn = <
}: PlayerProps<Schema, Props>,
ref: RefObject<PlayerRef>,
) => {
+ NoReactInternals.validateDefaultPremountInSeconds(defaultPremountInSeconds);
+
if (typeof window !== 'undefined') {
window.remotion_isPlayer = true;
}
@@ -583,19 +587,21 @@ const PlayerFn = <
</Internals.IsPlayerContextProvider>
);
- if (!onTimelineSequenceChange) {
- return player;
- }
-
return (
- <Internals.SequenceRegistrationContext.Provider value>
- <Internals.SequenceManagerProvider>
- <TimelineSequenceObserverComponent
- onTimelineSequenceChange={onTimelineSequenceChange}
- />
- {player}
- </Internals.SequenceManagerProvider>
- </Internals.SequenceRegistrationContext.Provider>
+ <Internals.DefaultPremountContext.Provider value={defaultPremountInSeconds}>
+ {onTimelineSequenceChange ? (
+ <Internals.SequenceRegistrationContext.Provider value>
+ <Internals.SequenceManagerProvider>
+ <TimelineSequenceObserverComponent
+ onTimelineSequenceChange={onTimelineSequenceChange}
+ />
+ {player}
+ </Internals.SequenceManagerProvider>
+ </Internals.SequenceRegistrationContext.Provider>
+ ) : (
+ player
+ )}
+ </Internals.DefaultPremountContext.Provider>
);
};
diff --git a/packages/renderer/src/options/default-premount-in-seconds.tsx b/packages/renderer/src/options/default-premount-in-seconds.tsx
new file mode 100644
index 0000000000..0dc94b30e8
--- /dev/null
+++ b/packages/renderer/src/options/default-premount-in-seconds.tsx
@@ -0,0 +1,46 @@
+import {NoReactInternals} from 'remotion/no-react';
+import type {AnyRemotionOption} from './option';
+
+let configuredDefaultPremountInSeconds: number | null = null;
+const cliFlag = 'default-premount-in-seconds' as const;
+
+export const defaultPremountInSecondsOption = {
+ name: 'Default premount duration in seconds',
+ cliFlag,
+ id: cliFlag,
+ description: () => (
+ <>
+ Set the default premount duration in seconds for timed components in the
+ Studio. Defaults to 0 in v4 and 2 in v5. Must be a finite, non-negative
+ number. The duration is converted to frames using the composition FPS and
+ rounded to the nearest frame. An explicit <code>premountFor</code> prop
+ takes precedence. Does not affect rendering. In the Player, use the{' '}
+ <code>defaultPremountInSeconds</code> prop instead.
+ </>
+ ),
+ ssrName: null,
+ docLink: 'https://www.remotion.dev/docs/options/default-premount-in-seconds',
+ type: 0 as number,
+ getValue: ({commandLine}) => {
+ if (commandLine[cliFlag] !== undefined) {
+ const value = commandLine[cliFlag];
+ NoReactInternals.validateDefaultPremountInSeconds(value);
+ return {value: value as number, source: 'cli'};
+ }
+
+ return {
+ value:
+ configuredDefaultPremountInSeconds ??
+ NoReactInternals.DEFAULT_PREMOUNT_IN_SECONDS,
+ source: 'config',
+ };
+ },
+ setConfig(value) {
+ NoReactInternals.validateDefaultPremountInSeconds(value);
+ configuredDefaultPremountInSeconds = value;
+ },
+ getConfigValue: () => configuredDefaultPremountInSeconds,
+ reset: () => {
+ configuredDefaultPremountInSeconds = null;
+ },
+} satisfies AnyRemotionOption<number>;
diff --git a/packages/renderer/src/options/index.tsx b/packages/renderer/src/options/index.tsx
index daa6c57e95..1208c64a27 100644
--- a/packages/renderer/src/options/index.tsx
+++ b/packages/renderer/src/options/index.tsx
@@ -19,6 +19,7 @@ import {enableCrossSiteIsolationOption} from './cross-site-isolation';
import {darkModeOption} from './dark-mode';
import {defaultCodingAgentOption} from './default-coding-agent';
import {defaultEditorOption} from './default-editor';
+import {defaultPremountInSecondsOption} from './default-premount-in-seconds';
import {deleteAfterOption} from './delete-after';
import {disableGitSourceOption} from './disable-git-source';
import {disableWebSecurityOption} from './disable-web-security';
@@ -163,6 +164,7 @@ export const allOptions = {
darkModeOption,
defaultCodingAgentOption,
defaultEditorOption,
+ defaultPremountInSecondsOption,
publicLicenseKeyOption,
isProductionOption,
askAIOption,
diff --git a/packages/studio-shared/src/config-method-lifecycles.ts b/packages/studio-shared/src/config-method-lifecycles.ts
index 5ade547188..5774917790 100644
--- a/packages/studio-shared/src/config-method-lifecycles.ts
+++ b/packages/studio-shared/src/config-method-lifecycles.ts
@@ -38,6 +38,7 @@ export const configMethodLifecycles = {
setCrf: 'runtime',
setDefaultCodingAgent: 'runtime',
setDefaultEditor: 'runtime',
+ setDefaultPremountInSeconds: 'runtime',
setDelayRenderTimeoutInMilliseconds: 'runtime',
setDeleteAfter: 'runtime',
setDisallowParallelEncoding: 'runtime',
diff --git a/packages/studio-shared/src/studio-runtime-config.ts b/packages/studio-shared/src/studio-runtime-config.ts
index 440d0743c9..601fe4c35f 100644
--- a/packages/studio-shared/src/studio-runtime-config.ts
+++ b/packages/studio-shared/src/studio-runtime-config.ts
@@ -6,6 +6,7 @@ import type {
import type {StudioKeyboardShortcuts} from './keyboard-shortcuts';
export type ConfigFileStudioSettings = {
+ readonly defaultPremountInSeconds?: number | null;
readonly askAIEnabled: boolean | null;
readonly audioLatencyHint: AudioContextLatencyCategory | null;
readonly beepOnFinish: boolean | null;
@@ -26,6 +27,7 @@ export type StudioElementLibrary = {
};
export type StudioRuntimeConfig = {
+ readonly defaultPremountInSeconds?: number;
readonly maxTimelineTracks: number | null;
readonly askAIEnabled: boolean;
readonly elementLibraries?: readonly StudioElementLibrary[];
diff --git a/packages/studio/src/components/StudioSettings.tsx b/packages/studio/src/components/StudioSettings.tsx
index 0e6b77ebab..737b86fdd7 100644
--- a/packages/studio/src/components/StudioSettings.tsx
+++ b/packages/studio/src/components/StudioSettings.tsx
@@ -5,6 +5,7 @@ import type {
ConfigUpdate,
} from '@remotion/studio-shared';
import React, {useCallback, useEffect, useMemo, useState} from 'react';
+import {NoReactInternals} from 'remotion/no-react';
import {LIGHT_TEXT} from '../helpers/colors';
import {UndoIcon} from '../icons/undo';
import {Button} from './Button';
@@ -44,6 +45,7 @@ const resetIcon: React.CSSProperties = {
};
const initialSettings: ConfigFileStudioSettings = {
+ defaultPremountInSeconds: null,
askAIEnabled: null,
audioLatencyHint: null,
beepOnFinish: null,
@@ -64,8 +66,10 @@ const ConfigNumber = ({
onChange,
onChangeEnd,
value,
+ step,
}: {
readonly defaultValue: number;
+ readonly step: number;
readonly name: string;
readonly onChange: (value: number | null) => void;
readonly onChangeEnd: (value: number | null) => void;
@@ -88,7 +92,7 @@ const ConfigNumber = ({
placeholder={`Default (${defaultValue})`}
rightAlign
status="ok"
- step={1}
+ step={step}
value={value ?? defaultValue}
/>
<Button
@@ -111,7 +115,8 @@ export const StudioSettings: React.FC = () => {
useState<ConfigFileStudioSettings>(initialSettings);
const [committedNumberSettings, setCommittedNumberSettings] = useState<{
numberOfSharedAudioTags: number | null;
- }>({numberOfSharedAudioTags: null});
+ defaultPremountInSeconds: number | null;
+ }>({numberOfSharedAudioTags: null, defaultPremountInSeconds: null});
const [editedSetters, setEditedSetters] = useState<Set<string>>(
() => new Set(),
);
@@ -127,6 +132,9 @@ export const StudioSettings: React.FC = () => {
studioRuntimeConfig.configFileStudioSettings ?? initialSettings,
);
setCommittedNumberSettings({
+ defaultPremountInSeconds:
+ studioRuntimeConfig.configFileStudioSettings
+ ?.defaultPremountInSeconds ?? null,
numberOfSharedAudioTags:
studioRuntimeConfig.configFileStudioSettings?.numberOfSharedAudioTags ??
null,
@@ -148,13 +156,20 @@ export const StudioSettings: React.FC = () => {
[],
);
const previewNumberSetting = useCallback(
- (key: 'numberOfSharedAudioTags', value: number | null) => {
+ (
+ key: 'numberOfSharedAudioTags' | 'defaultPremountInSeconds',
+ value: number | null,
+ ) => {
setSettings((current) => ({...current, [key]: value}));
},
[],
);
const commitNumberSetting = useCallback(
- (key: 'numberOfSharedAudioTags', setter: string, value: number | null) => {
+ (
+ key: 'numberOfSharedAudioTags' | 'defaultPremountInSeconds',
+ setter: string,
+ value: number | null,
+ ) => {
setSettings((current) => ({...current, [key]: value}));
setCommittedNumberSettings((current) => ({...current, [key]: value}));
setEditedSetters((current) => new Set(current).add(setter));
@@ -180,6 +195,10 @@ export const StudioSettings: React.FC = () => {
'setNumberOfSharedAudioTags',
committedNumberSettings.numberOfSharedAudioTags,
),
+ update(
+ 'setDefaultPremountInSeconds',
+ committedNumberSettings.defaultPremountInSeconds,
+ ),
update('setRspack', settings.rspack),
update('setInteractivityEnabled', settings.interactivityEnabled),
update(
@@ -363,6 +382,24 @@ export const StudioSettings: React.FC = () => {
</label>
</div>
+ <p style={sectionTitle}>Playback</p>
+ <ConfigNumber
+ defaultValue={NoReactInternals.DEFAULT_PREMOUNT_IN_SECONDS}
+ name="Default premount in seconds"
+ step={0.1}
+ onChange={(value) =>
+ previewNumberSetting('defaultPremountInSeconds', value)
+ }
+ onChangeEnd={(value) =>
+ commitNumberSetting(
+ 'defaultPremountInSeconds',
+ 'setDefaultPremountInSeconds',
+ value,
+ )
+ }
+ value={settings.defaultPremountInSeconds ?? null}
+ />
+
<p style={sectionTitle}>Audio</p>
<ConfigSelect
defaultLabel="Playback"
@@ -380,6 +417,7 @@ export const StudioSettings: React.FC = () => {
<ConfigNumber
defaultValue={0}
name="Number of shared audio tags"
+ step={1}
onChange={(value) =>
previewNumberSetting('numberOfSharedAudioTags', value)
}
diff --git a/packages/studio/src/helpers/client-id.tsx b/packages/studio/src/helpers/client-id.tsx
index 968076d382..c20288588d 100644
--- a/packages/studio/src/helpers/client-id.tsx
+++ b/packages/studio/src/helpers/client-id.tsx
@@ -13,7 +13,10 @@ import {
subscribeToPreviewServerEvents,
type PreviewServerConnectionState,
} from './preview-server-events';
-import {getStudioExperimentalTracksEnabled} from './studio-runtime-config';
+import {
+ getStudioDefaultPremountInSeconds,
+ getStudioExperimentalTracksEnabled,
+} from './studio-runtime-config';
import {reloadUrl} from './url-state';
type Context = {
@@ -191,7 +194,11 @@ export const PreviewServerConnection: React.FC<{
<Internals.ExperimentalTracksEnabledContext.Provider
value={getStudioExperimentalTracksEnabled()}
>
- {children}
+ <Internals.DefaultPremountContext.Provider
+ value={getStudioDefaultPremountInSeconds()}
+ >
+ {children}
+ </Internals.DefaultPremountContext.Provider>
</Internals.ExperimentalTracksEnabledContext.Provider>
</StudioServerConnectionCtx.Provider>
);
diff --git a/packages/studio/src/helpers/studio-runtime-config.ts b/packages/studio/src/helpers/studio-runtime-config.ts
index 73ec99814e..3b40c80c7b 100644
--- a/packages/studio/src/helpers/studio-runtime-config.ts
+++ b/packages/studio/src/helpers/studio-runtime-config.ts
@@ -1,4 +1,5 @@
import type {StudioRuntimeConfig} from '@remotion/studio-shared';
+import {NoReactInternals} from 'remotion/no-react';
export const DEFAULT_BUFFER_STATE_DELAY_IN_MILLISECONDS = 300;
@@ -53,3 +54,10 @@ export const getStudioBufferStateDelayInMilliseconds = () => {
DEFAULT_BUFFER_STATE_DELAY_IN_MILLISECONDS
);
};
+
+export const getStudioDefaultPremountInSeconds = () => {
+ return (
+ getStudioRuntimeConfig().defaultPremountInSeconds ??
+ NoReactInternals.DEFAULT_PREMOUNT_IN_SECONDS
+ );
+};
diff --git a/packages/template-blank/remotion.config.ts b/packages/template-blank/remotion.config.ts
index 31d58ab7ae..42124ed8d0 100644
--- a/packages/template-blank/remotion.config.ts
+++ b/packages/template-blank/remotion.config.ts
@@ -10,3 +10,4 @@ import { Config } from "@remotion/cli/config";
Config.setRspack(true);
Config.setVideoImageFormat("jpeg");
Config.setOverwriteOutput(true);
+Config.setDefaultPremountInSeconds(2);