1CINNAMON-SETTINGS(1)            cinnamon manual           CINNAMON-SETTINGS(1)
2
3
4

NAME

6       cinnamon-settings - Configuration panel for cinnamon
7

SYNOPSIS

9       cinnamon-settings [-h]
10       cinnamon-settings MODULE [-t TAB]
11       cinnamon-settings applets PANEL
12       cinnamon-settings  applets|desklets|extensions [UUID [-i INSTANCE]] [-t
13       TAB_INDEX]
14       cinnamon-settings applets|desklets|extensions UUID INSTANCE
15       cinnamon-settings applets|desklets|extensions|themes [-t TAB]
16       cinnamon-settings applets|desklets|extensions|themes  -t  download  [-s
17       SORT]
18

DESCRIPTION

20       cinnamon-settings runs the graphical user interface allowing to config‐
21       ure Cinnamon.
22
23       It can also be used to run the graphical  user  interface  allowing  to
24       configure a specific module, add applets to a panel, and manage xlets.
25

MODULE

27       Specifying a module allows to configure it directly.
28       The following modules are available. You can use name or synonym.
29       The  modules  with * have a configuration interface with tabs. Each tab
30       can be directly opened (see TAB section below).
31       The modules with ** need root rights to open their configuration inter‐
32       face. So the only tab that will always be open is the first one.
33
34           NAME                      SYNONYMS
35           applets*
36           backgrounds*              background
37           blueberry                 bluetooth
38           calendar
39           cinnamon-settings-users** users
40           color                     colors
41           default*
42           desklets*
43           desktop
44           display                   screen, screens
45           driver-manager**          drivers
46           effects*
47           extensions*
48           fonts
49           general
50           gufw**                    firewall
51           hotcorner                 hotcorners
52           info                      infos
53           keyboard*
54           lightdm-settings**        login-screen
55           mintlocale                language, locale
56           mintlocale-im             input-method
57           mintsources**             sources
58           mouse*
59           network                   networks
60           notifications
61           nvidia-settings           nvidia
62           online-accounts           accounts
63           panel                     panels
64           power*
65           privacy
66           screensaver*
67           sound*
68           startup
69           system-config-printer     printer, printers
70           themes*
71           tiling
72           universal-access*         accessibility
73           user                      me
74           wacom                     tablet
75           windows*                  window
76           workspaces*
77
78

TAB and TAB_INDEX

80       Here  the modules whose configuration interface contains tabs. Specify‐
81       ing its name or index by the -t option allows to open directly this tab
82       in the configuration interface.
83
84           NAME              TAB_NAME: TAB_INDEX, ...
85           universal-access  visual: 0, keyboard: 1, typing: 2, mouse: 3
86           applets           installed: 0, more: 1, download: 1
87           backgrounds       images: 0, settings: 1
88           default           preferred: 0, removable: 1
89           desklets          installed: 0, more: 1, download: 1, general: 2
90           effects           effects: 0, customize: 1,
91           extensions        installed: 0, more: 1, download: 1
92           keyboard          typing: 0, shortcuts: 1, layouts: 2
93           mouse             mouse: 0, touchpad: 1,
94           power             power: 0, batteries: 1, brightness: 2
95           screensaver       settings: 0, customize: 1
96           sound             output: 0, input: 1, sounds: 2,
97                             applications: 3, settings: 4
98           themes            themes: 0, download: 1, options: 2
99           windows           titlebar: 0, behavior: 1, alttab: 2
100           workspaces        osd: 0, settings: 1
101
102

PANEL

104       PANEL  is  the panel on which the user want install some applets.  User
105       desktop can have up to four panels.
106       panel1 is the first panel (panel by default).
107       panel2, panel3 and panel4 exist only if the user has created them.
108
109

UUID and INSTANCE

111       The applets, desklets, extensions and themes are the xlets.
112
113       Each xlet has an UUID (Universal Unique IDentifier). The  structure  of
114       an UUID is xlet_name@author, except for themes.
115
116       There are two kinds of xlets: System and Spices.
117
118       System  xlets  are  in  /usr/share/cinnamon/applets/, /usr/share/cinna‐
119       mon/desklets/ and /usr/share/themes/; their  UUID  ends  with  '@cinna‐
120       mon.org' except for themes. There is no system extension.
121
122       Spices  are  xlets  offered  by  developers to the Cinnamon team, which
123       evaluates and validates them. Complete description of these Spices  can
124       be found at https://cinnamon-spices.linuxmint.com/.
125       The  Spices  installed  by  user  are  in  ~/.local/share/cinnamon (for
126       applets, desklets and extensions) and in ~/.themes.
127
128       INSTANCE argument is reserved to developers. When an applet or  desklet
129       has multiple instances, the configuration interface of each of them can
130       be directly opened by this INSTANCE argument. Users  have  neither  the
131       possibility nor the need to know the value of INSTANCE.
132
133

SORT

135       Possible choices are:
136               - name or 0
137               - score or 1 (default value)
138               - date or 2
139               - installed or 3
140               - update or 4 (upgradable Spices first, then acts as date)
141
142

OPTIONS

144       The following options are supported:
145
146       -h, --help
147              Print a help text describing the supported command-line options,
148              and then exit.
149
150       -s SORT, --sort=SORT
151              Specific  to  the  'download'  tab  (see  below)  for   applets,
152              desklets, extensions and themes modules.
153
154       -t TAB, --tab=TAB
155              Select the tab to open in the settings. Possible choices are:
156               -  A  number  from 0 to n-1, where n is the number of available
157              tabs.
158               - The name of the tab (see list below).
159
160

EXAMPLES

162       To open System Settings:
163              $ cinnamon-settings
164
165
166       To open the printer settings:
167              $ cinnamon-settings printers
168
169
170       To open the settings of an installed applet, desklet or extension:
171              $ cinnamon-settings TYPE UUID
172              Examples:
173              $ cinnamon-settings applets SpicesUpdate@claudiux
174              $ cinnamon-settings desklets photoframe@cinnamon.org
175              $ cinnamon-settings extensions watermark@germanfr
176
177       To add some applets on the second panel (if exists):
178              $ cinnamon-settings applets panel2
179
180       To open the download tab of the applets settings:
181              $ cinnamon-settings applets --tab=download
182              or
183              $ cinnamon-settings applets -t 1
184
185
186       To open the download tab of a type of Spices (applets, desklets, exten‐
187       sions, themes), sorting them by 'name', 'score', 'date', 'installed' or
188       'update', use the '--sort=' or '-s' argument:
189              $ cinnamon-settings TYPE --tab=download --sort=SORT
190              or
191              $ cinnamon-settings TYPE -t 1 -s SORT
192              where TYPE can be applets, desklets, extensions or themes
193              and SORT can be  name  (or  0),  score  (or  1),  date  (or  2),
194              installed (or 3), update (or 4)
195
196              Example:
197              $ cinnamon-settings applets -t 1 -s date
198
199

SEE ALSO

201       cinnamon-menu-editor(1)
202
203

CONTRIBUTORS

205       Claude Clerc (claudiux) and Nicolas Bourdaud (nbourdau).
206
207
208
209Cinnamon                          2019-02-10              CINNAMON-SETTINGS(1)
Impressum