Skip to content

0.1.1

Latest

Choose a tag to compare

@github-actions github-actions released this 21 Jun 23:59
· 25 commits to main since this release
e3fd376

pmptr v0.1.1

A minimal virtual teleprompter that lives as a transparent, always-on-top, click-through overlay on your screen.

pmptr is a tiny Electron app for presenters, streamers, and anyone who needs to read a script while keeping their hands free. Paste your text into the control panel, open the floating prompter, and it floats over your screen, browser, or video call while you keep working underneath it.

Install

The easiest way to get pmptr is through npm (requires Node.js 20+):

npm install -g pmptr
pmptr

Then click Open floating prompter in the control window.

Prefer a native installer? See the Downloads section below.

Features

  • 🪟 Transparent, always-on-top overlay - a frameless floating window that stays above everything on your screen.
  • 🔒 True OS-level click-through - lock the prompter and clicks/wheel events fall straight through to whatever app is behind it. Keep using your mouse while the script keeps scrolling.
  • 🎛️ Control panel - paste your script and tune speed, font size, colors, opacity, mirror mode, and window dimensions.
  • Live updates - every edit in the control panel applies to the prompter instantly, no restart needed.
  • 💾 Persistent settings - your preferences are saved to disk in your Electron user-data folder.
  • ⌨️ Keyboard shortcuts - play/pause, reset, speed, and click-through toggle without leaving the prompter window.
Key Action
Space Play / pause
R Reset scroll to the top
/ Speed ± 5 px/s
L Toggle click-through (lock / unlock)
Esc Close the prompter

What's New in v0.1.1

  • Published pmptr to npm - install the app globally with npm install -g pmptr.
  • fix: moved electron to peerDependencies so the npm package is compatible with electron-builder and installs cleanly alongside a local Electron install.

This is the first release shipped to the npm registry; the v0.1.0 line was only available as platform installers.

Downloads

Prefer a native installer? Choose the appropriate build for your platform:

🐧 Linux

  • pmptr-0.1.1.AppImage - Universal Linux binary (recommended)
    • Make it executable: chmod +x pmptr-0.1.1.AppImage
    • Run: ./pmptr-0.1.1.AppImage
  • pmptr_0.1.1_amd64.deb - Debian/Ubuntu package
    • Install: sudo dpkg -i pmptr_0.1.1_amd64.deb

🍎 macOS

  • pmptr-0.1.1-arm64.dmg - Apple Silicon (M1/M2/M3)
    • Open the DMG and drag pmptr to Applications
    • First launch: Right-click → Open (to bypass Gatekeeper)

🪟 Windows

  • pmptr-Setup-0.1.1.exe - 64-bit Windows installer
    • Run the installer and follow the prompts
    • Windows SmartScreen: Click "More info" → "Run anyway"

System Requirements

  • Linux: glibc 2.31+, X11 or Wayland with XWayland
  • macOS: 10.15 (Catalina) or later
  • Windows: Windows 10 (1809) or later

Beta - pmptr is in active beta and not code-signed. Your OS may warn on first
launch. Wayland click-through/always-on-top support varies by compositor; on macOS you
may need to grant Accessibility / Screen Recording permissions for full click-through.

Reporting Issues

Found a bug or have a feature idea? Please report it on our
GitHub Issues page.


Full Changelog: v0.1.0...v0.1.1