Custom Slides

This plugin allows you to customize the Slides Obsidian core plugin.

[!NOTE] You must have the Slides core plugin enabled for this plugin to work.

Features

• Customizable Navigation Controls: Toggle the visibility of left, right, up, and down navigation arrows to remove visual clutter from your presentations.
• Transition Effects: Choose from multiple slide transition effects: none, fade, slide horizontal, or slide vertical.
• Progress Bar Customization: Adjust the height of the progress bar to suit your aesthetic preferences, with a default of 10 pixels (up from the default 3 pixels).
• Left-Align Lists: Enable left-aligned bulleted and numbered lists in presentation mode for a cleaner, more readable layout, with a 1em left margin for proper spacing.
• Immediate Keyboard Input: Automatically switches to reading mode when entering Slides mode so spacebar and arrows work without having to click your presentation, and restores your previous mode (e.g., edit or source) when exiting.
• Custom Font Support: Use the text font settings specified in your Obsidian settings.
• Footer Text: Display configurable text at the bottom of every slide except the title slide. Set via "Footer text" in settings; leave empty to disable. Uses plain text (no HTML) and adapts color automatically for dark themes.
• Slide Numbers: Show a slide number on each slide, excluding the title slide. Numbers start at 1 for the second slide. Position is configurable: bottom-left (default) or bottom-right. The position dropdown only appears when slide numbers are enabled.
• Auto-Fit Slides: Automatically shrinks overflowing slide content to fit the viewport using CSS zoom, preserving layout and backgrounds. Enabled by default; can be toggled off in settings.
• Mobile Support: Works on iPad and other mobile devices with sensible touch-friendly defaults (navigation arrows shown by default on mobile).

Installation

Community Plugins Search

1. In Obsidian, go to Settings > Community plugins (enable it if you haven't already).
2. Search for Custom Slides and click Install and then Enable.

Manual

1. Download the latest release from the Releases page and navigate to your Obsidian vault's .obsidian/plugins/ directory.
2. Create a new folder called custom-slides and ensure manifest.json, main.js, and styles.css are in there.
3. In Obsidian, go to Settings > Community plugins (enable it if you haven't already) and then enable "Custom Slides."

Usage

1. Enable the Plugin: Activate it in the Community Plugins settings.
2. Configure Settings: Use the settings tab to toggle navigation arrow visibility, set the progress bar height, choose transition effects, enable left-aligned lists, set footer text, enable slide numbers, and configure auto-fit behavior.
3. Start a Presentation: Open a note with Slides-compatible Markdown (e.g., using --- for slides) and use the "Slides: Start Presentation" command from the Command Palette.
4. Using Keys for Navigation: You can use the spacebar and arrow keys to go between slides as normal and the ESC key will exit your presentation.

Keyboard Shortcuts (with WASD Navigation enabled)

Contributing

Feel free to submit issues or pull requests on the Git repository where you manage this plugin. Contributions to enhance functionality or fix bugs are welcome!