Omahub
← All plugins
D

Prompter

by Dominic Boettger

Elgato Prompter control center for Omarchy. Eye-contact mirroring for video calls (your 4K screen share stays untouched), a native theme-aware teleprompter with markdown scripts, meeting autopilot, hotplug profiles per monitor setup, Stream Deck / keybinding control via IPC, and a setup doctor that automates the DisplayLink driver install.

GitHub

Security review

Potentially dangerous behavior detected · 3 findings

Deterministic scan — not a security guarantee

High
Risk level
High
Analyzed commit
7d7af69
Scanned
1 month ago
  • high persistence Model.js:370

    Registers scheduled or boot-time system tasks.

    systemctl enable --now displaylink.service"
  • medium sudo Model.js:359

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

    sudo can prompt. The runtime
  • medium sudo Model.js:370

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

    sudo systemctl enable --now displaylink.service"

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
7d7af69
Reviewed
1 month ago

The plugin is a legitimate Elgato Prompter control center. The flagged sudo/systemctl commands are part of an explicit setup doctor that the user triggers from the panel, not automatic behavior. The code is transparent, well-structured, and includes security hardening (guarded file I/O with O_NOFOLLOW, size caps, input validation). No malicious or hidden behavior was found.

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/DominicBoettger/omarchy-prompter --enable
Hardware #Hyprland #quickshell #media

Prompter — Elgato Prompter for Omarchy

Turn your Elgato Prompter into a first-class citizen on Omarchy. Elgato's Camera Hub does not exist for Linux — this plugin replaces it and goes further.

  • Eye-contact mirroring without quality loss. Mirror your working display (or just your meeting window, followed live) onto the prompter. Your screen share keeps capturing the real display at native 4K — the prompter is a read-only copy, not a detached surface.
  • Meeting autopilot — for any app. The trigger is your camera going active (system level, no app knowledge needed), and the meeting window is identified through the process holding the camera. Teams, Zoom, Meet, Webex, a browser tab, a tool nobody has heard of — all the same. When the call ends (camera and microphone released), the prompter offers to switch back, or does it automatically in instant mode. Audio-only calls can opt-in via the microphone trigger.
  • Native teleprompter. Markdown scripts with chapters, smooth scrolling, eyeline marker, countdown, remaining-time estimate, beam-splitter flip — rendered by the Omarchy shell in your theme's colors.
  • Control from anywhere. Every action is one command (omarchy-shell prompter play), ready for Hyprland keybindings, a Stream Deck, or a presenter clicker.
  • Setup doctor. Detects and fixes every step of the DisplayLink driver setup on Arch: packages, dkms build, service, and the AQ_DRM_DEVICES environment snippet Hyprland needs to see the output at all.
  • Per-setup profiles. Home, laptop-only, office — settings are remembered per monitor combination (matched by EDID, not by port).

Install

omarchy plugin add https://github.com/dominicboettger/omarchy-prompter.git --enable

Dependencies: wl-mirror (official repos) for mirroring, plus the DisplayLink stack (evdi-dkms, displaylink, linux-headers). Open the panel — the setup doctor checks all of it and offers one-click fixes.

Note: After installing the DisplayLink stack you must log out and back in once so Hyprland starts with the evdi DRM device in AQ_DRM_DEVICES. The doctor installs the required snippet to ~/.config/uwsm/env.d/.

Usage

Click the prompter icon in the bar. Pick a mode:

Mode What it does
Mirror display Mirrors the display you are working on (follows focus, or pin one)
Mirror window Mirrors one window's region, followed as it moves
Mirror region Mirrors a region you select with slurp
Teleprompter Scrolls a Markdown script from ~/.local/share/omarchy-prompter/scripts

The mirrored window must be visible on its display — the mirror is a live region copy, which is exactly why your screen share stays untouched.

Remote control

omarchy-shell prompter mirror        # mirror the focused display
omarchy-shell prompter mirrorActive  # mirror the focused window
omarchy-shell prompter teleprompter  # start the teleprompter
omarchy-shell prompter playPause     # toggle scrolling
omarchy-shell prompter faster        # +10 px/s (slower: -10)
omarchy-shell prompter nextChapter   # jump chapters (prevChapter)
omarchy-shell prompter flip          # beam-splitter flip
omarchy-shell prompter autopilot instant   # meeting detection: instant | on | off
omarchy-shell prompter mirrorMeeting # mirror the detected meeting window
omarchy-shell prompter status        # engine state as JSON
omarchy-shell prompter off           # back to plain monitor mode

Keybinding examples for ~/.config/hypr/bindings.lua are in examples/bindings.lua. Stream Deck: point any button of your favorite tool (streamdeck-ui, OpenDeck) at these commands.

Configure

omarchy bar move io.github.dominicboettger.prompter --section right

Teleprompter scripts are plain Markdown files; #/## headings become chapters. Drop them into ~/.local/share/omarchy-prompter/scripts/.

Remove

omarchy plugin remove io.github.dominicboettger.prompter

Development

scripts/dev-sync.sh --watch   # sync into ~/.config/omarchy/plugins (hot reload)
scripts/check.sh              # manifest validation + qmllint + unit tests

License

MIT