Omahub
← All plugins
S

OmTeleprompt

by seyhunakyurek

Teleprompter for interviewers and streamers with word tracking, voice activation, and pause-on-speak.

GitHub

Security review

Review recommended · 3 findings

Deterministic scan — not a security guarantee

Low
Risk level
Low
Analyzed commit
9a35865
Scanned
1 month ago

Flagged patterns appear only in documentation files (README / docs) — descriptive examples, not executable code.

  • Docs package_manager README.md:39

    System-wide Python package installation (not --user).

    pip install sounddevice
  • Docs sudo README.md:36

    Command runs with sudo, elevating the process beyond the plugin environment.

    sudo pacman -S python-pyaudio
  • Docs sudo README.md:42

    Command runs with sudo, elevating the process beyond the plugin environment.

    sudo pacman -S alsa-utils

Automated analysis only — not a security guarantee.

AI advisory review

No obvious issues detected

Language-model assessment · ~deepseek/deepseek-v4-flash-latest — advisory only

Low
AI risk level
Low
Recommendation
install
Model
~deepseek/deepseek-v4-flash-latest
Analyzed commit
9a35865
Reviewed
1 month ago

The plugin is a teleprompter widget with optional voice activation. It runs a Python script for VAD that uses standard audio tools (parecord/arecord) and does not perform any network, file, or privilege-escalation actions beyond normal widget behavior. The deterministic scan flagged sudo/pip commands in the README, but those are only documentation for optional dependencies and are not executed by the plugin itself.

  • The README contains sudo pacman and pip install commands for optional audio backends, but these are user instructions, not part of the plugin's runtime behavior.
How this check works

This review combines the deterministic scan (the rule-based results above) with an independent look at the plugin's code by a language model. The model reads a trimmed sample of the repository's files, the manifest, and the README, then gives a plain-language risk level and a recommendation: install (no notable danger), review (look closer first), or avoid (clearly dangerous).

It runs on the same analyzed commit as the deterministic scan and is strictly advisory — it is not a security guarantee and never blocks a plugin by itself. A human moderator still reviews plugins before they are listed.

AI advisory only — automated analysis, not a security guarantee.

Install
$ omarchy plugin add https://github.com/seyhunak/omteleprompt --enable
Productivity #bar

OmTeleprompt

OmTeleprompt

A teleprompter for Omarchy Linux — built for interviewers and streamers, with word tracking, voice activation, and pause-on-speak.

Install

omarchy plugin add https://github.com/seyhunak/omteleprompt.git --enable

Usage

  1. Click the 📝 icon in your Omarchy bar to open OmTeleprompt
  2. Click ✏️ Edit and paste or type your script
  3. Click 📖 Read Mode to start the teleprompter
  4. Use ▶ Play to start auto-scrolling
  5. Enable 🎤 Voice On to activate pause-on-speak
  6. Use the Notes panel to write while the teleprompter is running

Voice Activation

Voice activation uses real-time audio analysis to detect when you're speaking. When enabled:

  • The teleprompter automatically pauses when you speak
  • A green indicator shows "Listening" when ready
  • A red indicator shows "Speaking..." when voice is detected
  • The teleprompter resumes when you stop speaking

Dependencies

Voice activation requires one of these Python audio backends:

# Option 1: PyAudio (recommended)
sudo pacman -S python-pyaudio

# Option 2: sounddevice
pip install sounddevice

# Option 3: arecord (usually pre-installed on Arch/Hyprland systems)
sudo pacman -S alsa-utils

If no backend is available, the teleprompter will still work in manual mode.

Configure

# Move the widget in your bar
omarchy bar move io.github.seyhunakyurek.omteleprompt --section center

# Change settings
omarchy bar set io.github.seyhunakyurek.omteleprompt fontSize 40 --json
omarchy bar set io.github.seyhunakyurek.omteleprompt scrollSpeed 1.5 --json
omarchy bar set io.github.seyhunakyurek.omteleprompt voiceEnabled true --json
omarchy bar set io.github.seyhunakyurek.omteleprompt vadThreshold 400 --json

Remove

omarchy plugin remove io.github.seyhunakyurek.omteleprompt

Keyboard Shortcuts

  • Escape: Close the teleprompter panel
  • Tab: Switch between panels (when multiple are open)

Troubleshooting

  • Voice not working: Install python-pyaudio or sounddevice Python packages
  • Panel won't open: Run omarchy-shell shell rescanPlugins
  • Text not scrolling: Make sure you have words in the script editor
  • Permission denied: Ensure bin/vad.py is executable

License

MIT