https://github.com/simsv-software/simmusic2024-linux
高颜值插件化音频播放器（Linux Ver）
https://github.com/simsv-software/simmusic2024-linux
aur-packages desktop-lyric electron linux local-music music music-player sim-music
Last synced: 8 months ago
JSON representation
高颜值插件化音频播放器（Linux Ver）
- Host: GitHub
- URL: https://github.com/simsv-software/simmusic2024-linux
- Owner: Simsv-Software
- License: gpl-3.0
- Created: 2024-08-29T02:18:24.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2025-01-29T12:54:51.000Z (8 months ago)
- Last Synced: 2025-01-29T13:38:49.333Z (8 months ago)
- Topics: aur-packages, desktop-lyric, electron, linux, local-music, music, music-player, sim-music
- Language: JavaScript
- Homepage:
- Size: 5.68 MB
- Stars: 2
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# SimMusic 2024 (Linux)
高颜值插件化音频播放器。
本仓库为 SimMusic 的 Linux 移植版，若需要 Windows 版本，请访问 [原仓库](https://github.com/Simsv-Software/SimMusic2024)。
## 🚩 安装
### Arch Linux
对于使用 Arch Linux 及其分支发行版的用户，我们维护了一个 [AUR 软件包 (simmusic-git)](https://aur.archlinux.org/packages/simmusic-git)，可以直接使用 AUR 工具进行安装。
### 其它发行版
对于其它 Linux 发行版的用户，您需要：
1. 下载并解压最新源码包，并放在一个目录中（注意，此目录将会成为程序目录）
2. 检查 Electron 状态，若您未安装 Electron，请先使用软件包管理器进行安装
3. 进入目录中的 `src` 文件夹，打开终端，运行 `npm i`（注意，依赖列表中不包含 `electron`）
至此您已可以通过运行 `electron /path/to/src` 来启动 SimMusic 了，但如果您想要配置 desktop 文件，请继续阅读：
1. 从 [此位置](https://aur.archlinux.org/cgit/aur.git/tree/SimMusic.desktop?h=simmusic-git) 复制内容，并保存到一个 desktop 文件中
2. 更改其中的 `Exec` 为 `electron /path/to/src`
3. 更改其中的 `Icon` 为 `src/assets/icon-blue.png` 的绝对路径
至此，SimMusic 的安装已完全完成。
## ✏️ 说明
我们不保证原版的所有功能在 Linux 下都可用，若您发现任何 Bug，请提出 Issue。
### 🔎 桌面歌词说明
#### 从任务栏等处隐藏
由于技术限制，我们无法设置 `skipTaskbar`，因此需要您手动设置您的窗口管理器来让桌面歌词窗口从任务栏等隐藏。
下表为桌面歌词的特征：
| Key | Value |
| ---- | ----------------- |
| 类名 | sim-music |
| 标题 | SimMusic 桌面歌词 |
若您正在使用 KDE Plasma 桌面 & Kwin 合成器，则可以导入[这条规则](/SimMusicLrcWin.kwinrule)。
#### 锁定桌面歌词
同样由于技术限制，我们使用了一个妥协方案，切换按钮位于 `托盘 -> SimMusic -(右击)-> 锁定/解锁桌面歌词`。
### 🚫 Weaknesses / TODOs
- 原生操作按钮: **可自定义性趋近于零**
- 部分功能: **需要更多配置项**
## 🔗 帮助文档
- 📄 SimMusic 用户指南
- 🧩 SimMusic 扩展索引
- 🧑💻 SimMusic 开发者参考
## ✨ 特色介绍
