Skip to content

Widgets&Themes

Jump to bottom
npyl edited this page Jul 28, 2018 · 9 revisions

ManageConky Widget / Theme Directory Scheme:

Widgets

  • In each directory containing Widget(s) all conky-configs should be named without extension
  • A source.txt contains link to where Widget can be found online
  • A creator.txt holds the the name(s) of the creator(s)
Warnings:
  • The only files to be extension-less must be conky-configs
  • Whatever else you put in a widget's directory will be ignored by ManageConky. Thus, you can have images, lua scripts etc.

Themes

You can enable conky themes using two ways:

✔ the old-way: conky-manager cmtheme file
✔ the new way: ManageConky plist

Old-Way:

Create a .cmtheme file and fill its contents based on the scheme:

config1 location on disk
config2 location on disk
...
...
configN
wallpaper location on disk
wallpaper-scaling:XXXXX

WHERE XXXXX is one of the following options:

  • Fill Screen
  • Fit to Screen
  • Stretch to Fill Screen
  • Centre
  • Tile

New-Way:

  • Create a file named themerc.plist with a plist editor
  • Add the keys source, creator and wallpaper all of which are strings
  • Add the key configs which is an array of string's
  • Add an item in the array for each conky-config and write the location of it on disk.
  • Fill in the keys source, creator and wallpaper with the link where you found the theme online, the creator's name, and the location of the wallpaper on disk. INFO: the first two can be ignored, (you don't have to add them since the feature is not yet supported)
  • You can add the key startupDelay which will be a number and write the time in seconds you want conky to wait before showing the config.
RULES:
  • Paths can't be relative
  • Please do not try to use different scheme because it won't work! :D
  • ALL resources a conky-config uses should reside in the same directory as the conky-config, and this is the way you should write your config. (It appears that there is a bug in conky and it cannot load a resource from whatever path... Please open an issue if you want this to be fixed)

THATS it. If you have added the search paths correctly on ManageConky then your theme should be available for selecting.

Hide stuff from ManageConky

You can hide some elements (directories / files) by creating a .mcignore in Widget's / Theme's directory and adding the names of the elements you want to hide.

Clone this wiki locally