mpdevil/README.md

79 lines
2.5 KiB
Markdown
Raw Normal View History

2020-01-11 13:25:15 +03:00
README for mpdevil
==================
2022-03-19 10:23:42 +03:00
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.
2020-01-11 13:25:15 +03:00
2022-04-07 13:43:36 +03:00
![ScreenShot](screenshots/mainwindow_1.7.0.png)
2020-01-11 17:09:10 +03:00
2020-01-11 13:58:55 +03:00
Features
--------
2020-12-12 15:30:12 +03:00
- display large covers
2022-03-19 10:23:42 +03:00
- play songs without double click
- lyrics from: https://www.letras.mus.br
2020-04-03 20:40:35 +03:00
- MPRIS interface (based on mpDris2)
2022-03-19 10:23:42 +03:00
- manage multiple MPD servers
2022-02-24 15:15:32 +03:00
- basic queue manipulation (move and delete single tracks)
- save and load playlists
2020-01-12 17:32:02 +03:00
2020-04-06 22:20:55 +03:00
See: https://github.com/SoongNoonien/mpdevil/wiki/Usage
2022-03-19 10:23:42 +03:00
2020-08-03 10:54:31 +03:00
Package Installation
--------------------
See:
https://github.com/SoongNoonien/mpdevil/releases/latest
2022-03-19 10:23:42 +03:00
2020-09-03 17:51:49 +03:00
Ubuntu, Debian, Mint, Raspberry Pi OS:
2020-08-03 10:54:31 +03:00
- 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`
2020-12-28 15:45:12 +03:00
Flatpak:
<a href='https://flathub.org/apps/details/org.mpdevil.mpdevil'><img width='240' alt='Download on Flathub' src='https://flathub.org/assets/badges/flathub-badge-en.png'/></a>
2020-08-03 10:54:31 +03:00
Building
--------
2020-01-11 13:25:15 +03:00
Build dependencies:
2021-12-29 16:03:25 +03:00
- meson
2020-04-03 20:40:35 +03:00
Dependencies:
2022-03-19 10:23:42 +03:00
- GTK3
2020-04-03 20:40:35 +03:00
- Python3
Python modules:
- mpd (python-mpd2 >=1.1)
2022-03-15 19:18:43 +03:00
- gi (Gtk, Gio, Gdk, GdkPixbuf, Pango, GObject, GLib)
2020-04-03 20:40:35 +03:00
Run:
```bash
git clone https://github.com/SoongNoonien/mpdevil.git
cd mpdevil
2021-12-29 16:03:25 +03:00
meson 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
```
2020-01-11 13:25:15 +03:00
2020-09-02 12:44:29 +03:00
Translation
-----------
2022-03-19 10:23:42 +03:00
mpdevil is currently available in English, German, Dutch, Bulgarian and Turkish. If you speak 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](#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