Cinnamon 1.8 settings API – some lesser-known bits
by mtwebster 4

There are a few features of the new settings API I’d like to touch on, that may be less than obvious, but which might help you in this transition period…

Metadata Options

Every applet (and desklet and extension) has a metadata.json file – this, at minimum, has the uuidthe name, and a brief description of your applet.  You’re a busy guy or gal – you haven’t had time or the energy to stop what you’re doing and begin upgrading your applet to use this new API.  You can, however, begin to ease your way into it.

If you’ve already got a program you wrote for configuring your applet, you can define it using the   external-configuration-app key in your metadata file.  Doing this will add a ‘Configure’ button to the applet manager in Cinnamon Settings, and allow the user to launch the configuration directly from that panel, the same way he could if you were using the API.  Just be sure to make this program executable before zipping it up, and be sure it’s in the applet’s directory.

Command line launching

No matter how your applet settings are implemented, be it natively or as described above, you can directly open either the settings page or your settings program from the command line, which can be handy to use directly from your applet:

cinnamon-settings applets

This will launch Cinnamon Settings, open the applets panel, and then go directly into the settings for your applet (or launch your external program).


Small things like this will help to ease the into the new features of Cinnamon 1.8.  Once you’ve fully adapted your applet, it can be a seamless transition from an external setup program to native configuration.


4 thoughts on “Cinnamon 1.8 settings API – some lesser-known bits

  1. Sam Burgos May 23,2013 15:47

    Nice touch to start at least how to understand how this work, just one question. Does this work in any Linux Mint version with Cinnamon 1.8 or is just specific to some versions of Linux Mint? I don’t know if I explain myself with this (I hope I do)

  2. chambead May 23,2013 22:58

    I’d really like to develop applets for mint. Can anyone point me at a good tutorial?

  3. Taz4AD Sep 9,2013 17:06

    @chambead – I’m trying to pull together all the references I can find. Here’s what I have so far:

    If anyone has more information, please let me know. Also, it’s a wiki so if you’d like to collaborate, let me know.

Comments are closed.