cinnamon-extension-tool
Manage Cinnamon desktop extensions
SYNOPSIS
cinnamon-extension-tool [OPTION] [UUID]
PARAMETERS
--enable UUID
Enable the spice (applet/desklet/extension/LNF) with given UUID
--disable UUID
Disable the spice with given UUID
--reset UUID
Reset spice settings to defaults
--list [--applet|--desklet|--extension|--lnf]
List installed spices; filter by type (default: all)
--reload
Reload Cinnamon shell and extensions
-h, --help
Show help usage
--version
Display version information
DESCRIPTION
The cinnamon-extension-tool is a command-line utility in the Cinnamon desktop environment, used to manage 'spices' such as applets, desklets, extensions, and look & feel (LNF) themes. It enables listing installed components, enabling/disabling them, resetting to defaults, and reloading the shell.
Spices are identified by unique UUIDs, obtainable via the --list option. This tool is ideal for automation, scripting, or headless management of Cinnamon desktops, bypassing the GUI Settings app.
Common workflow: list items with --list [--applet|--desklet|--extension|--lnf], then enable/disable using UUIDs. It communicates with the running Cinnamon session, so the desktop must be active. Changes apply immediately after reload if needed.
Part of Linux Mint's Cinnamon, it supports lightweight customization without graphical dependencies. UUIDs are case-sensitive and listed with status (enabled marked by *).
CAVEATS
Requires active Cinnamon session; run as logged-in user. UUIDs case-sensitive. No effect on uninstalled spices. May need --reload for UI updates.
FINDING UUIDS
Run cinnamon-extension-tool --list. Enabled shown as uuid * (name); disabled as uuid (name).
TYPES OVERVIEW
--applet: Panel applets.
--desklet: Desktop widgets.
--extension: Shell extensions.
--lnf: Look & feel themes.
HISTORY
Introduced in Cinnamon 2.4 (2014) by Linux Mint team; evolved with Cinnamon releases for CLI spice management, mirroring gnome-extensions CLI.
SEE ALSO
cinnamon-spices(7), cinnamon-settings(1), gnome-extensions(1)


