Skip to content

rajtilakjee/kivo

Repository files navigation

Kivo

GitHub release (with filter)   GitHub License   GitHub Repo stars   GitHub forks   GitHub repo size

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.1.0)


kivo-demo.mp4

Features

  • Frameless, always-on-top overlay
  • Modern rounded UI with a translucent background
  • Draggable window
  • Open any text (.txt) file
  • Automatically reloads when the file changes
  • Smooth teleprompter-style auto-scrolling
  • Adjustable scrolling speed
  • Pause and resume scrolling
  • Lightweight and distraction-free

Keyboard Shortcuts

Shortcut Action
Esc Close Kivo
Space Pause / Resume scrolling
Increase scrolling speed
Decrease scrolling speed

Installation

Clone the repository:

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

Install the dependencies:

pip install -r requirements.txt

Run the application:

python main.py

Building

Create a standalone executable using PyInstaller:

pyinstaller --onefile --windowed --name Kivo main.py

The executable will be generated inside the dist/ directory.


Star History

Star History Chart

Roadmap

  • Settings window
  • Global hotkeys
  • Remember last opened file
  • Font customization
  • Adjustable opacity
  • Scroll speed presets
  • Mirror mode
  • Multiple themes
  • Custom teleprompter rendering
  • Cross-platform releases

Tech Stack

  • Python 3
  • PySide6 (Qt for Python)

License

This project is licensed under the MIT License.

About

A lightweight desktop teleprompter.

Topics

Resources

License

Code of conduct

Contributing

Stars

46 stars

Watchers

0 watching

Forks

Sponsor this project

 

Contributors

Languages