Navigation

Sequencer Operators

bpy.ops.sequencer.change_effect_input(swap='A_B')

Undocumented (contribute)

Parameters:swap (enum in [‘A_B’, ‘B_C’, ‘A_C’], (optional)) – Swap, The effect inputs to swap
bpy.ops.sequencer.change_effect_type(type='CROSS')

Undocumented (contribute)

Parameters:type (enum in [‘CROSS’, ‘ADD’, ‘SUBTRACT’, ‘ALPHA_OVER’, ‘ALPHA_UNDER’, ‘GAMMA_CROSS’, ‘MULTIPLY’, ‘OVER_DROP’, ‘PLUGIN’, ‘WIPE’, ‘GLOW’, ‘TRANSFORM’, ‘COLOR’, ‘SPEED’, ‘MULTICAM’, ‘ADJUSTMENT’], (optional)) –

Type, Sequencer effect type

  • CROSS Crossfade, Crossfade effect strip type.
  • ADD Add, Add effect strip type.
  • SUBTRACT Subtract, Subtract effect strip type.
  • ALPHA_OVER Alpha Over, Alpha Over effect strip type.
  • ALPHA_UNDER Alpha Under, Alpha Under effect strip type.
  • GAMMA_CROSS Gamma Cross, Gamma Cross effect strip type.
  • MULTIPLY Multiply, Multiply effect strip type.
  • OVER_DROP Alpha Over Drop, Alpha Over Drop effect strip type.
  • PLUGIN Plugin, Plugin effect strip type.
  • WIPE Wipe, Wipe effect strip type.
  • GLOW Glow, Glow effect strip type.
  • TRANSFORM Transform, Transform effect strip type.
  • COLOR Color, Color effect strip type.
  • SPEED Speed, Color effect strip type.
  • MULTICAM Multicam Selector.
  • ADJUSTMENT Adjustment Layer.
bpy.ops.sequencer.change_path(filepath="", directory="", files=None, filter_blender=False, filter_image=True, filter_movie=True, filter_python=False, filter_font=False, filter_sound=False, filter_text=False, filter_btx=False, filter_collada=False, filter_folder=True, filemode=9, relative_path=True, display_type='FILE_DEFAULTDISPLAY')

Undocumented (contribute)

Parameters:
  • filepath (string, (optional)) – File Path, Path to file
  • directory (string, (optional)) – Directory, Directory of the file
  • files (bpy_prop_collection of OperatorFileListElement, (optional)) – Files
  • filter_blender (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_btx (boolean, (optional)) – Filter btx files
  • filter_collada (boolean, (optional)) – Filter COLLADA files
  • filter_folder (boolean, (optional)) – Filter folders
  • 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 [‘FILE_DEFAULTDISPLAY’, ‘FILE_SHORTDISPLAY’, ‘FILE_LONGDISPLAY’, ‘FILE_IMGDISPLAY’], (optional)) –

    Display Type

    • FILE_DEFAULTDISPLAY Default, Automatically determine display type for files.
    • FILE_SHORTDISPLAY Short List, Display files as short list.
    • FILE_LONGDISPLAY Long List, Display files as a detailed list.
    • FILE_IMGDISPLAY Thumbnails, Display files as thumbnails.
bpy.ops.sequencer.copy()

Undocumented (contribute)

bpy.ops.sequencer.crossfade_sounds()

Do cross-fading volume animation of two selected sound strips

File :startup/bl_operators/sequencer.py:41
bpy.ops.sequencer.cut(frame=0, type='SOFT', side='BOTH')

Cut the selected strips

Parameters:
  • frame (int in [-inf, inf], (optional)) – Frame, Frame where selected strips will be cut
  • type (enum in [‘SOFT’, ‘HARD’], (optional)) – Type, The type of cut operation to perform on strips
  • side (enum in [‘LEFT’, ‘RIGHT’, ‘BOTH’], (optional)) – Side, The side that remains selected after cutting
bpy.ops.sequencer.cut_multicam(camera=1)

Cut multi-cam strip and select camera

Parameters:camera (int in [1, 32], (optional)) – Camera
File :startup/bl_operators/sequencer.py:99
bpy.ops.sequencer.deinterlace_selected_movies()

Deinterlace all selected movie sources

File :startup/bl_operators/sequencer.py:134
bpy.ops.sequencer.delete()

Erase selected strips from the sequencer

bpy.ops.sequencer.duplicate(mode='TRANSLATION')

Duplicate the selected strips

Parameters:mode (enum in [‘INIT’, ‘DUMMY’, ‘TRANSLATION’, ‘ROTATION’, ‘RESIZE’, ‘TOSPHERE’, ‘SHEAR’, ‘WARP’, ‘SHRINKFATTEN’, ‘TILT’, ‘TRACKBALL’, ‘PUSHPULL’, ‘CREASE’, ‘MIRROR’, ‘BONE_SIZE’, ‘BONE_ENVELOPE’, ‘CURVE_SHRINKFATTEN’, ‘BONE_ROLL’, ‘TIME_TRANSLATE’, ‘TIME_SLIDE’, ‘TIME_SCALE’, ‘TIME_EXTEND’, ‘BAKE_TIME’, ‘BEVEL’, ‘BWEIGHT’, ‘ALIGN’, ‘EDGESLIDE’, ‘SEQSLIDE’], (optional)) – Mode
bpy.ops.sequencer.effect_strip_add(filepath="", filter_blender=False, filter_image=False, filter_movie=False, filter_python=False, filter_font=False, filter_sound=False, filter_text=False, filter_btx=False, filter_collada=False, filter_folder=False, filemode=9, relative_path=True, display_type='FILE_DEFAULTDISPLAY', frame_start=0, frame_end=0, channel=1, replace_sel=True, overlap=False, type='CROSS', color=(0.0, 0.0, 0.0))

Add an effect to the sequencer, most are applied on top of existing strips

Parameters:
  • filepath (string, (optional)) – File Path, Path to file
  • filter_blender (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_btx (boolean, (optional)) – Filter btx files
  • filter_collada (boolean, (optional)) – Filter COLLADA files
  • filter_folder (boolean, (optional)) – Filter folders
  • 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 [‘FILE_DEFAULTDISPLAY’, ‘FILE_SHORTDISPLAY’, ‘FILE_LONGDISPLAY’, ‘FILE_IMGDISPLAY’], (optional)) –

    Display Type

    • FILE_DEFAULTDISPLAY Default, Automatically determine display type for files.
    • FILE_SHORTDISPLAY Short List, Display files as short list.
    • FILE_LONGDISPLAY Long List, Display files as a detailed list.
    • FILE_IMGDISPLAY Thumbnails, Display files as thumbnails.
  • frame_start (int in [-inf, inf], (optional)) – Start Frame, Start frame of the sequence strip
  • frame_end (int in [-inf, inf], (optional)) – End Frame, End frame for the color strip
  • channel (int in [1, 32], (optional)) – Channel, Channel to place this strip into
  • replace_sel (boolean, (optional)) – Replace Selection, replace the current selection
  • overlap (boolean, (optional)) – Allow Overlap, Don’t correct overlap on new sequence strips
  • type (enum in [‘CROSS’, ‘ADD’, ‘SUBTRACT’, ‘ALPHA_OVER’, ‘ALPHA_UNDER’, ‘GAMMA_CROSS’, ‘MULTIPLY’, ‘OVER_DROP’, ‘PLUGIN’, ‘WIPE’, ‘GLOW’, ‘TRANSFORM’, ‘COLOR’, ‘SPEED’, ‘MULTICAM’, ‘ADJUSTMENT’], (optional)) –

    Type, Sequencer effect type

    • CROSS Crossfade, Crossfade effect strip type.
    • ADD Add, Add effect strip type.
    • SUBTRACT Subtract, Subtract effect strip type.
    • ALPHA_OVER Alpha Over, Alpha Over effect strip type.
    • ALPHA_UNDER Alpha Under, Alpha Under effect strip type.
    • GAMMA_CROSS Gamma Cross, Gamma Cross effect strip type.
    • MULTIPLY Multiply, Multiply effect strip type.
    • OVER_DROP Alpha Over Drop, Alpha Over Drop effect strip type.
    • PLUGIN Plugin, Plugin effect strip type.
    • WIPE Wipe, Wipe effect strip type.
    • GLOW Glow, Glow effect strip type.
    • TRANSFORM Transform, Transform effect strip type.
    • COLOR Color, Color effect strip type.
    • SPEED Speed, Color effect strip type.
    • MULTICAM Multicam Selector.
    • ADJUSTMENT Adjustment Layer.
  • color (float array of 3 items in [0, 1], (optional)) – Color, Initialize the strip with this color (only used when type=’COLOR’)
bpy.ops.sequencer.image_strip_add(directory="", files=None, filter_blender=False, filter_image=True, filter_movie=False, filter_python=False, filter_font=False, filter_sound=False, filter_text=False, filter_btx=False, filter_collada=False, filter_folder=True, filemode=9, relative_path=True, display_type='FILE_DEFAULTDISPLAY', frame_start=0, frame_end=0, channel=1, replace_sel=True, overlap=False)

Add an image or image sequence to the sequencer

Parameters:
  • directory (string, (optional)) – Directory, Directory of the file
  • files (bpy_prop_collection of OperatorFileListElement, (optional)) – Files
  • filter_blender (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_btx (boolean, (optional)) – Filter btx files
  • filter_collada (boolean, (optional)) – Filter COLLADA files
  • filter_folder (boolean, (optional)) – Filter folders
  • 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 [‘FILE_DEFAULTDISPLAY’, ‘FILE_SHORTDISPLAY’, ‘FILE_LONGDISPLAY’, ‘FILE_IMGDISPLAY’], (optional)) –

    Display Type

    • FILE_DEFAULTDISPLAY Default, Automatically determine display type for files.
    • FILE_SHORTDISPLAY Short List, Display files as short list.
    • FILE_LONGDISPLAY Long List, Display files as a detailed list.
    • FILE_IMGDISPLAY Thumbnails, Display files as thumbnails.
  • frame_start (int in [-inf, inf], (optional)) – Start Frame, Start frame of the sequence strip
  • frame_end (int in [-inf, inf], (optional)) – End Frame, End frame for the color strip
  • channel (int in [1, 32], (optional)) – Channel, Channel to place this strip into
  • replace_sel (boolean, (optional)) – Replace Selection, replace the current selection
  • overlap (boolean, (optional)) – Allow Overlap, Don’t correct overlap on new sequence strips
bpy.ops.sequencer.images_separate(length=1)

On image sequence strips, it returns a strip for each image

Parameters:length (int in [1, 1000], (optional)) – Length, Length of each frame
bpy.ops.sequencer.lock()

Lock the active strip so that it can’t be transformed

bpy.ops.sequencer.meta_make()

Group selected strips into a metastrip

bpy.ops.sequencer.meta_separate()

Put the contents of a metastrip back in the sequencer

bpy.ops.sequencer.meta_toggle()

Toggle a metastrip (to edit enclosed strips)

bpy.ops.sequencer.movie_strip_add(filepath="", files=None, filter_blender=False, filter_image=False, filter_movie=True, filter_python=False, filter_font=False, filter_sound=False, filter_text=False, filter_btx=False, filter_collada=False, filter_folder=True, filemode=9, relative_path=True, display_type='FILE_DEFAULTDISPLAY', frame_start=0, channel=1, replace_sel=True, overlap=False, sound=True)

Add a movie strip to the sequencer

Parameters:
  • filepath (string, (optional)) – File Path, Path to file
  • files (bpy_prop_collection of OperatorFileListElement, (optional)) – Files
  • filter_blender (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_btx (boolean, (optional)) – Filter btx files
  • filter_collada (boolean, (optional)) – Filter COLLADA files
  • filter_folder (boolean, (optional)) – Filter folders
  • 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 [‘FILE_DEFAULTDISPLAY’, ‘FILE_SHORTDISPLAY’, ‘FILE_LONGDISPLAY’, ‘FILE_IMGDISPLAY’], (optional)) –

    Display Type

    • FILE_DEFAULTDISPLAY Default, Automatically determine display type for files.
    • FILE_SHORTDISPLAY Short List, Display files as short list.
    • FILE_LONGDISPLAY Long List, Display files as a detailed list.
    • FILE_IMGDISPLAY Thumbnails, Display files as thumbnails.
  • frame_start (int in [-inf, inf], (optional)) – Start Frame, Start frame of the sequence strip
  • channel (int in [1, 32], (optional)) – Channel, Channel to place this strip into
  • replace_sel (boolean, (optional)) – Replace Selection, replace the current selection
  • overlap (boolean, (optional)) – Allow Overlap, Don’t correct overlap on new sequence strips
  • sound (boolean, (optional)) – Sound, Load sound with the movie
bpy.ops.sequencer.mute(unselected=False)

Mute selected strips

Parameters:unselected (boolean, (optional)) – Unselected, Mute unselected rather than selected strips
bpy.ops.sequencer.next_edit()

Move frame to next edit point

bpy.ops.sequencer.offset_clear()

Clear strip offsets from the start and end frames

bpy.ops.sequencer.paste()

Undocumented (contribute)

bpy.ops.sequencer.previous_edit()

Move frame to previous edit point

bpy.ops.sequencer.properties()

Open sequencer properties panel

bpy.ops.sequencer.reassign_inputs()

Reassign the inputs for the effect strip

bpy.ops.sequencer.rebuild_proxy()

Rebuild all selected proxies and timecode indeces using the job system

bpy.ops.sequencer.refresh_all()

Refresh the sequencer editor

bpy.ops.sequencer.reload()

Reload strips in the sequencer

bpy.ops.sequencer.rendersize()

Set render size and aspect from active sequence

bpy.ops.sequencer.scene_strip_add(frame_start=0, channel=1, replace_sel=True, overlap=False, scene='')

Add a strip to the sequencer using a blender scene as a source

Parameters:
  • frame_start (int in [-inf, inf], (optional)) – Start Frame, Start frame of the sequence strip
  • channel (int in [1, 32], (optional)) – Channel, Channel to place this strip into
  • replace_sel (boolean, (optional)) – Replace Selection, replace the current selection
  • overlap (boolean, (optional)) – Allow Overlap, Don’t correct overlap on new sequence strips
  • scene (enum in [], (optional)) – Scene
bpy.ops.sequencer.select(extend=False, linked_handle=False, left_right=False, linked_time=False)

Select a strip (last selected becomes the “active strip”)

Parameters:
  • extend (boolean, (optional)) – Extend, Extend the selection
  • linked_handle (boolean, (optional)) – Linked Handle, Select handles next to the active strip
  • left_right (boolean, (optional)) – Left/Right, Select based on the current frame side the cursor is on
  • linked_time (boolean, (optional)) – Linked Time, Select other strips at the same time
bpy.ops.sequencer.select_active_side(side='BOTH')

Select strips on the nominated side of the active strip

Parameters:side (enum in [‘LEFT’, ‘RIGHT’, ‘BOTH’], (optional)) – Side, The side of the handle that is selected
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_border(gesture_mode=0, xmin=0, xmax=0, ymin=0, ymax=0, extend=True)

Enable border select mode

Parameters:
  • gesture_mode (int in [-inf, inf], (optional)) – Gesture Mode
  • 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
  • extend (boolean, (optional)) – Extend, Extend selection instead of deselecting everything first
bpy.ops.sequencer.select_grouped(extend=False, type='TYPE')

Select all strips grouped by various properties

Parameters:
  • extend (boolean, (optional)) – Extend, Extend selection instead of deselecting everything first
  • 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.
bpy.ops.sequencer.select_handles(side='BOTH')

Select manipulator handles on the sides of the selected strip

Parameters:side (enum in [‘LEFT’, ‘RIGHT’, ‘BOTH’], (optional)) – Side, The side of the handle that is selected
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.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="", files=None, filter_blender=False, filter_image=False, filter_movie=False, filter_python=False, filter_font=False, filter_sound=True, filter_text=False, filter_btx=False, filter_collada=False, filter_folder=True, filemode=9, relative_path=True, display_type='FILE_DEFAULTDISPLAY', frame_start=0, channel=1, replace_sel=True, overlap=False, cache=False)

Add a sound strip to the sequencer

Parameters:
  • filepath (string, (optional)) – File Path, Path to file
  • files (bpy_prop_collection of OperatorFileListElement, (optional)) – Files
  • filter_blender (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_btx (boolean, (optional)) – Filter btx files
  • filter_collada (boolean, (optional)) – Filter COLLADA files
  • filter_folder (boolean, (optional)) – Filter folders
  • 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 [‘FILE_DEFAULTDISPLAY’, ‘FILE_SHORTDISPLAY’, ‘FILE_LONGDISPLAY’, ‘FILE_IMGDISPLAY’], (optional)) –

    Display Type

    • FILE_DEFAULTDISPLAY Default, Automatically determine display type for files.
    • FILE_SHORTDISPLAY Short List, Display files as short list.
    • FILE_LONGDISPLAY Long List, Display files as a detailed list.
    • FILE_IMGDISPLAY Thumbnails, Display files as thumbnails.
  • frame_start (int in [-inf, inf], (optional)) – Start Frame, Start frame of the sequence strip
  • channel (int in [1, 32], (optional)) – Channel, Channel to place this strip into
  • replace_sel (boolean, (optional)) – Replace Selection, replace the current selection
  • overlap (boolean, (optional)) – Allow Overlap, Don’t correct overlap on new sequence strips
  • cache (boolean, (optional)) – Cache, Cache the sound in memory
bpy.ops.sequencer.swap(side='RIGHT')

Swap active strip with strip to the right or left

Parameters:side (enum in [‘LEFT’, ‘RIGHT’], (optional)) – Side, Side of the strip to swap
bpy.ops.sequencer.swap_data()

Swap 2 sequencer strips

bpy.ops.sequencer.swap_inputs()

Swap the first two inputs for the effect strip

bpy.ops.sequencer.unlock()

Unlock the active strip so that it can’t be transformed

bpy.ops.sequencer.unmute(unselected=False)

Un-Mute unselected rather than selected strips

Parameters:unselected (boolean, (optional)) – Unselected, UnMute unselected rather than selected strips
bpy.ops.sequencer.view_all()

View all the strips in the sequencer

bpy.ops.sequencer.view_all_preview()

Zoom preview to fit in the area

bpy.ops.sequencer.view_ghost_border(gesture_mode=0, xmin=0, xmax=0, ymin=0, ymax=0)

Enable border select mode

Parameters:
  • gesture_mode (int in [-inf, inf], (optional)) – Gesture Mode
  • 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
bpy.ops.sequencer.view_selected()

Zoom the sequencer on the selected strips

bpy.ops.sequencer.view_toggle()

Toggle between sequencer views (sequence, preview, both)

bpy.ops.sequencer.view_zoom_ratio(ratio=1.0)

Change zoom ratio of sequencer preview

Parameters:ratio (float in [0, inf], (optional)) – Ratio, Zoom ratio, 1.0 is 1:1, higher is zoomed in, lower is zoomed out

Previous topic

Sculpt Operators

Next topic

Sketch Operators

Navigation

© Copyright Blender Foundation. Created using Sphinx 1.1.2.