Website profiles · Technology insights · Alternatives

rmpc.mierak.dev

A beautiful and configurable TUI client for MPD

No paid content found
Visit website
Profile views 16 Outbound visits 24 Normal
rmpc Full homepage screenshot

At a glance

Category
Music & Audio
Language
English
Paid-content signal
No paid content foundObserved
Registered
2025
Hosting
FastlyInferred
HTTPS certificate trusted
PassedObserved
Last updated

Website review

This review may include AI-generated content and is not individually verified. Domain, certificate and other facts come from the observed data on this page.

What is rmpc?

rmpc is a terminal-based client for MPD (Music Player Daemon), described as "a beautiful and configurable TUI client for MPD." In practice, that means it gives you a keyboard-driven interface inside your terminal for browsing and controlling music that an MPD server is already serving, rather than a graphical desktop app or a standalone player with its own library management.

It suits people who already run MPD—perhaps on a home server, a Raspberry Pi, or the same machine—and want a fast, low-overhead way to control playback without leaving the terminal. The emphasis on configurability suggests it is aimed at users who like to tune keybindings, layout, and appearance rather than accept a fixed interface.

A few things the project points you toward:

  • Get Started and Install for setup instructions
  • Try without installing if you want to evaluate it first
  • Configure for adjusting rmpc to your preferences
  • Reference for looking up specific configuration options
  • Themes, including predefined and user-submitted ones, for changing its look

One practical caveat from the page itself: the documentation covers the development version, so you should confirm that your installed version matches the docs you are reading.

If you are deciding whether to try it, start with the "Try without installing" route and point it at an existing MPD instance. If you do not already run MPD, rmpc is not a complete replacement for a music player—you would need to set up and manage MPD separately.

How do I install rmpc on my system?

Install rmpc through your system's package manager or by building it from source; the official documentation points to an installation page and notes it covers the development version, so match your version to the right docs.

rmpc is a terminal (TUI) client for MPD, so you also need a running MPD server. The client connects to it; installing rmpc alone won't give you music playback.

Practical routes

  • Package manager: Check your distro's repositories first (e.g. pacman, apt, dnf, brew). This is the least effort and easiest to update.
  • Prebuilt binaries: Look for a release archive for your OS/architecture if the project publishes them.
  • Build from source: Requires a Rust toolchain (cargo). Use this when you want the newest version or your platform isn't packaged.
  • Try without installing: The docs offer a "Try without installing" path, useful for a quick look before committing.

A concrete scenario

On Arch, sudo pacman -S rmpc (if available) plus mpd and mpd-mpc-style setup gets you running fastest. On macOS, brew install rmpc is the equivalent shortcut. If neither has it, install Rust via rustup, then cargo install rmpc.

Decision criterion

Choose the package manager if you value stability and easy upgrades; choose source or binaries if you need a newer release or your distro lags.

Next step: open the official Installation page at rmpc and confirm the command matches your OS and the version you intend to run.

Can I try rmpc without installing it first?

Yes. rmpc's own documentation includes a "Try without installing" path alongside the standard install and configuration guides, so you can evaluate the interface before committing to a local setup.

rmpc

H3 What "trying it" actually gets you A no-install trial is most useful for judging the parts of a music player that are hard to describe: how the queue and library panes are laid out, how much of the screen goes to album art or metadata, and whether the keybindings feel natural for your hands. rmpc is a terminal client for MPD, so the trial shows you the client experience — the look, the navigation and the configuration surface — rather than a self-contained player with its own audio engine.

H3 When a trial is enough, and when it isn't

  • Enough: you want to see whether a TUI fits your workflow, compare it against other MPD clients, or check that the theme and layout options match your taste.
  • Not enough: you need to confirm it connects to your existing MPD server, handles a very large library, or behaves correctly with your local audio output and network setup. Those depend on your own machine.

H3 A practical way to decide If the trial looks promising, the natural next step is to install it and point it at your MPD instance, then work through the configuration reference to adjust keybindings and appearance. If you don't already run MPD, note that rmpc is a client, not a server — you'll need MPD (or a compatible daemon) available first. One caution from the project's own docs: the page you're reading documents the development version, so match the documentation to the version you actually install to avoid chasing options that differ.

How do I configure rmpc to match my preferences?

Configuration for rmpc happens through its own config file, and the documentation splits the work into three parts: installing it, configuring it, and looking up specific options. Start by opening the Configure page, since that is where the settings that shape the interface and behavior live. The Reference page is the lookup table for individual options when you already know what you want to change.

A practical order

  1. Install rmpc and confirm the version you are running, because the docs cover a development version and options may differ from a released build.
  2. Try it without installing if you want to see the default look before committing to a setup.
  3. Edit the configuration file to set your preferences, then restart to apply changes.
  4. Use the Reference when a setting name or accepted value is unclear.

What "matching your preferences" usually means

  • Layout and visible panels: how much of the screen goes to the queue, library, or now-playing view.
  • Keybindings: remapping controls to keys you already use in a terminal or editor.
  • Colors and theme: rmpc ships predefined themes and accepts user-submitted ones, so you can either pick an existing theme or build on one.
  • Behavior details: the smaller toggles that decide how the player responds to your input.

If you mainly care about looks, themes are the fastest route. If you care about feel, keybindings and layout matter more. If you want a specific behavior, search the Reference for that term rather than reading the whole config top to bottom.

Concrete scenario

Suppose you run MPD on a home server and connect from a laptop terminal. You would keep the connection settings as they are, then spend your time on the queue layout and a theme that stays readable in a dark terminal. Someone using rmpc on the same machine as MPD has less to configure and can focus almost entirely on keybindings and appearance.

Decision criterion

Change one category at a time — theme first, then layout, then keybindings — and check the result after each. Mixing all three at once makes it hard to tell which edit caused a problem.

Next step

Open the Configure page at rmpc and make a single edit to your config file. If the option you want is not listed there, check the Reference section on the same site.

Where can I find themes for rmpc?

Themes for rmpc are available through the project's own theme gallery, which is linked from the rmpc documentation site under "Themes." That page collects both predefined themes and user-submitted ones, so it's the natural starting point before you write your own.

rmpc

How to approach it

  • Start with the built-in gallery if you want something that works immediately: pick a theme, drop it into your rmpc configuration, and adjust from there.
  • Check the version note first. The documentation site covers a development version, so confirm your installed rmpc matches the docs you're reading. Theme formats and config keys can shift between versions, and a theme written for a different release may not load cleanly.
  • Use a theme as a template rather than a final answer. Since rmpc is explicitly configurable, the practical move is to take a submitted theme, then edit the colors and layout options to suit your terminal's palette and font.

A concrete scenario

Suppose you run MPD on a home server and control it from a laptop terminal over SSH. You'd browse the gallery, copy a dark theme that reads well against your terminal background, paste it into your rmpc config, and tweak the accent color so now-playing text stands out. If nothing in the gallery fits, the same config reference that documents theme options is where you'd build one from scratch.

Decision criterion

Choose a gallery theme when you want speed and don't care about exact colors; write your own when your terminal palette is unusual (very low contrast, unusual background) or when you want the interface to match other TUI tools you already use.

What should I do after getting started with rmpc?

After you finish the getting-started steps, the main path is: install rmpc properly, then configure it, then tune the look with themes. The documentation itself frames these as the next steps, so treat them as the intended progression rather than optional extras.

A sensible order

  1. Install it. Move from the try-it-out stage to a real installation so your setup persists and you can update it normally. This matters most if you tried the no-install route first, since that version may not carry your settings forward.
  2. Configure it. rmpc is described as configurable, so this is where you make it fit your habits: keybindings, layout, and how it connects to your MPD server. Start small — get it connecting and behaving predictably before adding refinements.
  3. Apply a theme. Predefined and user-submitted themes are available, so you can change the appearance without building a config from scratch. Pick a predefined one first; switch to a submitted theme only if it matches your terminal's colours.
  4. Check the reference when stuck. If you want a specific option and can't find it, the reference section is the lookup point rather than the guides.

A concrete scenario

Suppose you run MPD on a home server and want to control it from a laptop terminal. After getting started, install rmpc on the laptop, point its configuration at the server's MPD host and port, confirm playback and queue controls work, then add a theme so the interface is readable against your terminal background. Only after that is it worth fine-tuning keybindings, because you'll know which actions you actually repeat.

One thing to watch

The documentation notes it covers the development version, and warns that your version should match the selected documentation. If an option you read about doesn't work, check whether you're reading docs for a version newer than your installed one before assuming a mistake.

For background on the player it controls, see Music Player Daemon.

Related questions

More questions →
What Is rmpc and Why Does It Require MPD?

rmpc (Rusty Music Player Client) is a terminal user interface (TUI) client for MPD, the Music Player Daemon. It does not play music itself and does not manage your music library on its own — it connects to a running MPD server and gives you a configurable, keyboard-driven interface for controlling playback. So you can use rmpc only if you already have (or are willing to set up) an MPD instance that indexes and plays your local music.

The client/server split, explained

MPD follows a client–server model:

  • MPD (the server) runs in the background, watches your music directories, maintains the library database, decodes audio, and outputs it to your sound device.
  • A client connects to MPD over a socket and sends commands: play, pause, skip, adjust volume, browse the queue, and so on.

rmpc is one such client. It is described as "a beautiful and configurable TUI client for MPD," which places it in the same role as other MPD frontends — it is the control surface, not the engine.

This is why rmpc requires MPD: without a running MPD service, rmpc has nothing to connect to and no library to display.

What this means for your existing setup

Whether rmpc fits depends on where your music already lives.

Your situation Does rmpc fit?
You already run MPD and want a nicer terminal frontend Yes — rmpc is built for exactly this
You have local music files but no MPD yet Yes, but you must install and configure MPD first
You stream from a service (Spotify, etc.) with no local files Not directly — MPD works with files it can index
You want a player that manages its own library No — that responsibility belongs to MPD, not rmpc

The key point: rmpc does not scan folders, build a database, or decode audio. Those are MPD's jobs. If your library isn't already visible to an MPD server, rmpc won't make it appear.

Getting from zero to a working rmpc

If you're starting without MPD, the sequence is:

  1. Install and run MPD. Configure its music directory and audio output, then start the service. Verify it's running before continuing.
  2. Install rmpc. Follow the installation instructions on the rmpc site for your platform.
  3. Point rmpc at your MPD instance. By default it connects to the local MPD; if your server is remote or on a non-default socket/port, adjust the connection settings.
  4. Configure rmpc to taste. The project documents a range of configuration options, and there are predefined and user-submitted themes if you want to change the look.

The rmpc documentation notes it covers the development version, so make sure the docs you read match the version you installed — configuration options can differ between releases.

Common sticking points

  • "rmpc can't connect." Usually MPD isn't running, or rmpc is pointed at the wrong host/port/socket. Confirm MPD is up first.
  • "My music isn't showing." The files likely aren't in MPD's configured music directory, or MPD hasn't updated its database. That's an MPD-side fix, not an rmpc one.
  • "No sound." Audio output is an MPD concern. Check MPD's output configuration.
  • Docs don't match behavior. You may be reading development-version docs against a stable install, or vice versa.

The short version

rmpc is a frontend; MPD is the player and library manager. You need MPD running before rmpc is useful, and rmpc won't replace MPD's job of indexing and playing your music. If you already have MPD, rmpc is a drop-in, highly configurable terminal client for it. If you don't, budget time for the MPD setup first — that's the prerequisite, not an optional extra.

How to Try rmpc Without Installing It

rmpc's documentation includes a "Try without installing" entry point, so you can preview the TUI before committing to a local setup. Use it when you want to evaluate the interface and interaction model first, then decide whether to install rmpc and configure it against your own MPD server.

What the no-install option gives you

The rmpc site lists three starting points: Get Started, Try without installing, and Next steps (Install, Configure, Reference, Themes). The "Try without installing" path exists specifically so you can see the client running without going through the install flow.

What this means in practice:

  • You can look at the TUI layout, colors, and general feel before installing anything.
  • You don't need a working local MPD setup just to preview the interface.
  • It's an evaluation step, not a replacement for a real installation — once you like it, you move on to Install and Configure.

Steps

  1. Open the rmpc documentation site (rmpc.mierak.dev).
  2. Find the "Try without installing" link — it sits alongside "Get Started" near the top of the page.
  3. Follow that entry to launch or preview the client.
  4. Explore the interface: navigation, panels, and key bindings.
  5. If it fits your workflow, go back and follow Install, then Configure to point rmpc at your MPD instance.

Expected result: you've seen rmpc's TUI and interaction style without a local install or MPD configuration.

Check your version first

The documentation page carries an explicit warning: it covers the development version of rmpc, and you should make sure your version matches the selected documentation. If you later install a released version, some options or screens may differ from what you previewed. Keep this in mind when comparing the demo against your installed build.

When to skip the preview

The no-install route is a look-and-feel check, not a functional test against your music library. Skip it and go straight to Install + Configure if:

  • You already know you want a TUI MPD client.
  • You need to verify behavior against your actual MPD server, playlists, or themes.
  • You're evaluating configuration options — those live under Reference and Themes, and require a real setup to apply.

After the preview

Once you've decided rmpc is worth keeping, the documented next steps are:

Step What it covers
Install Installation instructions
Configure Setting up rmpc the way you like it
Reference Looking up a specific configuration option
Themes Predefined and user-submitted themes

Themes are worth a look even during evaluation — browsing predefined and user-submitted themes tells you how much visual customization is available before you invest time in configuration.

How to Configure rmpc and Find Themes

rmpc is configured through its own configuration file, and the project documentation splits this into two resources: a Configure page for how configuration works, and a Reference page for looking up individual options. Themes are handled separately — the site offers both predefined and user-submitted themes you can browse and apply. Start with the Configure page to set up your file, then use Reference whenever you need to check a specific option, and Themes when you want to change the look.

Configuring rmpc

The documentation's "Configure" section is the entry point for adjusting rmpc to your preferences. It covers how to configure rmpc "just how you like it," which is the intended workflow for changing both interface and behavior.

A practical order of operations:

  1. Read the Configure page first to understand where the configuration lives and how it is structured.
  2. Make your changes to that configuration.
  3. When you need a specific option, switch to the Reference section rather than guessing.

Using the Reference for specific options

The site describes Reference as the place to go when you are "looking for a specific configuration option." That makes it the lookup layer: Configure explains the mechanism, Reference answers "what is the exact name/value for this setting."

If a setting you expect isn't behaving, check Reference before assuming the feature doesn't exist — the option may simply be named differently than you guessed.

Finding and applying themes

Themes are a distinct part of rmpc's customization. The documentation's Themes section lets you browse:

  • Predefined themes — ready-made options supplied with the project.
  • User-submitted themes — themes contributed by other users.

Because both categories are listed together, you can compare them in one place and pick whichever matches your terminal setup and taste.

A note on version matching

The documentation page states it is for the development version of rmpc and warns: "Make sure your version matches the selected documentation." This matters for configuration and themes specifically, because option names and theme formats can differ between the development version and a released version.

Before following any configuration or theme instructions, confirm which version you are running and that you are reading the matching docs. If an option from Reference doesn't work, a version mismatch is a likely cause.

Quick decision guide

Goal Where to go
Understand how configuration works Configure
Look up a specific option Reference
Change the appearance Themes (predefined or user-submitted)
Verify instructions apply to your build Check your version against the docs

For installation and trying rmpc without installing it, see the separate Get Started and "Try without installing" paths linked from the site.

What is rmpc (Rusty Music Player Client)?

rmpc is a terminal user interface (TUI) client for MPD (Music Player Daemon), written in Rust. It is designed to be beautiful and configurable, giving you a keyboard-driven way to browse and control your music library from the terminal. If you already run MPD and want a modern-feeling interface without leaving the console, rmpc is built for that workflow.

What it actually is

rmpc is a front-end, not a music player on its own. It connects to an MPD server, which handles playback and library management, and renders the state in a TUI. That means:

  • MPD does the work. You need a running MPD instance for rmpc to talk to.
  • rmpc handles the interface. It presents your queue, library, and playback controls in the terminal.
  • Rust is the implementation language. This matters mainly for distribution and performance characteristics, not for how you use it day to day.

The project describes itself as "a beautiful and configurable TUI client for MPD," so the two selling points to weigh are appearance and how much you can tailor it.

Who it suits

rmpc fits a specific setup rather than every listener:

  • You already use MPD, or are willing to set it up.
  • You prefer working in a terminal and want keyboard control.
  • You care about theming and configuration, not just raw function.
  • You want a client that stays out of the way and runs alongside other terminal tools.

If you use a graphical player or a streaming service, rmpc is not a drop-in replacement — it is an MPD client.

What you can do with it

Based on the project's own structure, the main paths are:

Goal Where to start
Try it before committing "Try without installing" option on the site
Install it Installation instructions
Tune behavior and appearance Configuration options
Change the look Predefined and user-submitted themes
Look up a specific setting Reference section

The presence of a "try without installing" route is useful if you want to see the interface before setting up a local build.

A note on versions

The documentation page states it is for the development version of rmpc and warns you to make sure your version matches the selected documentation. If you install a released version, check that the docs you read correspond to it — configuration options can differ between the development build and a stable release.

Getting oriented

A practical order of operations:

  1. Confirm you have MPD running and reachable.
  2. Either try the no-install option or follow the installation instructions.
  3. Open the configuration section and set up your MPD connection details.
  4. Browse themes if the default look is not what you want.
  5. Keep the reference handy for specific options as you refine things.

The project's own "Next steps" point to Install, Configure, Reference, and Themes — following that sequence covers the essentials without guesswork.

How to Install rmpc

rmpc is installed by following the official installation instructions on its documentation site, and the one thing to check first is version alignment: the docs you are reading are for the development version of rmpc, so you must make sure your installed version matches the documentation you selected. If you are running a released version but reading the development docs (or the reverse), configuration options and behavior may not line up.

Before You Start

rmpc is a TUI client for MPD (Music Player Daemon), so an install only gets you the client. You also need a working MPD instance to connect to, and rmpc configured to point at it. The official site splits this into two separate steps: Install and Configure.

Installation Steps

  1. Open the rmpc documentation site and go to the Install page. This is the authoritative source for installation instructions, since the supported methods can change between versions.
  2. Follow the instructions on that page for your platform. The site presents installation as the first step after getting started, with configuration as the distinct next step.
  3. Confirm which version you installed. Because the documentation covers the development version, note whether you installed a release build or a development build.
  4. Match your documentation to that version. If your version and the selected docs differ, switch the documentation version selector (or install the matching version) before relying on any configuration details.

Verify the Install

After installing, launch rmpc from your terminal. The expected result is the TUI starting up and attempting to connect to MPD. If it starts but shows no library or playback data, the install itself succeeded — the remaining problem is the MPD connection, which belongs to the configuration step.

Common Sticking Points

  • Version mismatch with the docs. This is the failure mode the site explicitly warns about. Symptoms are configuration keys or options that appear not to work as documented.
  • No MPD running. rmpc is a client; without a reachable MPD instance there is nothing to control.
  • Skipping configuration. A successful install does not mean rmpc knows where your MPD is or how you want it to look.

Next Steps After Installing

  • Configure — set up rmpc the way you want, including how it connects to MPD.
  • Reference — look up a specific configuration option when you need exact syntax.
  • Themes — browse predefined and user-submitted themes if you want to change the appearance.
  • Try without installing — if you only want to evaluate rmpc first, the site offers a way to try it before committing to an install.

Website Overview

An advisory match combined with missing browser safeguards may increase exposure if the affected component is active. Deployment-specific verification and remediation deserve priority. Identifiable technologies and additional version or configuration signals make the service easier to fingerprint, which may help targeted scanners narrow their checks.

Domain and Registration

The domain was registered less than a year ago and has limited historical evidence to assess. Transfer-protection status is present, helping reduce the risk of unauthorized domain transfers. The registrar is CloudFlare, Inc., a widely used domain service provider. The domain uses the common .dev extension, which is not an independent safety signal.

DNS and Email

Nameservers are provided by Cloudflare, indicating managed DNS hosting. No CNAME was found; the observed records resolve directly to addresses. No MX record was found. A conventional explicit inbound-mail route is not configured. TXT records include verification markers for Google. Such markers may also remain after a service stops being used. DNSSEC signatures were not detected, so this additional DNS authenticity protection is not confirmed.

TLS and Certificates

The public key uses EC with 256 bits. The server supplied a complete certificate chain. No organization name is present in the certificate; the available fields are consistent with domain validation. The certificate was issued within the Google Trust Services cloud or CDN ecosystem. The certificate's total validity is about 90 days, consistent with a short renewal cycle.

HTTP and Browser Security

The checked browser-security headers were not detected, leaving fewer explicit browser-side safeguards. CORS permits any origin to read this response. This is common for public resources; sensitive responses need narrower handling. No X-Powered-By header was found, reducing one common source of backend fingerprinting information. The cf-ray, x-cache, x-served-by, via response header indicates a CDN or caching proxy in the delivery path. No obvious internal addresses or debug information were found in the headers.

Technology Stack Analysis

The public page identifies Astro 5.17.1, Cloudflare, Fastly, with exact versions exposed for 1 technologies. These details can narrow vulnerability checks, although exposure alone is not a vulnerability. The advisory source OSV places Astro 5.17.1 in the affected range of GHSA-26w7-cxv4-gfx2, GHSA-2pvr-wf23-7pc7, GHSA-376h-93r7-7g6f, GHSA-4g3v-8h47-v7g6, GHSA-7pw4-f3q4-r2p2 等 10 项. Verify the deployed version and relevant configuration before drawing conclusions about exploitability. Updating affected components should be a priority.

Search and Social Sharing

The Generator tag identifies Astro v5.17.1, making the publishing system easier to fingerprint. Twitter Card metadata is configured. The title has 32 characters, within a common display range. A meta description is present, with 47 characters. The observed directives allow indexing and link following.

Hosting and Email

DNSCloudflare
HostingFastly
EmailUnknown
Approximate IP geolocation (inferred; a CDN or proxy may differ from the origin server) Location unknown Inferred 104.21.86.129

Registration details

RDAP / WHOIS

RegistrarCloudFlare, Inc.
Registered2025-11-12
Expires2035-11-12
Domain statusclient transfer prohibited
Nameserversharvey.ns.cloudflare.com、zelda.ns.cloudflare.com
DNSSECunsigned

DNS records

DNS

TypeNameValueTTLPriority
Armpc.mierak.dev104.21.86.129300—
Armpc.mierak.dev172.67.220.47300—
AAAArmpc.mierak.dev2606:4700:3030::6815:5681300—
AAAArmpc.mierak.dev2606:4700:3034::ac43:dc2f300—
NSmierak.devharvey.ns.cloudflare.com86400—
NSmierak.devzelda.ns.cloudflare.com86400—
TXTmierak.devgoogle-site-verification=sbO1i79kb4DkvpsxxzBPfXoPV6EeVqPyo1NOKX0_H0Y300—
TXTmierak.devv=spf1 -all300—
DMARC_dmarc.mierak.devv=DMARC1; p=reject; sp=reject; adkim=s; aspf=s;300—

TLS and certificates

TLS / SSL

AssessmentNormal configuration
Supported protocolsTLSv1.2、TLSv1.3
Negotiated protocolTLSv1.3
Certificate subjectmierak.dev
IssuerGoogle Trust Services
Valid until2026-12-03T06:18 · Remaining when checked: 62 days
Verification detailsCertificate trust: Passed · Hostname match: Passed

HTTP response headers

HTTP

HeaderValue
content-typetext/html; charset=utf-8
cache-controlmax-age=600
servercloudflare
access-control-allow-origin*

Identified technologies

Astro 5.17.1CloudflareFastly

Pages, Search and Sharing

Meta descriptionA beautiful and configurable TUI client for MPD
Canonical URLhttps://rmpc.mierak.dev/
LanguageEnglish (default)
Twitter Cardsummary_large_image

No robots.txt found

No sitemaps found

User reviews (0)

  • No reviews yet.