kosteron/conky

A private place for my conky widget

Conky

Conky is a free, light-weight system monitor for X, that displays any kind of information on your desktop.

You can find more information about conky 👉 here

Motivation

The main reason for this repository is to save in one place and thus be able to share some work on the awesome personalization tool named conky

I really liked the design work provided by gvoze32 with the Mainte theme (See here). And I wanted to take this style and apply it to other widgets on my desktop.

Screenshots

Features

Actually the gadgets can do :

• Show and Monitor computer metric like fan speed, processor use etc... (Use the awesome conky theme Mainte)
• Show local weather (Use the awesome http://wttr.in/ to show the local weather)
• Show a little calendar
• And much more !

Installation

For those who want to try this conky's themes, here’s a step by step how to setup guide:

1. First of all, open terminal and install conky if you don’t have it via command:

sudo pacman -S conky

you may want to install optionnal package, please refer to the table below

2. Clone this repository

git clone https://github.com/Kosteron/Conky.git

3. Copy all folder to ~/.conky (set hidden file to visible on your file manager cause the folder is hidden) or create this folder if it doesnt exist :

mkdir ~/.conky
mv Conky-master/* ~/.conky

4. Open terminal and type

cd ~/.conky/
./conky-launch.sh

5. Move the font to your font folder :

sudo mv ~/.conky/fonts/* /usr/share/fonts

6. You may have to change some parameters like resolution or position to match your actual linux desktop characteristics. So edit conky-rc file and change this kind of parameter for the position on your screen :

conky.config = {
...
gap_x = 10,
gap_y = 520,
...
};

Usage

This relatively simple tool, takes care of part of your work, it allows you to generate a launch script automatically for conky from the configuration files present in the folder conf.

bash conky-configure.sh

If you want to add a conky widget managed by this tool, you must create a folder and its associated configuration file with the same name. Actually this tool don't support complex conky widget who need multiple bash/python script to operate.

To add a description for your conky widget add a comment on the top of your conky config :

-- My description

conky.config = {
    background = false,
    font = 'Fantasque Sans Mono:size=10',
	...

If you don't want to manage your conky-launch.sh with this tool, instead edit it manually ;)

Edit the conky-launch.sh and uncomment or comment the lines corresponding to the widgets you don't want

To automatically run when startup, just add conky-launch.sh to autostart.

Full detail

Check the following tweak column to see how to modify the widgets to suit your needs.

Name	Dependencies	Description	Tweak
conky-calendar	ncal	Simple Calendar	✖️
conky-clock	✖️	Simple clock	✖️
conky-exploded-view	acpi	Show computer metrics	✖️
conky-computer-metrics	acpi	Show computer metrics	✖️
conky-fortune	fortune-mod	Displays fortune cookie on the desktop	✖️
conky-mini-moc-player	mocp, ffmpeg	Display information about the current song listened with mocp	✖️
conky-pingbeat	✖️	Simple pingbeat	doc
conky-weather	✖️	Display a lot of information about weather	doc
conky-xfce-workspace-indicator	✖️	Simple workspace indicator	✖️
conky-altcoin-monitor	jq & awk	Simple altcoin price indicator	doc
conky-rss-reader	conky-all	Simple RSS Reader	doc
conky-bluetooth-monitor	bluetoothctl	Simple Bluetooth Monitor	doc

Credits

Many thanks to :

• Vector
• gvoze32, who inspired me, and where I took the graphic design for the other conky's widgets
  • Reddit Thread
  • Github repository
• Igor chubin
  • Github repository

License

MIT © Kosteron

conky's Issues

Command Not Found

I followed the installtion steps but when I tried to execute the "conky-launch.sh" by ./conky-launch.sh, it shows:

sh: line 1: xdpyinfo: command not found
sh: line 1: ncal: command not found

and Showing this untill I kill the terminal, where is wrong?

Crontab for weather data puling

Hi there. Many thanks for your scripts, they helped me much to understand conky better and to tune it for my needs.

A suggestion: wouldn't it be better practice to:

1. move that weather data pulling schedule to a crontab instead of sleep 600 inside infinite while loop?
   

   Conky/conky_weather/weather-pull.sh

   Line 6 in fb1b127

   sleep 600

2. increase the pulling interval to at least once an hour
   • I don't think it really makes sense to pull weather forecast every 10 mins
   • Meanwile wttr.in has limited number of queries to the weather service. So I think It wouldn't be considered a good practice to waste its limits with unnecessary frequent requests. @chubin what do you think?

Thanks!