Interface: EditorConfig
Configuration for the video trimmer editor UI.
Extends
Properties
| Property | Type | Description | Inherited from |
|---|---|---|---|
alertOnFailCloseText | string | Text for the close button of the fail-to-load alert. | - |
alertOnFailMessage | string | Message of the fail-to-load alert. | - |
alertOnFailTitle | string | Title of the fail-to-load alert. | - |
alertOnFailToLoad | boolean | Whether to show an alert dialog when the media file fails to load. | - |
autoplay | boolean | Whether to auto-play the video when the editor opens. | - |
cancelButtonText | string | Text for the cancel button. | - |
cancelDialogCancelText | string | Text for the dismiss button in the cancel confirmation dialog. | - |
cancelDialogConfirmText | string | Text for the confirm button in the cancel confirmation dialog. | - |
cancelDialogMessage | string | Message of the cancel confirmation dialog. | - |
cancelDialogTitle | string | Title of the cancel confirmation dialog. | - |
cancelTrimmingButtonText | string | Text for the cancel-trimming button. | - |
cancelTrimmingDialogCancelText | string | Text for the dismiss button in the cancel-trimming dialog. | - |
cancelTrimmingDialogConfirmText | string | Text for the confirm button in the cancel-trimming dialog. | - |
cancelTrimmingDialogMessage | string | Message of the cancel-trimming confirmation dialog. | - |
cancelTrimmingDialogTitle | string | Title of the cancel-trimming confirmation dialog. | - |
changeStatusBarColorOnOpen? | boolean | Android only. Whether to update the status bar to a black background when the editor opens. | - |
closeWhenFinish | boolean | Whether to automatically close the editor when trimming finishes. | - |
durationFormat? | string | Format token for the editor's start / current / end time labels. Allowed values: - "mm:ss": minutes:seconds (e.g. 01:23) - "mm:ss.SS": centiseconds (e.g. 01:23.45) - "mm:ss.SSS": milliseconds (e.g. 01:23.456), default - "hh:mm:ss": hours:minutes:seconds (e.g. 00:01:23) - "hh:mm:ss.SSS": hours:minutes:seconds.milliseconds (e.g. 00:01:23.456) Unknown values fall back to the default. Only affects on-screen labels; onLoad / onFinishTrimming payloads continue to report raw milliseconds. | - |
enableCancelDialog | boolean | Whether to show a confirmation dialog when the cancel button is pressed. | - |
enableCancelTrimming | boolean | Whether the user can cancel a trim that is in progress. | - |
enableCancelTrimmingDialog | boolean | Whether to show a confirmation dialog when cancelling an in-progress trim. | - |
enableEditTools | boolean | Whether to show the top toolbar of edit tools (flip, rotate, crop, mute, speed, undo, redo). Set to false to hide the entire toolbar. Default true. Video only: the toolbar never appears for audio files. | - |
enableHapticFeedback | boolean | Whether to enable haptic feedback when interacting with the trimmer. | - |
enablePreciseTrimming | boolean | When true, FFmpeg re-encodes the video using the platform's hardware encoder (h264_videotoolbox on iOS, h264_mediacodec on Android) for frame-accurate trimming. When false (default), uses stream copy (-c copy) which is much faster but can only cut at keyframes, so the actual start/end may drift by several seconds. Note: if the user applies any transform (flip/rotate/crop), re-encoding already happens regardless of this flag, so precise trimming comes for free in that case. | BaseOptions.enablePreciseTrimming |
enableSaveDialog | boolean | Whether to show a confirmation dialog when the save button is pressed. | - |
fullScreenModalIOS | boolean | iOS only. Whether to present the editor as a full-screen modal. | - |
handleIconColor? | number | Color of the trimmer left/right handle icons as a processColor value. | - |
headerText | string | Custom header text displayed at the top of the editor. | - |
headerTextColor | number | Color of the header text as a processColor value. | - |
headerTextSize | number | Font size of the header text in sp/pt. | - |
jumpToPositionOnLoad | number | Position in milliseconds to seek to when the editor loads. Set to -1 to disable. | - |
maxDuration | number | Maximum allowed duration for the trimmed clip in milliseconds. Set to -1 for no limit. | - |
minDuration | number | Minimum allowed duration for the trimmed clip in milliseconds. Set to -1 for no limit. The editor never allows a selection shorter than 1 second. | - |
openDocumentsOnFinish | boolean | Whether to open the system document picker to save the output after trimming finishes. | - |
openShareSheetOnFinish | boolean | Whether to open the share sheet after trimming finishes. | - |
outputExt | string | Output file extension (e.g. "mp4", "wav"). | BaseOptions.outputExt |
removeAfterFailedToSaveDocuments | boolean | Whether to remove the output file if saving through the document picker fails. | - |
removeAfterFailedToSavePhoto | boolean | Whether to remove the output file if saving to the photo library fails. | BaseOptions.removeAfterFailedToSavePhoto |
removeAfterFailedToShare | boolean | iOS only. Whether to remove the output file if sharing fails. | - |
removeAfterSavedToDocuments | boolean | Whether to remove the output file after it has been saved through the document picker. | - |
removeAfterSavedToPhoto | boolean | Whether to remove the output file after it has been saved to the photo library. | BaseOptions.removeAfterSavedToPhoto |
removeAfterShared | boolean | iOS only. Whether to remove the output file after it has been shared. | - |
removeAudio | boolean | When true, strips the audio track from the output. Default false. In the editor, playback also starts muted, and the output has no audio even if the user unmutes. | BaseOptions.removeAudio |
saveButtonText | string | Text for the save button. | - |
saveDialogCancelText | string | Text for the dismiss button in the save confirmation dialog. | - |
saveDialogConfirmText | string | Text for the confirm button in the save confirmation dialog. | - |
saveDialogMessage | string | Message of the save confirmation dialog. | - |
saveDialogTitle | string | Title of the save confirmation dialog. | - |
saveToPhoto | boolean | Whether to save the output file to the device's photo library. | BaseOptions.saveToPhoto |
speed | number | Playback speed multiplier applied during export. 1.0 is normal speed, 2.0 is double speed, 0.5 is half speed. Valid range: 0.25–4.0. When not 1.0, re-encoding is forced regardless of enablePreciseTrimming. | BaseOptions.speed |
theme? | string | Editor theme. "dark" (default) uses a black background with white UI elements. "light" uses a white background with black icons/text and white trimmer-handle chevrons. | - |
trimmerColor? | number | Color of the trimmer bar as a processColor value. | - |
trimmingText | string | Text displayed while the video is being trimmed (e.g. "Trimming video..."). | - |
type | string | Media type: "video" or "audio". | BaseOptions.type |
waveformBackgroundColor? | number | Background color behind the audio waveform bars as a processColor value. | - |
waveformBarCornerRadius? | number | Corner radius of waveform bars in dp/pt (default: 1.5). | - |
waveformBarGap? | number | Gap between waveform bars in dp/pt (default: 2). | - |
waveformBarWidth? | number | Width of each waveform bar in dp/pt (default: 3). | - |
waveformColor? | number | Color of the audio waveform bars as a processColor value. | - |
zoomOnWaitingDuration? | number | How much time, in milliseconds, the timeline shows when it zooms in (default: 5000). When the user holds a trim handle still while dragging, the timeline zooms in to this span around the handle for finer adjustment. | - |