Omahub
← All plugins
F

Vidi

by Fel

Latest videos from your Vidi subscription feed.

GitHub

Security review

No obvious issues detected

Deterministic scan — not a security guarantee

None
Risk level
None
Analyzed commit
5ad4665
Scanned
1 month ago

No potentially dangerous behavior detected in the analyzed commit.

Automated analysis only — not a security guarantee.

AI advisory review

No obvious issues detected

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

None
AI risk level
None
Recommendation
install
Model
~deepseek/deepseek-v4-flash-latest
Analyzed commit
5ad4665
Reviewed
1 month ago

The plugin is a benign bar widget that reads vidi's local feed cache and shows unread videos. It uses embedded, readable Python scripts for safe file reads/writes with proper checks (O_NOFOLLOW, regular-file check, capped reads, atomic writes). All external commands (vidi, mpv, xdg-open, wl-copy) are user-triggered and match the documented behavior. No install-time scripts, obfuscation, persistence, or destructive actions were 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/Fel-2/omarchy-vidi-plugin --enable
Widgets #bar #quickshell #media

Vidi widget for Omarchy (Quattro)

A bar widget for Omarchy 4 "Quattro" showing the latest videos from vidi's subscription feed, plus a keyboard-navigable popup panel with the newest uploads.

preview

Features

  • Bar widget with an unread badge — how many videos have been published since you last checked the feed.
  • Popup panel listing the newest videos (up to 30) with channel, duration, views and age, and thumbnails from vidi's preview cache when available.
  • Click a video to play it directly in vidi (vidi <url> deep-link, vidi ≥ 0.5.0) — browser, mpv or copy-link are also selectable per settings.
  • Shorts can be excluded from the list and the unread count.
  • Light on resources: reads vidi's feed cache (~/.cache/vidi/feed_cache.json) through a jq compaction pass so the shell never parses the full file, refreshes every 5 minutes, and the unread counter survives restarts.

Requirements

Dependency Why
Omarchy 4.0 (Quattro) the Quickshell plugin architecture
vidi ≥ 0.5.0 feed cache + CLI deep-link
jq compaction of the feed cache
python3 descriptor-safe capped reads of the feed cache and unread state

Install

The plugin is a plain git repo with a manifest.json, so it installs with Omarchy's own plugin flow:

omarchy plugin add https://github.com/Fel-2/omarchy-vidi-plugin.git --enable

That clones it into ~/.config/omarchy/plugins/fel.vidi/, validates the manifest, and enables it. Check it is live:

omarchy plugin list | grep vidi

Then add the widget to the bar:

omarchy plugin enable fel.vidi --section right

or drag the ▶ entry wherever you like it. You can also adjust the settings inline:

omarchy bar set fel.vidi maxItems 15
omarchy bar set fel.vidi openAction "MPV"

Remove

omarchy plugin remove fel.vidi

That disables the plugin first, then deletes the checkout at ~/.config/omarchy/plugins/fel.vidi/. The unread state it wrote lives in ~/.local/state/vidi-feed/seen.json and can be deleted too if you want a clean slate. The built-in bar returns automatically.

Usage

Gesture / action Result
Widget left click toggle the feed panel
Widget right click mark the whole feed as seen
Widget middle click refresh the feed
Panel row click open the video (default: play in vidi)
Panel row right click copy the video URL
Panel header button open vidi in a terminal
Arrow keys / Enter navigate and open the selected video
C copy the selected video URL
Tab switch to the neighbouring panel
Esc close the panel
Opening the panel marks the feed seen

Settings

Setting Default Description
Maximum videos 10 how many videos the panel lists (3–30)
Include shorts off count and show YouTube shorts
Thumbnails on use thumbnails cached by vidi when available
Click action Vidi what happens on row click (Vidi / Browser / MPV / Copy)

Notes

  • The widget only reads vidi's cache; refreshing happens inside vidi — open the Subscriptions screen there once before first use, and whenever you want fresh data.
  • The unread counter persists across shell restarts (~/.local/state/vidi-feed/seen.json).
  • Validate the manifest after any change with omarchy plugin validate .

License

MIT — see LICENSE.