nprompter

A browser-based web teleprompter powered by Notion as a backend for editing and storing scripts.

Read the full documentation: https://nprompter.org/

Key Features

📝 Write in Notion: Draft and update scripts in your existing Notion workspace.
📺 Browser Teleprompter: High-contrast, smooth auto-scrolling with horizontal mirroring for teleprompter glass.
🎛️ Full Keyboard & Remote Control: Adjust speed, font size, padding, line height, or jump to top with keyboard or wireless presenter remotes (clickers).
🏷️ Director Cues & Formatting: Hide private stage notes via custom colors or brackets ([...]), and ignore footnotes after dividers (---).
📚 Multi-Database Support: Aggregate scripts across multiple Notion databases with customized filtering and sorting.
📱 Installable PWA: Offline-ready Progressive Web App with local settings persistence.

Install nprompter using pip or uv:

pip install nprompter

export NOTION_API_KEY="secret_..."

(See the Notion Integration Guide to learn how to create your token and share your database).

Build the static teleprompter files for a Notion database:

nprompter build [DATABASE_ID]

Start a local web server and open the teleprompter directly in your browser:

nprompter serve

nprompter build [DATABASE_ID] [OPTIONS]: Fetch pages and render the HTML teleprompter website.
nprompter serve [PORT] [DIRECTORY]: Serve the generated files locally (default port: 8889).
nprompter create-config: Generate a customizable nprompter.toml configuration file.

Key	Action
`Space` / `F5`	Start / Pause auto-scrolling
`→` / `←`	Adjust scroll speed
`Q` / `W`	Decrease / Increase font size
`M`	Mirror screen (horizontal flip for glass reflection)
`F`	Fullscreen mode
`H`	Show keyboard shortcuts help modal

See the Keyboard Controls & Remote Guide for all available shortcuts.

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution for nprompter 4.4.3
File	Size	Uploaded
nprompter-4.4.3.tar.gz	109.5 kB	Aug 31, 2026	Details

Table of built distributions (wheels) for nprompter 4.4.3
File	Interpreter	ABI	Platform	Reset
nprompter-4.4.3-py3-none-any.whl 112.6 kB Aug 31, 2026	Python 3	none	any	Details

Total release size: 222.0 kB

Download URL	nprompter-4.4.3.tar.gz
Size	109.5 kB
Tags	Source
SHA-256 checksum How to use checksums	`5ed846c5cb66051546674d13d518a908c51a234c00c96e6e79d4b5a625dc039f`
BLAKE2b-256 checksum How to use checksums	`7c103e0e368bd78b3b5b810faa47d79e03ea1bebe8cd0d6106816e13f906fe0e`
Upload date	Aug 31, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`uv/0.12.7 {"installer":{"name":"uv","version":"0.12.7","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}`

Download URL	nprompter-4.4.3-py3-none-any.whl
Size	112.6 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`9f1f2c99508051ddd0a6ab8e3e7517e4c8c1d1ca2cd885b9edbd97e9dffd3c14`
BLAKE2b-256 checksum How to use checksums	`c0747c606be27ee21ae80657c40f5db68dbfcb6ad7468e06ac93bb395cbb7bee`
Upload date	Aug 31, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`uv/0.12.7 {"installer":{"name":"uv","version":"0.12.7","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}`