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

assistant: M_OT_translate** (`TRANSFORM_OT_translate`, (optional)) – Move, Move selected items

bpy.ops.sequencer.preview_duplicate_move_linked(*\**, *SEQUENCER_OT_duplicate=None*, *TRANSFORM_OT_translate=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_translate** (`TRANSFORM_OT_translate`, (optional)) – Move, Move selected items

bpy.ops.sequencer.reassign_inputs()
:   Reassign the inputs for the effect strip

bpy.ops.sequencer.rebuild_proxy()
:   Rebuild all selected proxies and timecode indices

bpy.ops.sequencer.refresh_all()
:   Refresh the sequencer editor

bpy.ops.sequencer.reload(*\**, *adjust_length=False*)
:   Reload strips in the sequencer

    Parameters:
    :   **adjust_length** (*boolean**,* *(**optional**)*) – Adjust Length, Adjust length of strips to their data length

bpy.ops.sequencer.rename_channel()
:   Undocumented, consider [contributing](https://developer.blender.org/).

bpy.ops.sequencer.rendersize()
:   Set render size and aspect from active strip

bpy.ops.sequencer.retiming_add_freeze_frame_slide(*\**, *SEQUENCER_OT_retiming_freeze_frame_add=None*, *TRANSFORM_OT_seq_slide=None*)
:   Add freeze frame and move it

    Parameters:
    :   - **SEQUENCER_OT_retiming_freeze_frame_add** (`SEQUENCER_OT_retiming_freeze_frame_add`, (optional)) – Add Freeze Frame, Add freeze frame
        - **TRANSFORM_OT_seq_slide** (`TRANSFORM_OT_seq_slide`, (optional)) – Sequence Slide, Slide a sequence strip in time

bpy.ops.sequencer.retiming_add_transition_slide(*\**, *SEQUENCER_OT_retiming_transition_add=None*, *TRANSFORM_OT_seq_slide=None*)
:   Add smooth transition between 2 retimed segments and change its duration

    Parameters:
    :   - **SEQUENCER_OT_retiming_transition_add** (`SEQUENCER_OT_retiming_transition_add`, (optional)) – Add Speed Transition, Add smooth transition between 2 retimed segments
        - **TRANSFORM_OT_seq_slide** (`TRANSFORM_OT_seq_slide`, (optional)) – Sequence Slide, Slide a sequence strip in time

bpy.ops.sequencer.retiming_freeze_frame_add(*\**, *duration=0*)
:   Add freeze frame

    Parameters:
    :   **duration** (*int in* *[**0**,* *inf**]**,* *(**optional**)*) – Duration, Duration of freeze frame segment

bpy.ops.sequencer.retiming_key_add(*\**, *timeline_frame=0*)
:   Add retiming Key

    Parameters:
    :   **timeline_frame** (*int in* *[**0**,* *inf**]**,* *(**optional**)*) – Timeline Frame, Frame where key will be added

bpy.ops.sequencer.retiming_key_delete()
:   Delete selected retiming keys from the sequencer

bpy.ops.sequencer.retiming_reset()
:   Reset strip retiming

bpy.ops.sequencer.retiming_segment_speed_set(*\**, *speed=100.0*, *keep_retiming=True*)
:   Set speed of retimed segment

    Parameters:
    :   - **speed** (*float in* *[**0.001**,* *inf**]**,* *(**optional**)*) – Speed, New speed of retimed segment
        - **keep_retiming** (*boolean**,* *(**optional**)*) – Preserve Current Retiming, Keep speed of other segments unchanged, change strip length instead

bpy.ops.sequencer.retiming_show()
:   Show retiming keys in selected strips

bpy.ops.sequencer.retiming_transition_add(*\**, *duration=0*)
:   Add smooth transition between 2 retimed segments

    Parameters:
    :   **duration** (*int in* *[**0**,* *inf**]**,* *(**optional**)*) – Duration, Duration of freeze frame segment

bpy.ops.sequencer.sample(*\**, *size=1*)
:   Use mouse to sample color in current frame

    Parameters:
    :   **size** (*int in* *[**1**,* *128**]**,* *(**optional**)*) – Sample Size

bpy.ops.sequencer.scene_frame_range_update()
:   Update frame range of scene strip

bpy.ops.sequencer.scene_strip_add(*\**, *move_strips=True*, *frame_start=0*, *channel=1*, *replace_sel=True*, *overlap=False*, *overlap_shuffle_override=False*, *skip_locked_or_muted_channels=True*, *scene=''*)
:   Add a strip re-using this scene 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
        - **scene** (*enum in* *[**]**,* *(**optional**)*) – Scene

bpy.ops.sequencer.scene_strip_add_new(*\**, *move_strips=True*, *frame_start=0*, *channel=1*, *replace_sel=True*, *overlap=False*, *overlap_shuffle_override=False*, *skip_locked_or_muted_channels=True*, *type='NEW'*)
:   Add a strip using a new scene 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
        - **type** (enum in [`'NEW'`, `'EMPTY'`, `'LINK_COPY'`, `'FULL_COPY'`], (optional)) –

          Type

          - `NEW`
            New – Add new Strip with a new empty Scene with default settings.
          - `EMPTY`
            Copy Settings – Add a new Strip, with an empty scene, and copy settings from the current scene.
          - `LINK_COPY`
            Linked Copy – Add a Strip and link in the collections from the current scene (shallow copy).
          - `FULL_COPY`
            Full Copy – Add a Strip and make a full copy of the current scene.

bpy.ops.sequencer.select(*\**, *wait_to_deselect_others=False*, *use_select_on_click=False*, *mouse_x=0*, *mouse_y=0*, *extend=False*, *deselect=False*, *toggle=False*, *deselect_all=False*, *select_passthrough=False*, *center=False*, *linked_handle=False*, *linked_time=False*, *side_of_frame=False*, *ignore_connections=False*)
:   Select a strip (last selected becomes the “active strip”)

    Parameters:
    :   - **wait_to_deselect_others** (*boolean**,* *(**optional**)*) – Wait to Deselect Others
        - **use_select_on_click** (*boolean**,* *(**optional**)*) – Act on Click, Instead of selecting on mouse press, wait to see if there’s drag event. Otherwise select on mouse release
        - **mouse_x** (*int in* *[**-inf**,* *inf**]**,* *(**optional**)*) – Mouse X
        - **mouse_y** (*int in* *[**-inf**,* *inf**]**,* *(**optional**)*) – Mouse Y
        - **extend** (*boolean**,* *(**optional**)*) – Extend, Extend selection instead of deselecting everything first
        - **deselect** (*boolean**,* *(**optional**)*) – Deselect, Remove from selection
        - **toggle** (*boolean**,* *(**optional**)*) – Toggle Selection, Toggle the selection
        - **deselect_all** (*boolean**,* *(**optional**)*) – Deselect On Nothing, Deselect all when nothing under the cursor
        - **select_passthrough** (*boolean**,* *(**optional**)*) – Only Select Unselected, Ignore the select action when the element is already selected
        - **center** (*boolean**,* *(**optional**)*) – Center, Use the object center when selecting, in edit mode used to extend object selection
        - **linked_handle** (*boolean**,* *(**optional**)*) – Linked Handle, Select handles next to the active strip
        - **linked_time** (*boolean**,* *(**optional**)*) – Linked Time, Select other strips or handles at the same time, or all retiming keys after the current in retiming mode
        - **side_of_frame** (*boolean**,* *(**optional**)*) – Side of Frame, Select all strips on same side of the current frame as the mouse cursor
        - **ignore_connections** (*boolean**,* *(**optional**)*) – Ignore Connections, Select strips individually whether or not they are connected

bpy.ops.sequencer.select_all(*\**, *action='TOGGLE'*)
:   Select or deselect all strips

    Parameters:
    :   **action** (enum in [`'TOGGLE'`, `'SELECT'`, `'DESELECT'`, `'INVERT'`], (optional)) –

        Action, Selection action to execute

        - `TOGGLE`
          Toggle – Toggle selection for all elements.
        - `SELECT`
          Select – Select all elements.
        - `DESELECT`
          Deselect – Deselect all elements.
        - `INVERT`
          Invert – Invert selection of all elements.

bpy.ops.sequencer.select_box(*\**, *xmin=0*, *xmax=0*, *ymin=0*, *ymax=0*, *wait_for_input=True*, *mode='SET'*, *tweak=False*, *include_handles=False*, *ignore_connections=False*)
:   Select strips using box selection

    Parameters:
    :   - **xmin** (*int in* *[**-inf**,* *inf**]**,* *(**optional**)*) – X Min
        - **xmax** (*int in* *[**-inf**,* *inf**]**,* *(**optional**)*) – X Max
        - **ymin** (*int in* *[**-inf**,* *inf**]**,* *(**optional**)*) – Y Min
        - **ymax** (*int in* *[**-inf**,* *inf**]**,* *(**optional**)*) – Y Max
        - **wait_for_input** (*boolean**,* *(**optional**)*) – Wait for Input
        - **mode** (enum in [`'SET'`, `'ADD'`, `'SUB'`], (optional)) –

          Mode

          - `SET`
            Set – Set a new selection.
          - `ADD`
            Extend – Extend existing selection.
          - `SUB`
            Subtract – Subtract existing selection.
        - **tweak** (*boolean**,* *(**optional**)*) – Tweak, Make box select pass through to sequence slide when the cursor is hovering on a strip
        - **include_handles** (*boolean**,* *(**optional**)*) – Select Handles, Select the strips and their handles
        - **ignore_connections** (*boolean**,* *(**optional**)*) – Ignore Connections, Select strips individually whether or not they are connected

bpy.ops.sequencer.select_circle(*\**, *x=0*, *y=0*, *radius=25*, *wait_for_input=True*, *mode='SET'*, *ignore_connections=False*)
:   Select strips using circle selection

    Parameters:
    :   - **x** (*int in* *[**-inf**,* *inf**]**,* *(**optional**)*) – X
        - **y** (*int in* *[**-inf**,* *inf**]**,* *(**optional**)*) – Y
        - **radius** (*int in* *[**1**,* *inf**]**,* *(**optional**)*) – Radius
        - **wait_for_input** (*boolean**,* *(**optional**)*) – Wait for Input
        - **mode** (enum in [`'SET'`, `'ADD'`, `'SUB'`], (optional)) –

          Mode

          - `SET`
            Set – Set a new selection.
          - `ADD`
            Extend – Extend existing selection.
          - `SUB`
            Subtract – Subtract existing selection.
        - **ignore_connections** (*boolean**,* *(**optional**)*) – Ignore Connections, Select strips individually whether or not they are connected

bpy.ops.sequencer.select_grouped(*\**, *type='TYPE'*, *extend=False*, *use_active_channel=False*)
:   Select all strips grouped by various properties

    Parameters:
    :   - **type** (enum in [`'TYPE'`, `'TYPE_BASIC'`, `'TYPE_EFFECT'`, `'DATA'`, `'EFFECT'`, `'EFFECT_LINK'`, `'OVERLAP'`], (optional)) –

          Type

          - `TYPE`
            Type – Shared strip type.
          - `TYPE_BASIC`
            Global Type – All strips of same basic type (graphical or sound).
          - `TYPE_EFFECT`
            Effect Type – Shared strip effect type (if active strip is not an effect one, select all non-effect strips).
          - `DATA`
            Data – Shared data (scene, image, sound, etc.).
          - `EFFECT`
            Effect – Shared effects.
          - `EFFECT_LINK`
            Effect/Linked – Other strips affected by the active one (sharing some time, and below or effect-assigned).
          - `OVERLAP`
            Overlap – Overlapping time.
        - **extend** (*boolean**,* *(**optional**)*) – Extend, Extend selection instead of deselecting everything first
        - **use_active_channel** (*boolean**,* *(**optional**)*) – Same Channel, Only consider strips on the same channel as the active one

bpy.ops.sequencer.select_handle(*\**, *wait_to_deselect_others=False*, *use_select_on_click=False*, *mouse_x=0*, *mouse_y=0*, *ignore_connections=False*)
:   Select strip handle

    Parameters:
    :   - **wait_to_deselect_others** (*boolean**,* *(**optional**)*) – Wait to Deselect Others
        - **use_select_on_click** (*boolean**,* *(**optional**)*) – Act on Click, Instead of selecting on mouse press, wait to see if there’s drag event. Otherwise select on mouse release
        - **mouse_x** (*int in* *[**-inf**,* *inf**]**,* *(**optional**)*) – Mouse X
        - **mouse_y** (*int in* *[**-inf**,* *inf**]**,* *(**optional**)*) – Mouse Y
        - **ignore_connections** (*boolean**,* *(**optional**)*) – Ignore Connections, Select strips individually whether or not they are connected

bpy.ops.sequencer.select_handles(*\**, *side='BOTH'*)
:   Select gizmo handles on the sides of the selected strip

    Parameters:
    :   **side** (enum in [`'LEFT'`, `'RIGHT'`, `'BOTH'`, `'LEFT_NEIGHBOR'`, `'RIGHT_NEIGHBOR'`, `'BOTH_NEIGHBORS'`], (optional)) – Side, The side of the handle that is selected

bpy.ops.sequencer.select_lasso(*\**, *path=None*, *use_smooth_stroke=False*, *smooth_stroke_factor=0.75*, *smooth_stroke_radius=35*, *mode='SET'*)
:   Select strips using lasso selection

    Parameters:
    :   - **path** (`bpy_prop_collection` of `OperatorMousePath`, (optional)) – Path
        - **use_smooth_stroke** (*boolean**,* *(**optional**)*) – Stabilize Stroke, Selection lags behind mouse and follows a smoother path
        - **smooth_stroke_factor** (*float in* *[**0.5**,* *0.99**]**,* *(**optional**)*) – Smooth Stroke Factor, Higher values gives a smoother stroke
        - **smooth_stroke_radius** (*int in* *[**10**,* *200**]**,* *(**optional**)*) – Smooth Stroke Radius, Minimum distance from last point before selection continues
        - **mode** (enum in [`'SET'`, `'ADD'`, `'SUB'`], (optional)) –

          Mode

          - `SET`
            Set – Set a new selection.
          - `ADD`
            Extend – Extend existing selection.
          - `SUB`
            Subtract – Subtract existing selection.

bpy.ops.sequencer.select_less()
:   Shrink the current selection of adjacent selected strips

bpy.ops.sequencer.select_linked()
:   Select all strips adjacent to the current selection

bpy.ops.sequencer.select_linked_pick(*\**, *extend=False*)
:   Select a chain of linked strips nearest to the mouse pointer

    Parameters:
    :   **extend** (*boolean**,* *(**optional**)*) – Extend, Extend the selection

bpy.ops.sequencer.select_more()
:   Select more strips adjacent to the current selection

bpy.ops.sequencer.select_side(*\**, *side='BOTH'*)
:   Select strips on the nominated side of the selected strips

    Parameters:
    :   **side** (enum in [`'MOUSE'`, `'LEFT'`, `'RIGHT'`, `'BOTH'`, `'NO_CHANGE'`], (optional)) – Side, The side to which the selection is applied

bpy.ops.sequencer.select_side_of_frame(*\**, *extend=False*, *side='LEFT'*)
:   Select strips relative to the current frame

    Parameters:
    :   - **extend** (*boolean**,* *(**optional**)*) – Extend, Extend the selection
        - **side** (enum in [`'LEFT'`, `'RIGHT'`, `'CURRENT'`], (optional)) –

          Side

          - `LEFT`
            Left – Select to the left of the current frame.
          - `RIGHT`
            Right – Select to the right of the current frame.
          - `CURRENT`
            Current Frame – Select intersecting with the current frame.

bpy.ops.sequencer.set_range_to_strips(*\**, *preview=False*)
:   Set the frame range to the selected strips start and end

    Parameters:
    :   **preview** (*boolean**,* *(**optional**)*) – Preview, Set the preview range instead

bpy.ops.sequencer.slip(*\**, *offset=0.0*, *slip_keyframes=False*, *use_cursor_position=False*, *ignore_connections=False*)
:   Slip the contents of selected strips

    Parameters:
    :   - **offset** (*float in* *[**-inf**,* *inf**]**,* *(**optional**)*) – Offset, Offset to the data of the strip
        - **slip_keyframes** (*boolean**,* *(**optional**)*) – Slip Keyframes, Move the keyframes alongside the media
        - **use_cursor_position** (*boolean**,* *(**optional**)*) – Use Cursor Position, Slip strips under mouse cursor instead of all selected strips
        - **ignore_connections** (*boolean**,* *(**optional**)*) – Ignore Connections, Do not slip connected strips if using cursor position

bpy.ops.sequencer.snap(*\**, *frame=0*)
:   Frame where selected strips will be snapped

    Parameters:
    :   **frame** (*int in* *[**-inf**,* *inf**]**,* *(**optional**)*) – Frame, Frame where selected strips will be snapped

bpy.ops.sequencer.sound_strip_add(*\**, *filepath=''*, *directory=''*, *files=None*, *check_existing=False*, *filter_blender=False*, *filter_backup=False*, *filter_image=Fal