Telepathy Subs is a lightweight macOS utility that displays clean, floating subtitles while you watch YouTube videos in Safari.
It extracts captions in real time and shows them in a resizable, movable overlay so nothing on your screen is ever blocked.
- Real‑time subtitle extraction from the active YouTube tab in Safari
- Floating subtitle bar with customizable size, opacity, edge‑snap, and position
- Switch instantly between original captions and translated text
- Automatic syncing with the currently playing video
- Runs fully locally — no data is ever sent anywhere
- Minimal and unobtrusive — designed to stay out of the way
| Shortcut | Action |
|---|---|
| ⌃ ⇧ L | Lock / unlock subtitle window position |
| ⌃ ⇧ P | Pin / unpin the window |
| ⌃ ⇧ F | Toggle background |
| ⌃ ⇧ O | Toggle text outline |
| ⌃ ⇧ C | Switch between light / dark text |
| ⌃ ⇧ N | Switch between original / translated subtitles |
Double‑click inside the subtitle window to reset its size and position.
Telepathy Subs can optionally integrate with local language model tools for enhanced subtitle translation. This integration is optional and not required for the primary subtitle overlay functionality, but it can improve the experience when videos provide limited caption language options.
Telepathy Subs works best with standard YouTube video pages in Safari.
Different layouts or experimental features may affect behavior, and compatibility will continue improving over time.
Telepathy Subs is designed to provide stable, quiet assistance.
Updates are released as necessary to maintain smooth operation with surrounding systems.
- If subtitles do not appear, verify the YouTube tab is active and video captions are available.
- Reloading the page often helps if YouTube has applied a new experimental layout.
- Reset the subtitle window with a double‑click inside it.
If you need help, want to report an issue, or have suggestions, feel free to open an Issue:
👉 https://github.com/YourName/telepathy-subs-support/issues
MIT License.
See the LICENSE file for details.