-
Notifications
You must be signed in to change notification settings - Fork 517
ppt slide set
Modify slide properties including background, transition, advance timing, and speaker notes.
Path: /slide[N]
| 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 |
layout |
layout name | Change slide layout (e.g., Title and Content, titleOnly, blank) |
align |
alignment value | Align shapes on slide |
distribute |
horizontal, vertical
|
Distribute shapes evenly |
hidden |
bool | Hide the slide from playback (sets sld@show=0). query 'slide[hidden=true]' filters hidden slides. |
showFooter |
bool | Show the footer placeholder on this slide |
showSlideNumber |
bool | Show the slide number placeholder |
showDate |
bool | Show the date/time placeholder |
showHeader |
bool | Show the header placeholder |
- 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.
| 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 |
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, andhoneycombare wrapped inmc:AlternateContentfor compatibility with older PowerPoint versions.
switch/flipdirections: These transitions acceptleftorrightdirection (e.g.transition=switch-left,transition=flip-right).
Directions: left, right, up, down, in, out, horizontal, vertical
Speed: slow, medium, fast, or milliseconds
# 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.64