• Shotcut QML Scripting API
  • org.shotcut.qml
  • Settings
  • Settings QML Type

    Persistent application settings, accessed via the settings context property. More...

    Import Statement: import org.shotcut.qml

    Properties

    Detailed Description

    settings is an uncreatable QML type — use the global settings identifier available in every Shotcut QML view. Settings are backed by QSettings and persist across sessions.

    if (settings.timelineSnap) { ... }
    settings.timelineSnap = true

    Property Documentation

    appDataLocation : string

    The path to the application data directory (read-only).


    askOutputFilter : bool

    Whether Shotcut should prompt before applying a filter to the output node.


    audioInCurve : int

    The curve type for audio fade-in (0 = linear, higher = more exponential).


    audioInDuration : real

    The default duration in seconds for audio fade-in transitions.


    audioOutCurve : int

    The curve type for audio fade-out (0 = linear, higher = more exponential).


    audioOutDuration : real

    The default duration in seconds for audio fade-out transitions.


    keyframesDragScrub : bool

    Whether scrubbing occurs while dragging keyframes.


    openPath : string

    The last directory used for opening files.


    playerAudioChannels : int

    The number of audio channels used by the player (e.g. 2 or 6).


    playerGPU : bool

    Whether GPU processing (GLSL) is enabled for the video player.


    playlistThumbnails : string

    The thumbnail display mode for the Playlist panel.


    savePath : string

    The last directory used for saving files.


    smallIcons : bool

    Whether the toolbar uses small icons.


    timelineAdjustGain : bool

    Whether dragging the gain handle on audio clips adjusts volume inline.


    timelineAllowTransitions : bool

    Whether overlapping clips on the timeline automatically create transitions.


    timelineDragScrub : bool

    Whether scrubbing occurs while dragging clips on the timeline.


    timelineFramebufferWaveform : bool

    Whether waveforms are rendered using a framebuffer (GPU) path.


    timelineRectangleSelect : bool

    Whether rectangle (rubber-band) selection is enabled on the timeline.


    timelineRipple : bool

    Whether ripple editing is enabled on the timeline.


    timelineRippleAllTracks : bool

    Whether ripple editing affects all tracks simultaneously.


    timelineRippleMarkers : bool

    Whether markers are moved along with ripple edits.


    timelineScrollZoom : bool

    Whether the scroll wheel zooms the timeline (instead of scrolling).


    timelineScrolling : Settings::TimelineScrolling

    The timeline auto-scroll mode. One of NoScrolling, CenterPlayhead, PageScrolling, or SmoothScrolling.


    timelineShowThumbnails : bool

    Whether video thumbnails are shown on timeline clips.


    timelineShowWaveforms : bool

    Whether audio waveforms are shown on timeline clips.


    timelineSnap : bool

    Whether clip snapping is enabled on the timeline.


    videoInDuration : real

    The default duration in seconds for video fade-in transitions.


    videoOutDuration : real

    The default duration in seconds for video fade-out transitions.


    viewMode : string

    The current view mode of the Playlist panel (e.g. "details", "icons").