user: How do I use Sequencer Operators in Blender? Include parameters, examples, warnings and best practices.

assistant: # Sequencer Operators

bpy.ops.sequencer.add_scene_strip_from_scene_asset(*\**, *move_strips=True*, *frame_start=0*, *channel=1*, *replace_sel=True*, *overlap=False*, *overlap_shuffle_override=False*, *skip_locked_or_muted_channels=True*, *asset_library_type='LOCAL'*, *asset_library_identifier=''*, *relative_asset_identifier=''*)
:   Add a strip using a duplicate of this scene asset as the source

    Parameters:
    :   - **move_strips** (*boolean**,* *(**optional**)*) – Move Strips, Automatically begin translating strips with the mouse after adding them to the timeline
        - **frame_start** (*int in* *[**-inf**,* *inf**]**,* *(**optional**)*) – Start Frame, Start frame of the strip
        - **channel** (*int in* *[**1**,* *128**]**,* *(**optional**)*) – Channel, Channel to place this strip into
        - **replace_sel** (*boolean**,* *(**optional**)*) – Replace Selection, Deselect previously selected strips after add operation completes
        - **overlap** (*boolean**,* *(**optional**)*) – Allow Overlap, Don’t correct overlap on new strips
        - **overlap_shuffle_override** (*boolean**,* *(**optional**)*) – Override Overlap Shuffle Behavior, Use the overlap_mode tool settings to determine how to shuffle overlapping strips
        - **skip_locked_or_muted_channels** (*boolean**,* *(**optional**)*) – Skip Locked or Muted Channels, Add strips to muted or locked channels when adding movie strips
        - **asset_library_type** (enum in [Asset Library Type Items](bpy_types_enum_items/asset_library_type_items.html#rna-enum-asset-library-type-items), (optional)) – Asset Library Type
        - **asset_library_identifier** (*string**,* *(**optional**,* *never None**)*) – Asset Library Identifier
        - **relative_asset_identifier** (*string**,* *(**optional**,* *never None**)*) – Relative Asset Identifier

bpy.ops.sequencer.change_effect_type(*\**, *type='CROSS'*)
:   Replace effect strip with another that takes the same number of inputs

    Parameters:
    :   **type** (enum in [`'CROSS'`, `'ADD'`, `'SUBTRACT'`, `'ALPHA_OVER'`, `'ALPHA_UNDER'`, `'GAMMA_CROSS'`, `'MULTIPLY'`, `'WIPE'`, `'GLOW'`, `'COLOR'`, `'SPEED'`, `'MULTICAM'`, `'ADJUSTMENT'`, `'GAUSSIAN_BLUR'`, `'TEXT'`, `'COLORMIX'`], (optional)) –

        Type, Strip effect type

        - `CROSS`
          Crossfade – Fade out of one video, fading into another.
        - `ADD`
          Add – Add together color channels from two videos.
        - `SUBTRACT`
          Subtract – Subtract one strip’s color from another.
        - `ALPHA_OVER`
          Alpha Over – Blend alpha on top of another video.
        - `ALPHA_UNDER`
          Alpha Under – Blend alpha below another video.
        - `GAMMA_CROSS`
          Gamma Crossfade – Crossfade with color correction.
        - `MULTIPLY`
          Multiply – Multiply color channels from two videos.
        - `WIPE`
          Wipe – Sweep a transition line across the frame.
        - `GLOW`
          Glow – Add blur and brightness to light areas.
        - `COLOR`
          Color – Add a simple color strip.
        - `SPEED`
          Speed – Timewarp video strips, modifying playback speed.
        - `MULTICAM`
          Multicam Selector – Control active camera angles.
        - `ADJUSTMENT`
          Adjustment Layer – Apply nondestructive effects.
        - `GAUSSIAN_BLUR`
          Gaussian Blur – Soften details along axes.
        - `TEXT`
          Text – Add a simple text strip.
        - `COLORMIX`
          Color Mix – Combine two strips using blend modes.

bpy.ops.sequencer.change_path(*\**, *filepath=''*, *directory=''*, *files=None*, *hide_props_region=True*, *check_existing=False*, *filter_blender=False*, *filter_backup=False*, *filter_image=False*, *filter_movie=False*, *filter_python=False*, *filter_font=False*, *filter_sound=False*, *filter_text=False*, *filter_archive=False*, *filter_btx=False*, *filter_alembic=False*, *filter_usd=False*, *filter_obj=False*, *filter_volume=False*, *filter_folder=True*, *filter_blenlib=False*, *filemode=9*, *relative_path=True*, *display_type='DEFAULT'*, *sort_method=''*, *use_placeholders=False*)
:   Undocumented, consider [contributing](https://developer.blender.org/).

    Parameters:
    :   - **filepath** (*string**,* *(**optional**,* *never None**)*) – File Path, Path to file
        - **directory** (*string**,* *(**optional**,* *never None**)*) – Directory, Directory of the file
        - **files** (`bpy_prop_collection` of `OperatorFileListElement`, (optional)) – Files
        - **hide_props_region** (*boolean**,* *(**optional**)*) – Hide Operator Properties, Collapse the region displaying the operator settings
        - **check_existing** (*boolean**,* *(**optional**)*) – Check Existing, Check and warn on overwriting existing files
        - **filter_blender** (*boolean**,* *(**optional**)*) – Filter .blend files
        - **filter_backup** (*boolean**,* *(**optional**)*) – Filter .blend files
        - **filter_image** (*boolean**,* *(**optional**)*) – Filter image files
        - **filter_movie** (*boolean**,* *(**optional**)*) – Filter movie files
        - **filter_python** (*boolean**,* *(**optional**)*) – Filter Python files
        - **filter_font** (*boolean**,* *(**optional**)*) – Filter font files
        - **filter_sound** (*boolean**,* *(**optional**)*) – Filter sound files
        - **filter_text** (*boolean**,* *(**optional**)*) – Filter text files
        - **filter_archive** (*boolean**,* *(**optional**)*) – Filter archive files
        - **filter_btx** (*boolean**,* *(**optional**)*) – Filter btx files
        - **filter_alembic** (*boolean**,* *(**optional**)*) – Filter Alembic files
        - **filter_usd** (*boolean**,* *(**optional**)*) – Filter USD files
        - **filter_obj** (*boolean**,* *(**optional**)*) – Filter OBJ files
        - **filter_volume** (*boolean**,* *(**optional**)*) – Filter OpenVDB volume files
        - **filter_folder** (*boolean**,* *(**optional**)*) – Filter folders
        - **filter_blenlib** (*boolean**,* *(**optional**)*) – Filter Blender IDs
        - **filemode** (*int in* *[**1**,* *9**]**,* *(**optional**)*) – File Browser Mode, The setting for the file browser mode to load a .blend file, a library or a special file
        - **relative_path** (*boolean**,* *(**optional**)*) – Relative Path, Select the file relative to the blend file
        - **display_type** (enum in [`'DEFAULT'`, `'LIST_VERTICAL'`, `'LIST_HORIZONTAL'`, `'THUMBNAIL'`], (optional)) –

          Display Type

          - `DEFAULT`
            Default – Automatically determine display type for files.
          - `LIST_VERTICAL`
            Short List – Display files as short list.
          - `LIST_HORIZONTAL`
            Long List – Display files as a detailed list.
          - `THUMBNAIL`
            Thumbnails – Display files as thumbnails.
        - **sort_method** (*enum in* *[**]**,* *(**optional**)*) – File sorting mode
        - **use_placeholders** (*boolean**,* *(**optional**)*) – Use Placeholders, Use placeholders for missing frames of the strip

bpy.ops.sequencer.change_scene(*\**, *scene=''*)
:   Change Scene assigned to Strip

    Parameters:
    :   **scene** (*enum in* *[**]**,* *(**optional**)*) – Scene

bpy.ops.sequencer.connect(*\**, *toggle=True*)
:   Link selected strips together for simplified group selection

    Parameters:
    :   **toggle** (*boolean**,* *(**optional**)*) – Toggle, Toggle strip connections

bpy.ops.sequencer.copy()
:   Copy the selected strips to the internal clipboard

bpy.ops.sequencer.crossfade_sounds()
:   Do cross-fading volume animation of two selected sound strips

    File:
    :   [startup/bl_operators/sequencer.py:43](https://projects.blender.org/blender/blender/src/branch/main/scripts/startup/bl_operators/sequencer.py#L43)

bpy.ops.sequencer.cursor_set(*\**, *location=(0.0, 0.0)*)
:   Set 2D cursor location

    Parameters:
    :   **location** ([`mathutils.Vector`](mathutils.html#mathutils.Vector "mathutils.Vector") of 2 items in [-inf, inf], (optional)) – Location, Cursor location in normalized preview coordinates

bpy.ops.sequencer.deinterlace_selected_movies()
:   Deinterlace all selected movie sources

    File:
    :   [startup/bl_operators/sequencer.py:134](https://projects.blender.org/blender/blender/src/branch/main/scripts/startup/bl_operators/sequencer.py#L134)

bpy.ops.sequencer.delete(*\**, *delete_data=False*)
:   Delete selected strips from the sequencer

    Parameters:
    :   **delete_data** (*boolean**,* *(**optional**)*) – Delete Data, After removing the Strip, delete the associated data also

bpy.ops.sequencer.disconnect()
:   Unlink selected strips so that they can be selected individually

bpy.ops.sequencer.duplicate(*\**, *linked=False*)
:   Duplicate the selected strips

    Parameters:
    :   **linked** (*boolean**,* *(**optional**)*) – Linked, Duplicate strip but not strip data, linking to the original data

bpy.ops.sequencer.duplicate_move(*\**, *SEQUENCER_OT_duplicate=None*, *TRANSFORM_OT_seq_slide=None*)
:   Duplicate selected strips and move them

    Parameters:
    :   - **SEQUENCER_OT_duplicate** (`SEQUENCER_OT_duplicate`, (optional)) – Duplicate Strips, Duplicate the selected strips
        - **TRANSFORM_OT_seq_slide** (`TRANSFORM_OT_seq_slide`, (optional)) – Sequence Slide, Slide a sequence strip in time

bpy.ops.sequencer.duplicate_move_linked(*\**, *SEQUENCER_OT_duplicate=None*, *TRANSFORM_OT_seq_slide=None*)
:   Duplicate selected strips, but not their data, and move them

    Parameters:
    :   - **SEQUENCER_OT_duplicate** (`SEQUENCER_OT_duplicate`, (optional)) – Duplicate Strips, Duplicate the selected strips
        - **TRANSFORM_OT_seq_slide** (`TRANSFORM_OT_seq_slide`, (optional)) – Sequence Slide, Slide a sequence strip in time

bpy.ops.sequencer.effect_strip_add(*\**, *type='CROSS'*, *move_strips=True*, *frame_start=0*, *length=0*, *channel=1*, *replace_sel=True*, *overlap=False*, *overlap_shuffle_override=False*, *skip_locked_or_muted_channels=True*, *color=(0.0, 0.0, 0.0)*)
:   Add an effect to the sequencer, most are applied on top of existing strips

    Parameters:
    :   - **type** (enum in [`'CROSS'`, `'ADD'`, `'SUBTRACT'`, `'ALPHA_OVER'`, `'ALPHA_UNDER'`, `'GAMMA_CROSS'`, `'MULTIPLY'`, `'WIPE'`, `'GLOW'`, `'COLOR'`, `'SPEED'`, `'MULTICAM'`, `'ADJUSTMENT'`, `'GAUSSIAN_BLUR'`, `'TEXT'`, `'COLORMIX'`], (optional)) –

          Type, Sequencer effect type

          - `CROSS`
            Crossfade – Fade out of one video, fading into another.
          - `ADD`
            Add – Add together color channels from two videos.
          - `SUBTRACT`
            Subtract – Subtract one strip’s color from another.
          - `ALPHA_OVER`
            Alpha Over – Blend alpha on top of another video.
          - `ALPHA_UNDER`
            Alpha Under – Blend alpha below another video.
          - `GAMMA_CROSS`
            Gamma Crossfade – Crossfade with color correction.
          - `MULTIPLY`
            Multiply – Multiply color channels from two videos.
          - `WIPE`
            Wipe – Sweep a transition line across the frame.
          - `GLOW`
            Glow – Add blur and brightness to light areas.
          - `COLOR`
            Color – Add a simple color strip.
          - `SPEED`
            Speed – Timewarp video strips, modifying playback speed.
          - `MULTICAM`
            Multicam Selector – Control active camera angles.
          - `ADJUSTMENT`
            Adjustment Layer – Apply nondestructive effects.
          - `GAUSSIAN_BLUR`
            Gaussian Blur – Soften details along axes.
          - `TEXT`
            Text – Add a simple text strip.
          - `COLORMIX`
            Color Mix – Combine two strips using blend modes.
        - **move_strips** (*boolean**,* *(**optional**)*) – Move Strips, Automatically begin translating strips with the mouse after adding them to the timeline
        - **frame_start** (*int in* *[**-inf**,* *inf**]**,* *(**optional**)*) – Start Frame, Start frame of the strip
        - **length** (*int in* *[**-inf**,* *inf**]**,* *(**optional**)*) – Length, Length of the strip in frames, or the length of each strip if multiple are added
        - **channel** (*int in* *[**1**,* *128**]**,* *(**optional**)*) – Channel, Channel to place this strip into
        - **replace_sel** (*boolean**,* *(**optional**)*) – Replace Selection, Deselect previously selected strips after add operation completes
        - **overlap** (*boolean**,* *(**optional**)*) – Allow Overlap, Don’t correct overlap on new strips
        - **overlap_shuffle_override** (*boolean**,* *(**optional**)*) – Override Overlap Shuffle Behavior, Use the overlap_mode tool settings to determine how to shuffle overlapping strips
        - **skip_locked_or_muted_channels** (*boolean**,* *(**optional**)*) – Skip Locked or Muted Channels, Add strips to muted or locked channels when adding movie strips
        - **color** ([`mathutils.Color`](mathutils.html#mathutils.Color "mathutils.Color") of 3 items in [0, 1], (optional)) – Color, Initialize the strip with this color

bpy.ops.sequencer.enable_proxies(*\**, *proxy_25=False*, *proxy_50=False*, *proxy_75=False*, *proxy_100=False*, *overwrite=False*)
:   Enable selected proxies on all selected Movie and Image strips

    Parameters:
    :   - **proxy_25** (*boolean**,* *(**optional**)*) – 25%
        - **proxy_50** (*boolean**,* *(**optional**)*) – 50%
        - **proxy_75** (*boolean**,* *(**optional**)*) – 75%
        - **proxy_100** (*boolean**,* *(**optional**)*) – 100%
        - **overwrite** (*boolean**,* *(**optional**)*) – Overwrite

bpy.ops.sequencer.export_subtitles(*\**, *filepath=''*, *hide_props_region=True*, *check_existing=True*, *filter_blender=False*, *filter_backup=False*, *filter_image=False*, *filter_movie=False*, *filter_python=False*, *filter_font=False*, *filter_sound=False*, *filter_text=False*, *filter_archive=False*, *filter_btx=False*, *filter_alembic=False*, *filter_usd=False*, *filter_obj=False*, *filter_volume=False*, *filter_folder=True*, *filter_blenlib=False*, *filemode=8*, *display_type='DEFAULT'*, *sort_method=''*)
:   Export .srt file containing text strips

    Parameters:
    :   - **filepath** (*string**,* *(**optional**,* *never None**)*) – File Path, Path to file
        - **hide_props_region** (*boolean**,* *(**optional**)*) – Hide Operator Properties, Collapse the region displaying the operator settings
        - **check_existing** (*boolean**,* *(**optional**)*) – Check Existing, Check and warn on overwriting existing files
        - **filter_blender** (*boolean**,* *(**optional**)*) – Filter .blend files
        - **filter_backup** (*boolean**,* *(**optional**)*) – Filter .blend files
        - **filter_image** (*boolean**,* *(**optional**)*) – Filter image files
        - **filter_movie** (*boolean**,* *(**optional**)*) – Filter movie files
        - **filter_python** (*boolean**,* *(**optional**)*) – Filter Python files
        - **filter_font** (*boolean**,* *(**optional**)*) – Filter font files
        - **filter_sound** (*boolean**,* *(**optional**)*) – Filter sound files
        - **filter_text** (*boolean**,* *(**optional**)*) – Filter text files
        - **filter_archive** (*boolean**,* *(**optional**)*) – Filter archive files
        - **filter_btx** (*boolean**,* *(**optional**)*) – Filter btx files
        - **filter_alembic** (*boolean**,* *(**optional**)*) – Filter Alembic files
        - **filter_usd** (*boolean**,* *(**optional**)*) – Filter USD files
        - **filter_obj** (*boolean**,* *(**optional**)*) – Filter OBJ files
        - **filter_volume** (*boolean**,* *(**optional**)*) – Filter OpenVDB volume files
        - **filter_folder** (*boolean**,* *(**optional**)*) – Filter folders
        - **filter_blenlib** (*boolean**,* *(**optional**)*) – Filter Blender IDs
        - **filemode** (*int in* *[**1**,* *9**]**,* *(**optional**)*) – File Browser Mode, The setting for the file browser mode to load a .blend file, a library or a special file
        - **display_type** (enum in [`'DEFAULT'`, `'LIST_VERTICAL'`, `'LIST_HORIZONTAL'`, `'THUMBNAIL'`], (optional)) –

          Display Type

          - `DEFAULT`
            Default – Automatically determine display type for files.
          - `LIST_VERTICAL`
            Short List – Display files as short list.
          - `LIST_HORIZONTAL`
            Long List – Display files as a detailed list.
          - `THUMBNAIL`
            Thumbnails – Display files as thumbnails.
        - **sort_method** (*enum in* *[**]**,* *(**optional**)*) – File sorting mode

bpy.ops.sequencer.fades_add(*\**, *duration_seconds=1.0*, *type='IN_OUT'*)
:   Adds or updates a fade animation for either visual or audio strips

    Parameters:
    :   - **duration_seconds** (*float in* *[**0.01**,* *inf**]**,* *(**optional**)*) – Fade Duration, Duration of the fade in seconds
        - **type** (enum in [`'IN_OUT'`, `'IN'`, `'OUT'`, `'CURSOR_FROM'`, `'CURSOR_TO'`], (optional)) –

          Fade Type, Fade in, out, both in and out, to, or from the current frame. Default is both in and out

          - `IN_OUT`
            Fade In and Out – Fade selected strips in and out.
          - `IN`
            Fade In – Fade in selected strips.
          - `OUT`
            Fade Out – Fade out selected strips.
          - `CURSOR_FROM`
            From Current Frame – Fade from the time cursor to the end of overlapping strips.
          - `CURSOR_TO`
            To Current Frame – Fade from the start of strips under the time cursor to the current frame.

    File:
    :   [startup/bl_operators/sequencer.py:221](https://projects.blender.org/blender/blender/src/branch/main/scripts/startup/bl_operators/sequencer.py#L221)

bpy.ops.sequencer.fades_clear()
:   Removes fade animation from selected strips

    File:
    :   [startup/bl_operators/sequencer.py:157](https://projects.blender.org/blender/blender/src/branch/main/scripts/startup/bl_op