Theme
A theme determines the look of rmpc. You can customize it by creating a custom theme file placed in the themes
directory and then configuring the theme property in the config file filename of the theme.
Bootstrapping a theme file
Section titled “Bootstrapping a theme file”- Config file can be bootstrapped by running the following command:
rmpc theme > ~/.config/rmpc/themes/<theme_name>.ron
- Use the theme in your config by editing the
themeproperty~/.config/rmpc/config.ronfile like so:theme: Some("<theme_name>") - Restart rmpc
Theme file structure
Section titled “Theme file structure”Below is a list of properties that can be changed.
layout
Section titled “layout”Base layout of the application, lets you configure where the various components are placed on the screen.
default_album_art_path
Section titled “default_album_art_path”A default image is displayed if a song does not have an album art. This property can override that default image.
show_song_table_header
Section titled “show_song_table_header”If set to false, the header of the song table is not displayed. Default is true.
draw_borders
Section titled “draw_borders”Whether to draw borders in the UI.
symbols
Section titled “symbols”Symbols to use in the various browser panes (artist, search, …)
symbols.song
Section titled “symbols.song”symbols.dir
Section titled “symbols.dir”symbols.marker
Section titled “symbols.marker”This symbol is used for selected items in the browser panes.
symbols.ellipsis
Section titled “symbols.ellipsis”Symbol used to indicate text truncation when content exceeds the available display space.
progress_bar
Section titled “progress_bar”Progress bar at the bottom of the window.
progress_bar.symbols
Section titled “progress_bar.symbols”Array of three single character strings that determine the look of the progress bar. First value is the elapsed part of the progress bar, second is the thumb and the third is the empty track. Default is `[”-”, ”>”, ” “]
progress_bar.track_style
Section titled “progress_bar.track_style”Style of the empty track part of the progress bar.
progress_bar.elapsed_style
Section titled “progress_bar.elapsed_style”Style of the elapsed part of the progress bar.
progress_bar.thumb_style
Section titled “progress_bar.thumb_style”Style of the progress bar thumb.
scrollbar
Section titled “scrollbar”Configure the style of scrollbars in rmpc. Passing in None hides them.
scrollbar.symbols
Section titled “scrollbar.symbols”Array of four single character strings that determine the look of the scrollbars. First value is the track, second is
the thumb, third is the top end and the fourth is the bottom end. Default is ["│", "█", "▲", "▼"]
scrollbar.track_style
Section titled “scrollbar.track_style”scrollbar.ends_style
Section titled “scrollbar.ends_style”scrollbar.thumb_style
Section titled “scrollbar.thumb_style”browser_column_widths
Section titled “browser_column_widths”Three numerical values that determine the percent width of the columns in the browser tab. Default is [20, 38, 42].
Meaning the first column takes 20% of the width, the second 38% and the third 42%.
background_color
Section titled “background_color”Background color of the main window.
header_background_color
Section titled “header_background_color”Background color of the window header. The header is at the top of the window and contains tab bar and user configurable data.
modal_background_color
Section titled “modal_background_color”Background color of modal dialogs.
modal_backdrop
Section titled “modal_backdrop”Enables a backdrop behind modals for increased visual clarity. Defaults to false.
text_color
Section titled “text_color”Foreground color of basic text. Defaults to your terminal’s foreground color.
preview_label_style
Section titled “preview_label_style”Style of song metadata labels in browser previews.
preview_metadata_group_style
Section titled “preview_metadata_group_style”Style of song metadata group headers in browser previews.
tab_bar
Section titled “tab_bar”Tab bar at the top of the window below header. Shows what tab is currently active.
tab_bar.enabled
Section titled “tab_bar.enabled”Do not use. Deprecated in favor of the layout config.
tab_bar.active_style
Section titled “tab_bar.active_style”Style for the active tab.
tab_bar.inactive_style
Section titled “tab_bar.inactive_style”Style for all tabs except the active one.
highlighted_item_style
Section titled “highlighted_item_style”current_item_style
Section titled “current_item_style”borders_style
Section titled “borders_style”highlight_border_style
Section titled “highlight_border_style”format_tag_separator
Section titled “format_tag_separator”Use this to separate entries when a song has multiple values for a tag. For example, a song with
two values for artist and | as a separator will show artist1 | artist2. Default is |.
song_table_format
Section titled “song_table_format”Configures the columns of the song table. This property is described in its own page:
browser_song_format
Section titled “browser_song_format”Format used to display song in the various browser panes (albums, artists, …). Is the same format as song_table_format except the styles are ignored.
Defaults to Track Artist - Title
header
Section titled “header”Configuration of the header. Header is displayed at the top of the window. It can display info about current song, the player state and custom widgets. This property is described in its own page: