automating-powerpoint

Automating PowerPoint (JXA-first, AppleScript discovery)

Relationship to the macOS automation skill

• Standalone for PowerPoint, aligned with automating-mac-apps patterns.
• Use automating-mac-apps for permissions, shell, and UI scripting guidance.

Core Framing

• PowerPoint dictionary is AppleScript-first; discover there.
• JXA provides logic, data handling, and ObjC bridge access.
• Objects are specifiers; read via methods, write via assignments.
• Prerequisites: PowerPoint with Accessibility permissions, basic JXA/AppleScript knowledge.

Workflow (default)

1. Discover dictionary terms in Script Editor (PowerPoint).
2. Prototype minimal AppleScript commands.
3. Port to JXA and add defensive checks.
4. Use explicit enums for save/export formats.
5. Use Excel interop for robust charting.

Quick Start Example

Create a new presentation with a title slide:

const powerpoint = Application('Microsoft PowerPoint');
const doc = powerpoint.documents[0] || powerpoint.documents.add();
const slide = doc.slides.add({index: 1, layout: powerpoint.slideLayouts['ppLayoutTitle']});
slide.shapes[0].textFrame.textRange.content = 'My Presentation';
doc.save({in: Path('/Users/username/Desktop/presentation.pptx')});

Troubleshooting

• Application not responding: Ensure PowerPoint is launched and accessible via Accessibility permissions.
• Dictionary discovery fails: Open PowerPoint manually first, then retry Script Editor.
• Export errors: Verify file paths exist and use absolute paths; check enum values match PowerPoint's export constants.
• Interop issues: Confirm Excel is installed and both applications have proper permissions.

Validation Checklist

• PowerPoint launches and responds to JXA commands
• Presentation creation succeeds with expected slides
• Shape/text manipulation renders correctly
• Export produces valid output files
• Enum values match PowerPoint dictionary constants
• Error handling covers missing app/permissions