A professional open-source web-based teleprompter application with controller-display separation for presentations, video recording, and public speaking.

✨ Available in Eyevinn Open Source Cloud - Try Open Teleprompter instantly without installation at app.osaas.io

Open Teleprompter provides a complete solution for professional teleprompter needs, featuring real-time synchronization between controller and display interfaces, manuscript formatting, scheduled broadcasts, and Docker deployment support.

The controller provides comprehensive management of your teleprompter session:

The clean, distraction-free display optimized for teleprompter use:

• Controller-Display Architecture: Separate interfaces connected via WebSocket
• Manuscript Upload: Support for text files (.txt) and Word documents (.docx)
• Manuscript Formatting: Professional teleprompter formatting options
• Configurable Speed: Adjustable reading speed from 60-300 words per minute
• Segment Timing: Set custom segment lengths with countdown timer
• Scheduled Start: Set future start times with countdown display
• Duration Calculations: Real-time calculation of expected reading time vs. segment length
• On-Air Indicator: Visual indicator with automatic activation
• Professional Interface: Dark theme optimized for teleprompter use
• Live Text Editing: Edit text directly in the controller
• Auto-scrolling: Smooth text scrolling based on reading speed
• Playback Controls: Start, pause, and reset functionality
• Multiple Displays: Support for multiple synchronized displays
• Mirror Mode: For use with teleprompter hardware
• Fullscreen Support: F11 or F key for fullscreen mode

1. Install Dependencies:

   npm install

2. Start the Server:

   npm start

3. Access the Application:

   • Controller: http://localhost:8080/controller.html
   • Display: http://localhost:8080/display.html

1. Build the Docker Image:

   docker build -t open-teleprompter .

2. Run the Container:

   docker run -p 8080:8080 open-teleprompter

3. Access the Application:

   • Controller: http://localhost:8080/controller.html
   • Display: http://localhost:8080/display.html

PORT=3000 npm start

docker run -p 3000:3000 -e PORT=3000 open-teleprompter

1. Open the Controller: Navigate to /controller.html to configure and control the teleprompter
2. Open the Display: Navigate to /display.html for the clean teleprompter display
3. Load Content: Upload a manuscript file or type/paste text directly in the controller
4. Configure Settings:
   • Set your reading speed (words per minute)
   • Configure segment length (minutes and seconds)
   • Set scheduled start time (optional)
   • Adjust font size for optimal readability
   • Enable mirror mode for teleprompter hardware
   • Toggle on-air indicator
5. Monitor Duration: Check the word count and expected duration vs. your segment length
6. Start Prompting: Click Start to begin auto-scrolling text (on-air indicator activates automatically)
7. Control Playback: Use Pause/Resume and Reset as needed

open-teleprompter/
├── server.js           # Node.js WebSocket server
├── package.json        # Node.js dependencies
├── controller.html     # Controller interface
├── controller.css      # Controller styling
├── controller.js       # Controller functionality
├── display.html        # Teleprompter display
├── display.css         # Display styling
├── display.js          # Display functionality
├── Dockerfile          # Docker configuration
├── .dockerignore       # Docker ignore rules
├── README.md           # This file
└── .gitignore         # Git ignore rules

• Node.js Backend: WebSocket server for real-time communication
• WebSocket Communication: Real-time synchronization between controller and displays
• State Management: Server-side state management for multiple clients
• Mammoth.js: Used for Word document parsing
• Responsive Design: Works on desktop and mobile devices
• Docker Support: Containerized deployment ready

• PORT: Server port for both HTTP and WebSocket (default: 8080)
• NODE_ENV: Node.js environment (default: production in Docker)

• Chrome/Chromium (recommended)
• Firefox
• Safari
• Edge

We welcome contributions to Open Teleprompter! Please see our contribution guidelines for more information.

Join our community on Slack where you can post any questions regarding any of our open source projects. Eyevinn's consulting business can also offer you:

• Further development of this component
• Customization and integration of this component into your platform
• Support and maintenance agreement
• Training

Contact sales@eyevinn.se if you are interested.

Eyevinn Technology is an independent consultant firm specialized in video and streaming. Independent in a way that we are not commercially tied to any platform or technology vendor. As our way to innovate and push the industry forward we develop proof-of-concepts and tools. The things we learn and the code we write we share with the industry in blogs and by open sourcing the code we have written.

Want to know more about Eyevinn and how it is to work here. Contact us at work@eyevinn.se!

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

Copyright 2025 Eyevinn Technology AB