
-------------------------------
     Conky musicplayer V2
-------------------------------

A themable and clickable conky musicplayer. Can be used with Qmmp or Audacious.

Depends on:  conky, audacious, audtool, qmmp, playerctl, ffmpeg, convert, sacad, cava, xdotool, xinput, xprop, xwininfo, wmctrl


__ In case of sacad, it is included in the install folder. Sacad searches the internet for cover/album art.
   Unpack and copy the 2 files to a folder that's in the PATH environment. For example: /usr/bin or /usr/local/bin
   Or run the install-sacad.sh with sudo rights.


__ In case of cava, you need to build it. This creates a stereo datastream for the vu-meters.
   Open a terminal and run:
     sudo apt install git build-essential libfftw3-dev libasound2-dev libpulse-dev libtool automake libiniparser-dev libsdl2-2.0-0 libsdl2-dev libpipewire-0.3-dev libjack-jackd2-dev pkgconf
     git clone https://github.com/karlstav/cava
     cd cava
     ./autogen.sh
     ./configure
     make
     make install  (if that fails with error 2, copy the cava binary by hand to /usr/local/bin)

   Now if you run 'cava -v' it should display cava with version nr.


__ In the install folder is an install-fonts.sh that installs a few fonts. The fonts will be installed into ~/.local.share/fonts/conky-musicplayer


__ Player.ini has 8 settings:
     * player        (atm only audacious or qmmp)
     * mouseevents   (let lua or bash control mouse events)
     * theme         (pick a nice theme)
     * cwalignment   (alignment of conky window ex top_middle or top_left etc.)
     * cwgapx        (position x of the conky window)
     * cwgapy        (position y of the conky window)
     * icoverart     (search internet if mediafile has no coverart)
     * showupdates   (show a clickable warning if there is a new update)
     * mouseid       (check with 'xinput list' what your mouse id is. Used for click events)


__ In the theme folder is a <themename>.ini that has text, image and bar settings for that theme.
   If you want to make your own theme, copy one of the theme ini files and edit the settings in it.
   The filename of the new ini is the theme name in player.ini
   The glass themes have the most options in it!
   See images folder for different buttons, backgrounds and vu-meters.


__ If there is a new update, your player shows a yellow bar with the text "CLICK FOR NEW UPDATE".
   If you click on it, it opens an internet browser to https://www.cobrasoft.nl/download/conky/musicplayer
   for the latest update. In player.conky at the top you can also see which version your are using now.


__ This conky can not be started from within ConkyManager or from the terminal with 'conky -c'!
   You need to start it with the start script and stop with the script or click in the top right corner
   of the conky to terminate.


__ Click events in the conky window
     * Left click on top right corder terminates the conky
     * Left click on the media player buttons
     * Scrolling over the VU meters adjusts the volume up/down
     * Scrolling over the time bar adjusts the position of the song up/down 5 seconds
     * Left click on the coverart opens the picture in your standard picture browser


Have fun! ;)


Original idea by Loutch on linuxmint forum
Scripted out by Koentje on linuxmint forum    (remon@cobrasoft.nl)

