How laguna821/achmage-slides-ultra works
Achmage Slides Ultra is an Obsidian plugin that turns Markdown notes into live, layout-aware 1920×1080 slide decks and exports them as self-contained HTML or MP4. The main workflow reads a note, renders and measures its content, splits or adjusts slides to prevent overflow, then presents the deck or exports it. The graph preserves documented themes, typography, settings, navigation, and video stages. Some implementation is unsampled; edges reflect shown imports/calls or README statements, not inferred wiring.
Main entry points: videoExportService.ts Video Export Service · slideRenderer.ts Slide Renderer · main.ts Plugin Entry · auditLoop.ts Overflow Audit
Components 24
Obsidian Plugin
- Plugin Entry
src/main.ts - Plugin Settings
src/settings.ts - Slide Preview
src/view/slidePreviewView.ts - HTML Deck
src/main.ts
Slide Rendering
- Slide Renderer
src/engine/slideRenderer.ts - Marp Engine
src/engine/marpEngine.ts - Themes and Fonts
src/themes/themeRegistry.ts - Note Compatibility
src/preprocessor/frontmatterInjector.ts
Layout and Audit
- Shape Layouts
src/preprocessor/shapeTemplates.ts - Overflow Splitter
src/preprocessor/overflowSplitter.ts - Content Measurement
src/preprocessor/pretextMeasurer.ts - Text Metrics
src/measurement/PretextMeasurementEngine.ts - Overflow Audit
src/audit/auditLoop.ts - Overflow Probe
src/audit/overflowProbe.ts
Video Export
- Export Controls
src/video/videoExportModal.ts - Video Export Service
src/video/videoExportService.ts - Audited Video Artifact
src/video/videoArtifact.ts - Video Timeline
src/video/videoTimeline.ts - Frame Compositor
src/video/videoCompositor.ts - H.264 Encoder
src/video/videoEncoder.ts - Output Transaction
src/video/videoOutputPath.ts
Other components
- Note Author
- Obsidian
- Local Filesystem
Connections 30
- Note Author → Obsidian: opens note
README.md - Obsidian → Plugin Entry: activates plugin
README.md - Plugin Entry → Plugin Settings: configures
src/main.ts - Plugin Entry → Slide Preview: opens preview
src/main.ts - Slide Preview → Slide Renderer: renders note
src/view/slidePreviewView.ts - Plugin Entry → Slide Renderer: creates renderer
src/main.ts - Slide Renderer → Note Compatibility: prepares Markdown
src/engine/slideRenderer.ts - Slide Renderer → Marp Engine: renders slides
src/engine/slideRenderer.ts - Marp Engine → Themes and Fonts: registers themes
src/engine/marpEngine.ts - Slide Renderer → Shape Layouts: applies layouts
src/engine/slideRenderer.ts - Slide Renderer → Overflow Splitter: splits overflow
src/engine/slideRenderer.ts - Overflow Splitter → Content Measurement: measures blocks
src/preprocessor/overflowSplitter.ts - Content Measurement → Text Metrics: measures text
src/preprocessor/pretextMeasurer.ts - Slide Preview → Overflow Audit: audits preview
src/view/slidePreviewView.ts - Overflow Audit → Slide Renderer: rerenders corrections
src/audit/auditLoop.ts - Overflow Audit → Overflow Probe: probes overflow
src/audit/auditLoop.ts - Plugin Entry → HTML Deck: exports HTML
README.md - Obsidian → Export Controls: opens MP4 export
README.md - Export Controls → Video Export Service: starts export
src/video/videoExportModal.ts - Video Export Service → Slide Renderer: renders source deck
src/video/videoExportService.ts - Video Export Service → Overflow Audit: audits slides
src/video/videoExportService.ts - Video Export Service → Audited Video Artifact: builds snapshot
src/video/videoExportService.ts - Audited Video Artifact → Overflow Audit: checks overflow
src/video/videoArtifact.ts - Video Export Service → Video Timeline: sets hold time
src/video/videoExportService.ts - Video Export Service → Frame Compositor: composes frames
src/video/videoExportService.ts - Frame Compositor → Video Timeline: uses timing
src/video/videoCompositor.ts - Video Export Service → H.264 Encoder: encodes video
src/video/videoExportService.ts - H.264 Encoder → Output Transaction: publishes file
src/video/videoEncoder.ts - Video Export Service → Output Transaction: commits output
src/video/videoExportService.ts - Output Transaction → Local Filesystem: writes locally
README.md