Skip to content
Martin Wagner edited this page Dec 28, 2020 · 30 revisions

Mpdevil is created to be easy to use with as little mouse clicks as possible.

Main Window

Back Button

Resets the 'Artist' and 'Album' list to show the album of the current playing title.

Search

Enter a search request and find matches from any tag in the library. Click left on a song to append it after the currently playing song and clear the playlist from all other songs (alternatively press 'p' on the keyboard). Click middle to append the song at the end of the playlist (alternatively press 'a' on the keyboard). Click right to show metadata (alternatively press 'menu' key). Double left click to clear the entire playlist and only play the selected song (alternatively press 'enter'). The 'Append' button adds all results to the playlist. The 'Play' button clears the playlist and plays the displayed results. The 'Enqueue' button appends them after the currently playing song and clears the playlist from all other songs. (If 'Play selected albums and titles immediately' is selected 'p' and left click will become an alias to 'enter' / double click)

Genre Filter

Select any other than 'all genres' to show only artists and albums matching the specified genre.

Artist List

Click on artists to show all their albums (alternatively press 'enter'). Just start typing to open an interactive search. Artists matching the search string exactly from the beginning get selected. Press enter to confirm.

Album List

Left click ('p' key), Middle click ('a' key) and Double click ('enter') do the same as in the search window, except that they operate on whole albums instead of single songs. Right click opens the album popover (alternatively press 'menu' key).

Album Popover

Click right on an album to display all it's songs in a list. This list behaves exactly as a list of results in the search window (mouse clicks, key presses and buttons).

Playlist

Click left to play a song immediately. Click middle to remove a song from the playlist (alternatively press 'del'). Click right to show metadata (alternatively press 'menu' key). Drag&Drop to reorder tracks. To select a song without playing, just use the arrow keys or ctrl + left mouse button. If MPD is in single mode mpdevil wont scroll the playlist automatically. Use the back button in the bottom left corner of the playlist to do this manually if needed (this button will always work regardless in which mode MPD is).

Progress Bar

Move the slider back and forth to find the desired position. Check the time indicators for guidance. Release the mouse button to play at the selected position. Click on the time indicators next to the progress bar to jump backward/forward 10sec. A left click moves the slider closer to the clicked indicator. A right click moves the slider away from the clicked indicator.

Mode Switchers And Volume Button

Right click on the single mode button toggles single mode oneshot. Right click on the volume button shows MPD audio outputs.

Main Album Cover

The main cover imitates the left click, right click and middle click functionalities of the album list.

Mini Player

In mini player mode mpdevil will collapse to a smaller window. Only a small subset of the controls will be visible. Intended usage: See what is currently playing while doing something else with your computer.

Settings

Profiles

The 'music lib' is only used to load covers. Covers have to be in the same sub directory of the corresponding track. Covers that match this regex ^\.?(album|cover|folder|front).*\.(gif|jpeg|jpg|png)$ get recognized per default.

Reset

If you want to reset mpdevil's settings to default run: gsettings reset-recursively org.mpdevil.mpdevil

General Hot Keys

  • space: Play/Pause
  • +: Next title
  • -: Previous title
  • /: Seek -10sec
  • *: Seek +10sec
  • ESC: Trigger back button
  • F1: Open help
  • F5: Update database
  • ctrl + l: Toggle lyrics
  • ctrl + m: Toggle mini player
  • ctrl + f: Toggle search
  • ctrl + q: Quit player
Clone this wiki locally