README
1
2
3 ..|''|| '||' '|' '||' '|| ||' '||' '|' '||''|.
4 .|' || || | || ||| ||| || | || ||
5 || || || | || |'|..'|| || | ||...|'
6 '|. '. '| || | || | '|' || || | ||
7 '|...'|. '|..' .||. .|. | .||. '|..' .||.
8
9 __________________________________________________________________________
10
11 QUIMUP
12 version 1.4.4
13
14 for MPD 0.17.0 and above
15
16 quimup@jhanalog.com
17
18 __________________________________________________________________________
19
20 QUIMUP is a client for the Music Player Daemon (MPD) written in c++ and
21 QT5. The program can be used with most Linux desktops (KDE, GNOME, XFCE)
22 and is covered by the General Public License (see LICENSE below).
23
24 The clean interface makes controlling MPD's features easy and intuitive.
25 The focus is on mouse handling: playlist management is done entirely by
26 drag-&-drop; all playback functions are accessible from the system tray.
27 Quimup aims to turn MPD into a perfect desktop music player.
28
29 Copyright (C) 2008 - 2018 Johan Spee
30 __________________________________________________________________________
31
32 LICENSE
33
34 This program is free software; you can redistribute it and/or modify
35 it under the terms of the GNU General Public License as published by
36 the Free Software Foundation; either version 2 of the License, or
37 (at your option) any later version.
38
39 This program is distributed in the hope that it will be useful,
40 but WITHOUT ANY WARRANTY; without even the implied warranty of
41 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
42 General Public License for more details.
43
44 You should have received a copy of the GNU General Public License
45 along with this program (the file named COPYING).
46 If not, see http://www.gnu.org/licenses/
47 __________________________________________________________________________
48
49 DEPENDENCIES
50
51 REQUIRES : MPD (>= 0.17)
52
53 DEPENDS : libmpdclient2 (>= 2.3 )
54 DEPENDS : taglib (>= 1.11 )
55
56 QT 5:
57 DEPENDS : qtcore (>= 5.1 )
58 DEPENDS : qtgui (>= 5.1 )
59 DEPENDS : qtnetwork (>= 5.1 )
60
61
62 To COMPILE from source additionally install the QT5, libmpdclient and
63 taglib development files.
64 QT5 may inlude qtbase-dev, qt5-default, qmake-qt5, qt-creator.. etc.
65
66 Plus the usual: qmake, make, gcc, cpp, g++, pkg-config, autoconf etc.
67
68 [1] To create the makefile run: qmake (or qmake-qt5).
69
70 [2] To compile, next run: make.
71
72 [3] To install the binary:
73 sudo cp ./quimup /usr/bin/quimup
74 (or run it from the source directory)
75 __________________________________________________________________________
76
77 KDE, GNOME and XFCE
78
79 Altough the program depends on some QT5 libraries it does not require KDE
80 or depend on other KDE libraries, nor is it integrated with KDE in any way.
81
82 __________________________________________________________________________
83
84 ** USING QUIMUP **
85
86 CHECK OUT : FAQ.txt
87 CHECK OUT : TIPS IN THE SETTINGS WINDOW's ABOUT TAB
88
89 If MPD is configured correctly it's all click, drag and drop really.
90
91 EXTERNAL FILES
92
93 Files that are not in the database can be dropped on the player or on the
94 playlist. Alternatively use the 'send to' or 'open with' command in your
95 file manager or create a custom 'action'(pass %U or %F).
96
97 But ..this will only work if the connection with mpd is established through
98 a so called socket. In MPD's configuration file the 'bind_to_address' must
99 point to "/home/USER/.mpd/socket" (replace USER with the name of your home
100 dir). In Quimup's login profile (in the settings window) 'Host' must be
101 set exactly the same.
102
103 It may be necessary to associate relevant file types to 'open with'
104 Quimup (this is usually done in the file's 'properties' tab). Make sure
105 to use 'quimup %U' rather than just 'quimup' as command.
106 __________________________________________________________________________
107
108