# -----------------------------------------------------------------------------
#  # conkyrc_foraz - teoforaz - teoforaz@gmail.com ----------------------------
#  # versión: conkyrc_foraz_theme_1.6.6 - 3/5/2020 ----------------------------
#  # License : Distributed under the terms of GNU GPL version 2 or later
# -----------------------------------------------------------------------------

1 - Dependencies: 

	- Ubuntu: conky-all jq curl imagemagick

	- Manjaro: conky-lua conky-lua-nv (conky-lua-nv, if you have an nvidia), lua cairo curl imagemagick glib2 imlib2 libpulse librsvg libxdamage libxft libxinerama libxml2 libxnvctrl wireless_tools 
	
# -----------------------------------------------------------------------------

2 - Installation:
	
	- Edit the file "your-settings-here" with the following data:
		1 - user name.
		2: name of the network interface through which you access the internet.
		3: cityid: this is the city identification number for the weather api. You must get it here https://openweathermap.org/ you write the name of the city in the search box, in the results page you click on your city, and it will open a link similar to this https://openweathermap.org/city/3441575 the final number of the URL "3441575" is the cityid.
		4: the name of the music player you use. Tests have been done with: rhythmbox, clementine, spotify, and vlc. spotify and vlc do not show album images. Maybe it's possible to work with other players, but it is not safe. Important: you can only configure one player in the "your-settings-here" file. If you want to change it, you will have to uninstall and reinstall it with the new settings.
		5: the language code: en, es. Initially is the code that uses the weather api, to show the weather status; but it has been used to translate some of the words in the theme. If you want to use a language other than English or Spanish, you must edit the install.sh file to add this possibility; otherwise the translation will only be seen in the weather state, and the rest will be shown in English.
	
	- Open a terminal in the extracted folder and run sudo ./install.sh
		Several files will be installed in different parts of the system. The base installation folder is /opt/foraz/conky. If you want to make permanent changes, you should make them in the files in /opt/foraz/conky/conf. Any changes that are not made to the files in this folder will be lost when changing the light-dark themes or the colors.
		
# -----------------------------------------------------------------------------

3 - Additional information

	There are several launchers to facilitate some actions, you can search conkyrc in the menu or with alt+F2. You can also execute some commands in the terminal with conkyrc. For advanced color customization options you need to enter the installation folder and run the colors.sh file:
	
	cd /opt/foraz/conky/ && ./colors.sh
	
	colors.sh allows you to modify colors in a personalized and random way. It also provides the possibility to save and restore saved colors.
	
# -----------------------------------------------------------------------------

4 - Final note:
	
	The scripts are not perfect. If you don't do things in the right way, you can "break" something in the configuration files, and conky will not display things correctly. If this happens just reload the light or dark theme, or one of the themes you saved with colors.sh to fix it.

	The theme is armed for a resolution of 1920x1080. For a lower resolution it won't go well.


