Skip to content

Widgets&Themes

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

ManageConky Widget / Theme Directory Scheme:

Widgets

  • 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)
Notes:
  • The only files to be extension-less should be conky-configs
  • All other files are ignored by ManageConky, for example: images, lua-scripts etc.
    Anything slips in, hide it using this.

Themes

You can create conky themes in 2 ways:

✔ the old-way: conky-manager .cmtheme file
✔ the new way: ManageConky property list file

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: ⛏⛏⛏ (Working on it)

  • 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

Elements (directories / files) that accidently show up in ManageConky's Widgets or Themes list can be hidden.
Click on the element you want to hide like and then on the Ignore button.

Clone this wiki locally