|
1 | 1 | # Keynote Progress Bar<a id="Keynote-Progress-Bar"></a> |
2 | 2 |
|
3 | | -This AppleScript program adds a customizable progress bar to presentations created with Apple Keynote. The progress bar is configured using commands placed in the presenter notes of your slides. This project utilizes a custom Objective-C framework, `KeynoteProgressBarHelper`, for generating vector graphics (PDF) images of the progress bar. |
| 3 | +**Keynote Progress Bar** is a macOS app that adds a customizable dot-based progress bar to your Apple Keynote presentations. Configuration is done directly in the presenter notes of your slides — no separate file needed. The app is signed and notarized by Apple, so it installs and runs without Gatekeeper warnings. |
| 4 | + |
| 5 | +Two versions are available — pick the one matching your Keynote installation: |
| 6 | + |
| 7 | +| Version | For | |
| 8 | +|---|---| |
| 9 | +| [Download for Keynote Creator Studio](https://github.com/alberti42/Keynote-Progress-Bar/releases/latest/download/Add_Progress_Bar_to_Keynote_Studio.dmg) | The current Keynote app (macOS 13+) | |
| 10 | +| [Download for legacy Keynote](https://github.com/alberti42/Keynote-Progress-Bar/releases/latest/download/Add_Progress_Bar_to_Keynote_Legacy.dmg) | Older Keynote versions | |
4 | 11 |
|
5 | 12 |  |
6 | 13 |
|
7 | | -Download the Keynote presentation [example](https://github.com/alberti42/Keynote-Progress-Bar/raw/main/Docs/Examples/Example-Keynote-Progress-Bar.key), where the _Keynote Progress Bar_ has already been embedded. You only need Keynote to open the presentation and evaluate how the _Keynote Progress Bar_ looks. No other installation is required for a first look. Alternatively, you can download the [PDF](https://github.com/alberti42/Keynote-Progress-Bar/raw/main/Docs/Examples/Example-Keynote-Progress-Bar.pdf) export of the Keynote presentation. |
| 14 | +To see what the progress bar looks like before installing, download the Keynote [example presentation](https://github.com/alberti42/Keynote-Progress-Bar/raw/main/Docs/Examples/Example-Keynote-Progress-Bar.key) — it already has the progress bar embedded and only requires Keynote to open. A [PDF export](https://github.com/alberti42/Keynote-Progress-Bar/raw/main/Docs/Examples/Example-Keynote-Progress-Bar.pdf) is also available. |
8 | 15 |
|
9 | 16 | ## 1. Table of Contents<a id="toc"></a> |
10 | 17 |
|
@@ -48,23 +55,27 @@ Download the Keynote presentation [example](https://github.com/alberti42/Keynote |
48 | 55 |
|
49 | 56 | There are two installation options: |
50 | 57 |
|
51 | | -- **Option A (recommended):** Download the pre-built, **signed and notarized** app from the latest GitHub release (no Xcode required). |
52 | | -- **Option B:** Build the framework yourself and run the AppleScript from Script Editor / as a `.scpt` (developer workflow). |
| 58 | +- **Option A (recommended):** Download the pre-built, signed and notarized app — no Xcode or developer tools required. |
| 59 | +- **Option B:** Build from source (developer workflow). |
53 | 60 |
|
54 | 61 | ### Option A — Download the notarized app (recommended) |
55 | 62 |
|
56 | | -1. Download the latest notarized DMG from GitHub Releases: |
| 63 | +1. Download the DMG matching your Keynote version: |
| 64 | + |
| 65 | + | Your Keynote | Download | |
| 66 | + |---|---| |
| 67 | + | Keynote Creator Studio (current) | [Add_Progress_Bar_to_Keynote_Studio.dmg](https://github.com/alberti42/Keynote-Progress-Bar/releases/latest/download/Add_Progress_Bar_to_Keynote_Studio.dmg) | |
| 68 | + | Legacy Keynote | [Add_Progress_Bar_to_Keynote_Legacy.dmg](https://github.com/alberti42/Keynote-Progress-Bar/releases/latest/download/Add_Progress_Bar_to_Keynote_Legacy.dmg) | |
57 | 69 |
|
58 | | - **Direct download:** |
59 | | - https://github.com/alberti42/Keynote-Progress-Bar/releases/latest/download/Add_Progress_Bar_to_Keynote.dmg |
| 70 | + Not sure which version you have? Open Keynote, go to **Keynote → About Keynote**. Version 15 and later is Keynote Creator Studio; version 14.5 and earlier is legacy Keynote. |
60 | 71 |
|
61 | | -2. Open the DMG and drag **Add Progress Bar to Keynote.app** into `/Applications` (or any other folder you like). |
| 72 | +2. Open the DMG and drag **Add Progress Bar to Keynote.app** into `/Applications` (or any folder you like). |
62 | 73 |
|
63 | | -3. On first launch, macOS will ask for permission to control Keynote (Automation permission). Please allow it. |
| 74 | +3. On first launch, macOS will ask for permission to control Keynote (Automation). Please allow it. |
64 | 75 |
|
65 | 76 | 4. Open your Keynote presentation and run **Add Progress Bar to Keynote.app**. |
66 | 77 |
|
67 | | -> **Note:** The app is signed with a Developer ID and notarized by Apple. Gatekeeper should accept it without warnings. If macOS blocks the app anyway, right-click the app and choose **Open** the first time you launch it. |
| 78 | +> **Note:** The app is signed with a Developer ID and notarized by Apple. Gatekeeper will accept it without warnings. |
68 | 79 |
|
69 | 80 | --- |
70 | 81 |
|
|
0 commit comments