A simple music browser for MPD
Go to file
2020-12-24 13:55:04 +01:00
bin small fix in SearchWindow 2020-12-24 13:55:04 +01:00
data updated icon 2020-10-16 15:22:43 +02:00
po added Dutch translation by Martin de Reuver 2020-11-03 17:04:25 +01:00
screenshots preparations for 0.9.5 2020-10-25 11:54:03 +01:00
AUTHORS added Dutch translation by Martin de Reuver 2020-11-03 17:04:25 +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 migrated MPRISInterface to Gio 2020-12-24 13:21:08 +01:00
setup.py preparations for 0.9.7 2020-12-13 19:28:53 +01:00

README for mpdevil

Mpdevil is focused on playing your local music directly instead of managing playlists or playing network streams. So it neither supports saving playlists nor restoring them. Therefore mpdevil is mainly a simple music browser which aims to be easy to use. 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 your browser. Mpdevil strongly relies on tags.

ScreenShot

Features

  • display large covers
  • play songs without doubleclick
  • lyrics from 'www.letras.mus.br'
  • MPRIS interface (based on mpDris2)
  • notifications on title change
  • basic queue manipulation (move and delete single tracks)
  • search songs
  • filter by genre
  • media keys support
  • many shortcuts
  • manage multiple mpd servers

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

Building

Build dependencies:

  • DistUtilsExtra

Dependencies:

  • Gtk3
  • Python3

Python modules:

  • mpd (python-mpd2 >=1.0)
  • gi (Gtk, Gio, Gdk, GdkPixbuf, Pango, GObject, GLib, Notify)
  • requests
  • bs4 (beautifulsoup)

Run:

git clone https://github.com/SoongNoonien/mpdevil.git
cd mpdevil
sudo python3 setup.py install
sudo glib-compile-schemas /usr/share/glib-2.0/schemas
sudo gtk-update-icon-cache
sudo update-desktop-database

Translation

Mpdevil is currently available in English, German and Dutch. If you speek another language you can easily translate mpdevil 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 integrated into mpdevil just send me an e-mail or create a pull request. Link to poedit: https://poedit.net/