# -----------------------------------------------------------------------------
#  # 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 - Dependencias: 

	- Ubuntu: conky-all jq curl imagemagick

	- Manjaro: conky-lua conky-lua-nv (conky-lua-nv, si tienes una gráfica nvidia), lua cairo curl imagemagick glib2 imlib2 libpulse librsvg libxdamage libxft libxinerama libxml2 libxnvctrl wireless_tools 
	
# -----------------------------------------------------------------------------

2 - Instalación:
	
	- Editar el archivo "your-settings-here" con los siguientes datos:
		1: nombre de usuario.
		2: nombre de la interfase de red por la que se accede a internet.
		3: cityid: es el número identificador de tu ciudad para la api del clima. Debes obtenerlo aquí https://openweathermap.org/ escribes el nombre de la ciudad en el buscador, en la página de resultados le das clic a tu ciudad, y abrirá un enlace similar a este https://openweathermap.org/city/3441575 ese número final de la URL "3441575" es el cityid.
		4: el nombre del reproductor de música que utilizas. Se han realizado pruebas con: rhythmbox, clementine, spotify, y vlc. spotify y vlc no muestran las imágenes de los albums. Es posible funcione con otros reproductores, pero no es seguro. Importante: solo puedes configurar un reproductor en el archivo "your-settings-here". Si deseas cambiarlo será necesario desinstalar y re instalar con la nueva configuración.
		5: el código de idioma: en, es. Inicialmente es el código que utiliza la api del clima, para mostrar el estado del clima; pero ha sido utilizado para traducir algunas de las palabras del theme. Si se desea utilizar un idioma diferente al inglés o castellano, deberá editarse el archivo install.sh para agregar esta posibilidad; de lo contrario la traducción solo se verá en el estado del clima, y el resto se mostrará en inglés.
	
	- Abrir una terminal en la carpeta extraida y ejecutar sudo ./install.sh
		Se instalarán varios archivos en diferentes partes del sistema. La carpeta base de la instalación es /opt/foraz/conky. Si se desean hacer cambios permanentes deberían realizarse en los archivos de /opt/foraz/conky/conf. Cualquier cambio que no se realice en los archivos de esta carpeta, ser perderán al cambiar los themes prestablecidos de light-dark o modificar los colores.
		
# -----------------------------------------------------------------------------

3 - Información adicional

	Hay varios lanzadores para facilitar algunas acciones, puedes buscar conkyrc en el menú o con alt+F2. También puedes ejecutar algunos comandos en la terminal con conkyrc. Para las opciones avanzadas de personalización de colores es necesario entrar a la carpeta de instalación y luego ejecutar el archivo colors.sh:
	
	cd /opt/foraz/conky/ && ./colors.sh
	
	colors.sh permite modificar los colores de forma personalizada y aleatoria. También brinda la posibilidad de guardar y restaurar colores guardados.
	
# -----------------------------------------------------------------------------

4 - Nota final:
	
	Los scripts no son perfectos. Si no haces las cosas en la forma debida, se puede "romper" algo en los archivos de configuración, y conky no mostrará las cosas de forma correcta. Si esto sucede simplemente vuelve a cargar el light o dark theme, o alguno de los themes que has guardado con colors.sh para solucionarlo.
	
	El theme está armado para una resolución de 1920x1080. Para una resolución inferior no va a ir bien.


