limusic README

项目的 README,来自 github.com/SimoHypers/limusic。合并为一个 markdown 文件:README.md。

Limusic Banner

Limusic

A native desktop YouTube Music client. Rust + Tauri, ad-free, no Electron.

GitHub Downloads GitHub Release License Translation status Website Support on Ko-fi
Linux Windows macOS Tauri 2 Rust

Limusic talks directly to YouTube's internal API and plays audio through libmpv: no bundled browser runtime, no backend server, no ads in the audio. It started as a desktop rebuild of the playback engine behind Metrolist, an Android YouTube Music client, and grew from there.


Features

Listening

  • Ad-free, straight from YouTube's API
  • Gapless, with loudness normalization
  • Radio and automix keep the queue going
  • Music videos, live radio and podcasts
  • Tempo, pitch and reverb, with presets
  • Your own local files too

Lyrics

  • Synced, word by word where the source has it
  • Duets, background vocals and translations
  • Nine sources, in the order you choose
  • Limusic Lyrics: sync a song yourself in the editor
  • Karaoke takes the vocals out, on your computer

Your library

  • Sign in, with several accounts at once
  • Playlists, likes, saved albums and artists, uploads
  • Create, edit and reorder playlists
  • History in YouTube Music's own day buckets
  • Listening stats, counted on your device
  • Search that previews as you type

Together

  • Listen Together rooms with friends
  • Link Limusic for Android and move the music between them
  • Last.fm and ListenBrainz scrobbling
  • Discord Rich Presence

On your desktop

  • Mini player and fullscreen theater mode
  • Tray icon, optional start on login
  • Media keys and now playing on every OS
  • Ctrl+K to search, Ctrl+H for every shortcut
  • Self-updating builds

Make it yours

  • Accent palettes, custom colors and fonts
  • Adaptive colors from the playing cover
  • Material You, or your wallpaper's colors through Matugen, wallust or pywal
  • A custom app icon
  • Nineteen languages, more on Weblate

Screenshots

A playlist in Limusic Word-by-word synced lyrics
An album page, colors adapted to the cover A music video playing with lyrics alongside

Download & Install

Platform File Notes
Windows -setup.exe Self-updating
Windows .msi Plain installer, no auto-update
Linux .AppImage Self-updating, libmpv bundled. Needs glibc 2.39+ (Ubuntu 24.04+, Debian 13+, Fedora 40+)
Linux (Ubuntu/Debian) .deb No self-update. Needs Ubuntu 24.04+ / Debian 13+; apt pulls libmpv and webkit2gtk in for you
Linux (Fedora/RHEL) .rpm Needs mpv-libs installed (sudo dnf install mpv-libs). No updates, redownload each release
macOS 15+ (Apple Silicon) .dmg Self-updating. Unsigned, so the first launch needs xattr -dr com.apple.quarantine /Applications/limusic.app
macOS (Intel) none Build from source, see docs/BUILD-PLATFORMS.md

Community-maintained repositories, packaged and updated by their maintainers rather than by this project:

Platform Source Notes
Linux (Arch) AUR yay -S limusic-bin, or yay -S limusic-bin-prerelease for release candidates. Maintained by @xiryuudev, updates through pacman
Linux (Fedora COPR) COPR sudo dnf copr enable oguzkarayemis/limusic then sudo dnf install limusic. Maintained by @oguzkarayemis, updates through dnf
Linux (openSUSE Tumbleweed) OBS sudo zypper ar -p 100 https://download.opensuse.org/repositories/home:/itachi_re/openSUSE_Tumbleweed/home:itachi_re.repo then sudo zypper install limusic. Maintained by @itachi-re, updates through zypper. The repo carries the maintainer's other packages too, so -p 100 keeps it below the distro repos

Scrobbling & Discord

Last.fm lives in the title bar, next to the window controls, and ListenBrainz connects from Settings ▸ Scrobbling. Both get the same cleaned-up track (the tab's preview shows what each play counts as).

Building from source? Last.fm needs your own API credentials, and they are not in the repo. Get a key at last.fm/api/account/create and put it in src-tauri/lastfm.keys:

LIMUSIC_LASTFM_API_KEY=your_key
LIMUSIC_LASTFM_API_SECRET=your_secret

Without that file everything else still builds and runs; the Last.fm button just reports that it isn't configured.


Lyrics

Open the panel with the microphone button in the player bar, next to the queue button. It takes the same side of the window as the queue, so opening one closes the other.

Nine sources are asked in order: Limusic Lyrics, Boidu, Unison, LyricsPlus, LRCLIB, YouTube Music's own lyrics, then Netease, QQ Music and Kugou. Synced lyrics from any of them beat plain text from one higher up, and plain text is the fallback when nobody has a synced version. Matching is keyed on the track's exact length, because popular songs exist as several cuts and the wrong one drifts a few seconds out. Results are cached locally, so replaying a track is instant.

The first four have per-word timings, which is what lets a line highlight word by word as it's sung. Reorder the sources or switch any of them off in Settings ▸ Playback ▸ Lyrics sources, and turn on Prefer word-by-word lyrics there to have word timings win over line timings from a source above. To pick another source for one song, click the source name under the lyrics. Netease additionally supplies translations, shown under each line where it has them.

Note that YouTube Music's lyrics are licensed per region and are missing entirely in some countries. Where that's the case, the other sources do all the work.

Limusic Lyrics and the lyric editor

Limusic Lyrics is the project's own lyrics service, filed by video, so a lyric is timed to the exact upload you're playing. It is filled by the people who use the app.

To add a song, click the source name under its lyrics and pick Sync these lyrics, or use Settings ▸ Contributing ▸ Open the lyric editor. Start from the lyrics another source already found, paste the text (pasted LRC or TTML keeps its timings), or open a TTML or LRC file. Then the song plays one line at a time, on a loop and slowed down if you like, and you tap a key as each word starts. Duets get a singer per line and background vocals can be marked word by word. A preview shows the result at full speed before you send it.

No account is needed: your first lyric makes an anonymous one. Link Discord or GitHub in Settings ▸ Contributing to put your name on your lyrics. Depending on the account, a lyric goes live at once or after a reviewer approves it. Everyone can vote on a lyric or report it from the source picker, and the lyrics credit their authors under the last line. Contributors earn points on the leaderboard.


Karaoke

Karaoke takes the vocals out of a song right on your computer, using AI models from Ultimate Vocal Remover. Nothing is uploaded. It is still marked experimental while it's being tuned.

Turn it on with the switch under the lyrics. The first time, Limusic asks before downloading a model (Light, Balanced or Best, swappable later in Settings ▸ Playback ▸ Karaoke) and the runtime that runs it. After that the playing song and the next two are prepared in the background, and the vocals drop out the moment a song is ready, right where you are in it. Prepared songs are kept on disk up to a size you choose, so they play straight away next time.

Light and Balanced keep up with playback on a processor; Best is meant for a graphics card. The Processor setting picks one: on Windows Auto uses the graphics card through DirectML, on Linux it's an opt-in through Vulkan (Intel, AMD and NVIDIA), and on Apple Silicon an opt-in through CoreML. Songs over 15 minutes keep their vocals, and karaoke is off while a proxy is set.


Listen Together

Synced listening with friends. Everyone streams their own audio from YouTube; the room only relays play/pause, seeks, track changes and the queue. Rooms have join codes and the host approves every join and every track suggestion.

Rooms run on the project's server by default. To host your own relay:

cargo run -p sync-server        # plain WebSocket on 0.0.0.0:8080

Front it with something that terminates TLS (Tailscale Funnel, Cloudflare Tunnel), then paste the wss:// URL into the Listen Together panel in the app.


Translations

Limusic is translated on Weblate, who host it free for libre projects.

Translation status

Nineteen languages ship in the app today, and the badge above shows everything else in flight.

Translate on Weblate, not in a pull request. Weblate keeps its own copy of the catalogs, so a hand-edited fr.json merged here puts the two out of sync and the next batch of real translations arrives as a merge conflict. Weblate also shows you the English original beside each string, flags translations that went stale when the English changed, checks that placeholders like {count} survived, and opens the pull request for you. Anything untranslated falls back to English in the app, so partial work is safe to submit.

en.json is the exception: it changes by hand, in whichever pull request changes the UI. Switching a finished language on in the picker takes a small code change too, see CONTRIBUTING.md.


Building from Source

Fedora:

sudo dnf install mpv-libs mpv-libs-devel webkit2gtk4.1-devel \
  gcc gcc-c++ make openssl-devel librsvg2-devel
cd ui && pnpm install && cd ..
cargo tauri build

Windows and macOS instructions live in docs/BUILD-PLATFORMS.md.


How It Works, Briefly


Star History

Star History Chart

Support

Limusic is free and stays free. If it earned a coffee, ko-fi.com/simohypers is where to leave one.


Disclaimer

This project is not affiliated with, funded, authorized, endorsed by, or in any way associated with YouTube, Google LLC, or any of their affiliates and subsidiaries.

All trademarks, service marks, and intellectual property rights referenced in this project belong to their respective owners.


License

GPL-3.0

Karaoke uses the UVR-MDX-NET-Inst_HQ_3, UVR-MDX-NET-Inst_Main and UVR_MDXNET_3_9662 models from Ultimate Vocal Remover by Anjok07 and aufr33 (MIT) and, on Windows, ONNX Runtime and DirectML from Microsoft. See THIRD-PARTY-NOTICES.md.

limusic (SimoHypers/limusic)

正在搜索数据库…

2.1K ·GitHub
这是什么?一款使用 Rust 和 Tauri 构建的 YouTube Music 原生桌面客户端,播放音乐无广告,不依赖 Electron,也没有自己的后端服务器。
它是下载歌曲,还是只做在线播放?它直接从 YouTube 的内部 API 串流音频,不提供下载功能。播放由 libmpv 处理,并会在本地磁盘上保留缓存。
怎么安装运行?请从 releases 页面下载适合你系统的安装程序:Windows 用 setup.exe,Linux 用 AppImage,Apple Silicon 芯片的 Mac 用 .dmg。Arch、Fedora 和 openSUSE 用户还可以安装社区维护的软件包。
我需要 YouTube 账号或自己的 API 密钥吗?登录 YouTube Music 账号后,可以查看你的音乐库和播放历史,并进行点赞等写入操作。如果要从源码构建 Last.fm 支持,则需要你自己的 Last.fm API 密钥。
安装前有什么需要注意的地方吗?AppImage 需要 glibc 2.39 或更高版本。.deb 和 .rpm 软件包不会自动更新,每个版本都需要你手动重新下载。
支持逐词同步歌词吗?在来源提供时间轴的情况下支持:Boidu 提供逐词时间轴,会优先尝试,然后依次是 LRCLIB、YouTube Music、Netease、QQ Music 和 Kugou。Netease 还会在每行下方提供翻译。
可以调整速度、音调,或者添加混响吗?可以:支持调节速度和音调,混响有独立的干声和湿声控制,还能将自定义预设保存在设备上。
能播放我本地的音乐文件吗?可以,“本地音乐”功能可以播放你自己的文件,并保留其元数据。
作者为什么开发这个?它最初是对 Metrolist(一款 Android YouTube Music 客户端)播放引擎的桌面版重写,之后逐步发展起来。
大小
11.8 MB
星标
2.1K
时长
4个月
提交 · 90 天