README.txt file for Conky Basic MkII by Moob (<moobvda@gmail.com>) Version 1.0 28-8-2017

This Conky widget draws a Basic Conky interface to display system information. By means of mouse clicks or drag-and-drop the layout and contents of the widget can be changed.

Does not work on virtual machines due to the lack of hardware sensors !! 

NOTE
On laptops your milage may vary as touchpads might not alway give back the correct mouse cursor location. Also the battery is not yet available. Still working on that :)


Installation:
 unpack the source file
 copy the file .conkybasicactive to your home directory
 copy the file .conkybasicactive_c110 to your home directory
 copy the basicactive folder into ~/.lua
 install the Unique font in ~/.lua/basicactive

Usage: 
 'conky -c .conkybasicactive -q' or if you are using conky 1.10.x 'conky -c .conkybasic_c110 -q'

Prerequisites : 
 lm-sensors, xinput, xdotool, xwininfo, Conky version 1.9 / 1.10.0 (with work-arounds in this code)

Files:
 config.conf - configuration file to store the conky layout. This file is read at startup and written when the layout changes
 mouse_tools.lua - mouse functionality for conky.
 basicactive.lua - main code
 Unique.ttf - font being used by this conky
 README.txt - the file you are reading now.
 .conkybasicactive(_c110) - conky startup files


Conky Basic MkII:

This conky is a fork of ConkyBasic, a conky I created some time ago, and I made this an interactive one.
So no need for changing lua files anymore to change the apperance of your conky. Just use your mouse and click to drag-and-drop.

All configuration information about the panel layout and its content is stored in config.conf The configuration is loaded on startup and saved when you change something.

The panels all have controle surfaces, an area on where mousebutton presses are detected. Some panels just have one control surface, others have more than one.
When you press a mousebutton, the controle surface will light up.

Use the leftmouse button you select the panel you want to move. Click it and keep it pressed, then move your mouse to the panel you want to swap it with. When it is highlighted release the button.

Use the rightmouse button to change the contents of a panel. 
The system tray has 5 control surfaces. Upper left, will change the panel background. Upper right, will change the VU bars. Left and Right, will cycle through the available themes.
Bottom will change the system information displayed.

Adding a theme:
You can create your own theme. First add the name of your theme to the table panel.traystate
After this add an if block statement below "--theme selection"
Example
	if use_theme == "mytheme" then
		theme.cur={bred=.6,bgreen=0,bblue=0,tred=1,tgreen=1,tblue=1,fred=.2,fgreen=.2,fblue=.2,fill=panel.fl,colorbar=panel.cb}
	end

bred,bgreen and bblue are the color definitions for the panel border
tred,tgreen and tblue are the color definitions for text inside the panel
fred,fgreen and fblue are the color definitions for the panel background

fill and colorbar always have fixed values, like shown in the example. fill determines if a panel has a background color or is transparent.
colorbar determines if VU bars are shown in color or not.


