A simple music browser for MPD
Go to file
Martin Wagner 71a4a7d3bb
Merge pull request #75 from Newbytee/fix-build-instructions
Use `meson setup` in build instructions
2023-08-02 15:20:17 +02:00
data preparations for 1.10.2 2023-03-18 13:11:31 +01:00
po updated Bulgarian translation 2023-01-30 17:46:48 +01:00
screenshots preparations for 1.9.0 2022-10-23 11:20:54 +02:00
src removed workaround for python-mpd2<3.1 2023-05-04 18:16:36 +02:00
.gitignore switched to meson 2021-12-29 14:03:25 +01:00
AUTHORS add french translator credits 2022-11-20 10:24:24 +01:00
LICENSE Initial commit 2020-01-11 11:21:48 +01:00
NEWS updated changelog 2020-04-04 10:25:11 +02:00
README.md Use `meson setup` in build instructions 2023-08-02 12:37:40 +02:00
meson.build preparations for 1.10.2 2023-03-18 13:11:31 +01:00
requirements.txt removed workaround for python-mpd2<3.1 2023-05-04 18:16:36 +02:00

README.md

README for mpdevil

Mpdevil is a simple music browser for the Music Player Daemon (MPD) which is focused on playing local music without the need of managing playlists. Instead of maintaining a client side database of your music library, mpdevil loads all tags and covers on demand. So you'll never see any outdated information in the browser. Mpdevil strongly relies on tags.

ScreenShot

Features

  • Display large covers
  • Play songs without double click
  • Lyrics from: https://www.letras.mus.br
  • MPRIS interface (based on mpDris2)
  • Basic queue manipulation (move and delete single tracks)

See: https://github.com/SoongNoonien/mpdevil/wiki/Usage

Package Installation

See: https://github.com/SoongNoonien/mpdevil/releases/latest

Ubuntu, Debian, Mint, Raspberry Pi OS:

  • Download the .deb file
  • Open a console
  • Navigate into download dir
  • Run: sudo apt install ./mpdevil_VERSION.deb

Arch, Manjaro (see: https://aur.archlinux.org/packages/mpdevil/):

  • Download the PKGBUILD from the AUR
  • Open a console
  • Navigate into download dir
  • Run: makepkg -sirc
  • Alternatively install it with an AUR helper

Gentoo (see: https://wiki.gentoo.org/wiki/Custom_repository):

  • Download the .ebuild
  • Place it into your local tree
  • Generate manifest file
  • Run: emerge mpdevil

Flatpak:

Download on Flathub

Building

Build dependencies:

  • meson

Dependencies:

  • GTK3
  • Python3

Python modules:

  • mpd (python-mpd2 >=1.1)
  • gi (Gtk, Gio, Gdk, GdkPixbuf, Pango, GObject, GLib)
  • cairo (pycairo)

Run:

git clone https://github.com/SoongNoonien/mpdevil.git
cd mpdevil
meson setup builddir --prefix=/usr/local
sudo ninja -C builddir install
sudo glib-compile-schemas /usr/local/share/glib-2.0/schemas
sudo gtk-update-icon-cache
sudo update-desktop-database

Translation

This program is currently available in English, German, Dutch, Bulgarian, Turkish, Polish and French. If you speak one of these or even another language, you can easily translate it by using poedit. Just import po/mpdevil.pot from this repo into poedit. To test your translation, copy the new .po file into the po directory of your cloned mpdevil repo and proceed as described in the Building section. To get your translation merged, just send me an e-mail or create a pull request.