Skip to content

ppt slide set

zmworm edited this page Mar 21, 2026 · 51 revisions

PowerPoint: Slide - Set

Modify slide properties including background, transition, advance timing, and speaker notes.

Path: /slide[N]

Properties

Property Accepted Values Description
background color/gradient/image Background
transition transition format Transition effect
advanceTime milliseconds Auto-advance delay
advanceClick bool Advance on click
notes text Speaker notes
align alignment value Align shapes on slide
distribute horizontal, vertical Distribute shapes evenly

Align Values

  • Shape-relative: left, center, right, top, middle, bottom
  • Slide-relative: slide-left, slide-center, slide-right, slide-top, slide-middle, slide-bottom

Use targets=shape[1],shape[2] to target specific shapes; omit for all shapes.

Background Format

Format Example Description
Solid FF0000 Hex RGB
Linear gradient C1-C2 or C1-C2-angle Two colors with optional angle
Custom stops C1@30-C2@70 Custom stop positions (percent)
Semicolon linear LINEAR;C1;C2;angle Explicit linear gradient
Semicolon radial RADIAL;C1;C2 Radial gradient
Semicolon path PATH;C1;C2 Path gradient
Radial gradient radial:C1-C2[-focus] Focus: tl, tr, bl, br, center
Three-stop C1-C2-C3 Three gradient stops
Image image:/path/to/file.png Image background
Clear none / transparent / clear Remove background

Transition Format

Format: TYPE[-DIRECTION][-SPEED|DURATION] or none

Types: fade, cut, dissolve, wipe, push, cover, pull, split, zoom, wheel, blinds, checker, comb, bars, strips, circle, diamond, newsflash, plus, random, wedge, flash, honeycomb, vortex, switch, flip, ripple, glitter, prism, doors, window, shred, ferris, flythrough, warp, gallery, conveyor, pan, reveal, box, uncover

Morph: morph (byObject), morph-byWord, morph-byChar

Note: Morph transitions auto-prefix shape names with !! to enable morph matching between slides.

Office 2010+ transitions: vortex, switch, flip, ripple, glitter, prism, flash, and honeycomb are wrapped in mc:AlternateContent for compatibility with older PowerPoint versions.

switch / flip directions: These transitions accept left or right direction (e.g. transition=switch-left, transition=flip-right).

Directions: left, right, up, down, in, out, horizontal, vertical

Speed: slow, medium, fast, or milliseconds

Examples

# Set solid background
officecli set slides.pptx /slide[1] --prop background=1A1A2E

# Set gradient background
officecli set slides.pptx /slide[1] --prop "background=4472C4-1A1A2E"

# Set image background
officecli set slides.pptx /slide[1] --prop background=image:bg.jpg

# Set transition
officecli set slides.pptx /slide[1] --prop transition=fade
officecli set slides.pptx /slide[1] --prop transition=wipe-left
officecli set slides.pptx /slide[1] --prop transition=zoom-out-slow

# Set morph transition
officecli set slides.pptx /slide[2] --prop transition=morph
officecli set slides.pptx /slide[2] --prop transition=morph-byWord
officecli set slides.pptx /slide[2] --prop transition=morph-byChar

# Set switch transition with direction
officecli set slides.pptx /slide[1] --prop transition=switch-left

# Set morph with advance timing
officecli set slides.pptx /slide[2] --prop transition=morph --prop advanceTime=3000 --prop advanceClick=true

# Set auto-advance
officecli set slides.pptx /slide[1] --prop advanceTime=5000 --prop advanceClick=true

# Set speaker notes
officecli set slides.pptx /slide[1] --prop notes="Discuss Q4 revenue growth"

# Align shapes to slide center
officecli set slides.pptx /slide[1] --prop align=slide-center --prop targets=shape[1],shape[2]

# Distribute shapes horizontally
officecli set slides.pptx /slide[1] --prop distribute=horizontal --prop targets=shape[1],shape[2],shape[3]

Based on OfficeCLI v1.0.11

Clone this wiki locally