mpdevil/README.md

79 lines
2.5 KiB
Markdown
Raw Normal View History

2020-01-11 13:25:15 +03:00
README for mpdevil
==================
2020-03-02 00:25:35 +03:00
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 music browser which aims to be easy to use. mpdevil dosen't store any client side database of your music library. Instead all tags and covers get presented to you in real time. So you'll never see any outdated information in your browser. mpdevil strongly relies on tags.
2020-01-11 13:25:15 +03:00
2020-08-19 21:40:38 +03:00
![ScreenShot](screenshots/mainwindow_0.8.5.png)
2020-01-11 17:09:10 +03:00
2020-01-11 13:58:55 +03:00
Features
--------
2020-04-03 20:40:35 +03:00
- play songs without doubleclicking
- search songs in your music library
- manage multiple mpd servers
- filter by genre
- control with media keys
- displays covers
- sends notifications on title change
2020-04-03 21:41:11 +03:00
- fetches lyrics from the web (based on PyLyrics)
2020-04-03 20:40:35 +03:00
- MPRIS interface (based on mpDris2)
2020-01-12 17:32:02 +03:00
2020-04-06 22:20:55 +03:00
See: https://github.com/SoongNoonien/mpdevil/wiki/Usage
2020-08-03 10:54:31 +03:00
Package Installation
--------------------
See:
https://github.com/SoongNoonien/mpdevil/releases/latest
Ubuntu, Debian, Mint:
- Download the .deb file
- Open a console
- Navigate into download dir
- Run: `sudo apt install ./mpdevil_VERSION.deb`
2020-04-06 22:20:55 +03:00
2020-08-19 21:40:38 +03:00
Arch, Manjaro (see: https://aur.archlinux.org/packages/mpdevil/):
- Download the PKGBUILD from the AUR
2020-08-03 10:54:31 +03:00
- Open a console
- Navigate into download dir
- Run: `makepkg -sirc`
2020-08-19 21:40:38 +03:00
- Alternatively install it with an AUR helper
2020-08-03 10:54:31 +03:00
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
--------
2020-01-11 13:25:15 +03:00
Build dependencies:
- DistUtilsExtra
2020-04-03 20:40:35 +03:00
Dependencies:
- Gtk3
- Python3
Python modules:
- mpd (python-mpd2)
- gi (Gtk, Gio, Gdk, GdkPixbuf, Pango, GObject, GLib, Notify)
- requests
- bs4 (beautifulsoup)
- dbus
Run:
```bash
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
```
2020-01-11 13:25:15 +03:00
2020-09-02 12:44:29 +03:00
Translation
-----------
2020-09-02 23:54:51 +03:00
mpdevil is currently available in English and German. 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/
2020-09-02 12:44:29 +03:00