rmpc

mierakBSD-3-Clause活跃维护

一款用 Rust 写的终端 MPD 音乐客户端,支持通过 sixel 等终端图像协议显示专辑封面,配置灵活,适合喜欢在命令行里听歌的人。

A modern, configurable, terminal based MPD Client with album art support via various terminal image protocols

v0.11.0发布于 2026-02-01 12:35 UTC3,499star +10 / 7 天127fork同步于 2026-11-10 17:42 UTC

怎么上手

由 README 提炼,执行前请确认
README 未给出安装命令,安装方法见 https://rmpc.mierak.dev
硬件要求按 README 说明

README 未说明

支持 Apple Silicon
下载:源码 zip·GitHub Releases(安装包)本站不镜像安装包

项目说明

由 README 自动翻译提炼

终端里的 MPD 音乐播放器客户端,支持专辑封面显示和高度可配置界面

一款用 Rust 写的终端 MPD 音乐客户端,支持通过 sixel 等终端图像协议显示专辑封面,配置灵活,适合喜欢在命令行里听歌的人。

核心能力

  • 通过 Kitty、Sixel、Iterm2 协议或 ueberzugpp 显示专辑封面
  • 集成 Cava 实现音乐可视化
  • 支持同步歌词(LRC 格式)
  • 可播放 YouTube 上的音乐
  • 类 ranger/lf 的三栏音乐库浏览

容易踩的坑

专辑封面需终端支持 Kitty/Sixel/Iterm2 协议或安装 ueberzugpp;需自行运行 Music Player Daemon(MPD)服务;项目仍在成熟中,偶有破坏性变更

内容由模型根据 README 生成,可能不完整或不准确,以官方文档为准。看原文 README

最近发版

5 个版本v0.11.0
  1. v0.11.0最新正式版2026-02-01 · 2026-02-01 12:35 UTC

    It has been a while, yet again! As always, thanks to everyone who contributed, reported issues or helped in any other way!

    What's new and what changed

    As always, you can check CHANGELOG for a more refined list of changes.

    The highlights

    This release brings in another exciting set of features, improvements and fixes. Here some of the most important ones:

    • A new default theme featuring many of the newer options. Check it out, you might find something you like!
    • Keybinds now support vim-esque sequences, ie. gt/gT to switch tabs. You can of course configure your own sequences as well.
    • Fully configurable borders for panes including custom border symbol sets and titles that can utilize the usual properties.
    • A simple yt-dlp interface in the TUI so you can see what is happening when downloading.
    • And much more!

    Breaking changes

    There are some again, unfortunately, though they are mostly minor theming changes. No behavior has been removed but you might have to adjust your config.

    • Keybinds now only override the defaults. Meaning your configured keybinds are combined with the default ones. Set clear to true to keep the old behavior.
    • show_song_table_header has been removed. The queue header is now in a separate QueueHeader pane. You will need to update your config to include it in your tabs.
    • draw_borders has been deprecated. The Tabs pane is no longer affected by this, use the borders configuration on the pane itself instead. This now only affects borders in the browser panes and this will be romeved in the future as well.
    • current_item_style and highlighted_item_style now merge on top of the item's style instead of having defaults, specify all the style properties (fg, bg, modifiers) to keep the old look
    • progress bar's use_track_when_empty now defaults to true

    Packaging

    There is now a .desktop entry in the assets directory in the root of the repository if you wish to include it in the package. Docs address has also changed to https://rmpc.mierak.dev/. The old address will redirect to the new one.

    Full list of commits

    Added

  2. v0.10.02025-11-11 · 2025-11-11 18:18 UTC
    查看更新说明

    Yet again after quite some time.

    Another packed release with a bunch of new features and fixes. Thanks to all of you who continue to support, contribute and report issues!

    What's new and what changed

    As always, you can check CHANGELOG for a more refined list of changes.

    The highlights

    Support for stickers based rating of songs, bunch of new keybinds allowing you to control how exactly are songs added to the queue or saved to playlists, full TUI support for switching partitions and much more!

    Rmpc will now also attempt to resolve what terminal emulator you are using to better figure out what image backend to use. This fixes issues in terminals like Konsole which have partial implementation for kitty graphics protocol but report it as a supported feature.

    Breaking changes

    Yet again, we have a few breaking changes. I try very hard to keep these as minimal as possible so hopefully nothing too impactful:

    • TabName equality comparison is now case-insensitive, this impacts your SwitchToTab keybinds
    • $SELECTED_SONGS in queue now contains marked songs as well

    Full list of commits

    Added

  3. v0.9.02025-06-23 · 2025-06-23 21:08 UTC
    查看更新说明

    Long time no release!

    The biggest release yet is here. These are some exciting times for rmpc, it has gotten quite a bit more popular thanks to BreadOnPenguins youtube video, go check her channel out! Many new contributors joined, reported issues, and some even contributed directly, many thanks to all of you.

    What's new and what changed

    As always, you can check CHANGELOG for a more refined list of changes.

    The highlights

    • The first of two fanciest new features is config hot reload. Rmpc will now automatically reload your config when it changes.
    • The second spot definitely belongs to cava integration. You can now use everybody's favorite music visualizer directly in rmpc.
    • There are now better error messages when your config file gets goofed up while tinkering with rmpc. You should now get a modal popup stating what is wrong and roughly lead you to where the error is.
    • Support for more sites via addyt command, rmpc now supports soundcloud and nicovideo
    • New config properties, new keybinds, cli and much more, go check it out!

    Unfortunately, again, there are a few, hopefully minor and/or cosmetic breaking changes:

    • Songs are no longer sorted by their browser_song_format. The new browser_song_sort is used instead
    • Some tags can now be arrays of values instead of a single value if multiple values are in the given id3 tag when listing song metadata via cli.
    • For CLI which return song info: last-modified and added are no longer in songs' metadata, they are at the top level object instead now
    • ShowInfo queue action has been moved to navigation. It is now more general and works in playlists as well.

    Small note for package maintainers

    • Cava is now an optional runtime dependency of rmpc
    • There is a test that is failing on 32bit architectures, it is already fixed in master and is safe to ignore

    Full list of commits

    Added

  4. v0.8.02025-02-16 · 2025-02-16 17:01 UTC
    查看更新说明

    You can check CHANGELOG for a more refined list of changes.

    Another quite a big release which brings many new features and fixes. Highlights are the new layout system which allows you to further customize the appearance of rmpc, the new Property pane and many others!

    Unfortunately there are also minor (cosmetic) breaking changes this time around:

    • border_type in tabs config. It has been replaced by the new and more powerful borders
    • theme.tab_bar.enabled. It has been replaced by the layout system

    What's Changed

    Added

    Fixed

  5. v0.7.02024-12-23 · 2024-12-23 23:33 UTC
    查看更新说明

    Merry Christmas everyone!

    You can check CHANGELOG for a more refined list of changes.

    What's Changed

    Added

    Fixed

    Docs

    • docs: mention mpd prerequisite by

用户点评

登录用户的真实使用记录,可按版本和硬件筛选
共 0 条

    还没有人点评。第一个说出真实体验的人最有价值。

    README 原文

    未翻译

    Rusty Music Player Client

    Rmpc is a beautiful, modern and configurable terminal based Music Player Daemon client. It is heavily inspired by ncmpcpp and ranger/lf file managers.

    preview

    Get started

    Description, configuration and installation methods can be found on the rmpc website

    Main Features

    • Album cover art display if your terminal supports either of Kitty, Sixel, Iterm2 protocols, or via ueberzuggpp
    • Cava integration for music visualisation
    • Support for synchronized lyrics
    • Ability to play music from YouTube
    • Configurable (T)UI
      • Configure what information(if any!) is displayed in the header
      • Configure what columns are displayed on the queue screen
      • Create any color theme you want
      • Every keybind can be changed, vim-like by default
    • Ranger/LF-like three-column browser through your music library
    • Basic playlist management
    • Support scripting through basic CLI mode and script hooks

    And more to come

    Discussion

    Status

    Rmpc is still maturing. It is stable for daily use, although breaking changes, while rare, are sometimes unavoidable.

    Star History

    Packaging status

    Packaging status