Kivo

       

A lightweight desktop teleprompter built with PySide6.

Kivo provides a clean, always-on-top reading overlay for scripts, AI-generated content, presentations, and video recordings.

Status: 🚧 MVP (v0.2.0)

---

kivo-demo.mp4

Features

• Frameless, always-on-top glass overlay
• Header with script name, live/paused state, and speed
• Draggable and resizable window
• Open .txt or .md files, with Ctrl+O to switch scripts
• Reloads automatically when the file changes
• Smooth teleprompter-style auto-scrolling
• Click or drag the progress bar to jump
• Adjustable scroll speed, font size, and opacity
• Remembers window size, speed, font, and opacity
• Hidden from screen sharing in Meet, Zoom, Teams, and similar apps
• Lightweight and distraction-free

---

Keyboard Shortcuts

Shortcut	Action
? / H / F1	Show or hide controls
Esc	Close help, or close Kivo
Space	Pause / Resume scrolling
↑ / ↓	Increase / decrease speed
← / →	Skip backward / forward
+ / -	Increase / decrease font size
[ / ]	Decrease / increase opacity
R	Restart from the top
Ctrl+O	Open another script
Ctrl+Scroll	Change font size
Scroll	Nudge the script

---

Installation

Install uv, then clone the repository:

git clone https://github.com/rajtilakjee/kivo.git
cd kivo

Sync the environment and run the application:

uv sync
uv run python main.py

---

Building

Create a standalone executable using PyInstaller:

uv sync --group dev
uv run pyinstaller --onefile --windowed --name Kivo main.py

The executable will be generated inside the dist/ directory.

---

Development

uv sync --group dev
uv run ruff check .
uv run python main.py

---

Star History

---

Roadmap

• Settings window
• Global hotkeys
• Reopen the last script on launch
• Font family picker
• Scroll speed presets
• Mirror mode
• Multiple themes
• Custom teleprompter rendering
• Cross-platform releases

---

Tech Stack

• Python 3.10+
• PySide6 (Qt for Python)
• uv for environments and dependencies

---

License

This project is licensed under the MIT License.