# Folia Lyrics for Omarchy

![预览](preview-rm.png)

[English](README.md) · 简体中文

一个适用于 Omarchy 的 Quickshell 状态栏歌词插件。它通过兼容 Folia v1 的歌词接口与 MPRIS 播放进度显示逐字歌词，并在无歌词时回退到媒体标题。

## 关于 Folia

[Folia](https://github.com/chthollyphile/folia-major) 是一款以沉浸式全屏歌词为核心的跨平台音乐播放器，支持在线音乐服务、Navidrome 和本地音乐库。

## 功能

- 逐字歌词、翻译回退、全局时间偏移与行间空隙处理
- MPRIS 标题回退、纯 MPRIS 模式与点击播放控制
- 长文本滚动、暂停状态与轻量当前词光晕
- 悬浮详情弹窗：封面、进度、原文与翻译对照、播放控制
- 也可运行在纯 Quickshell 上：`standalone/` 附带了组件所需的少量 Omarchy 组件

安装、配置和开发说明请阅读[中文完整文档](docs/guide.zh-CN.md)，其中同时覆盖 Omarchy 插件安装与[纯 Quickshell 独立安装](docs/guide.zh-CN.md#安装不使用-omarchy-的-quickshell-用户)。

## 许可证

[MIT](LICENSE)