Omahub
← All plugins
L

Folia Lyrics

by Lia

Word-synced Folia lyrics with MPRIS playback integration (Requires Folia-major for lyric features)

GitHub

Security review

Review recommended · 2 findings

Deterministic scan — not a security guarantee

Low
Risk level
Low
Analyzed commit
96b5bae
Scanned
1 month ago

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

  • Docs external_hosts docs/guide.en.md:87

    Downloads or connects to an external HTTP(S) host.

    git clone https://github.com/chthollyphile/lia.lines.git
  • Docs external_hosts docs/guide.zh-CN.md:87

    Downloads or connects to an external HTTP(S) host.

    git clone https://github.com/chthollyphile/lia.lines.git

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

The plugin is a benign QML bar widget that polls a localhost lyrics API and reads MPRIS playback state. The deterministic scan flagged external hosts in the documentation, but those are only git clone instructions in the README/guide, not executable code. No obfuscation, destructive commands, persistence, or credential theft 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/chthollyphile/lia.lines --enable
Widgets #bar #quickshell #media

Folia Lyrics for Omarchy

Preview

English · 简体中文

A Quickshell status-bar lyrics plugin for Omarchy. It combines a Folia v1-compatible lyrics API with MPRIS playback position to render word-synced lyrics, falling back to the media title when lyrics are unavailable.

About Folia

Folia is a cross-platform music player centered on immersive full-screen lyrics, with support for online services, Navidrome, and local music libraries.

Features

  • Word-synced lyrics, translation fallback, global offsets, and line-gap handling
  • MPRIS title fallback, MPRIS-only mode, and click-to-play/pause
  • Long-text scrolling, paused-state styling, and a lightweight current-word glow
  • Hover detail popup with cover art, progress, both original and translated lyrics, and transport controls
  • Runs on plain Quickshell too: standalone/ bundles the handful of Omarchy components the widget needs

See the full English guide for installation, configuration, and development instructions. It covers both the Omarchy plugin install and a standalone Quickshell setup.

License

MIT