You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
 
 
 

205 lines
7.1 KiB

  1. .TH CINNAMON-SETTINGS 1 2019-02-10 Cinnamon "cinnamon manual"
  2. .SH NAME
  3. cinnamon-settings \- Configuration panel for cinnamon
  4. .SH SYNOPSIS
  5. .B cinnamon-settings [-h]
  6. .br
  7. \fBcinnamon-settings\fP MODULE [\fB-t\fP TAB]
  8. .br
  9. \fBcinnamon-settings\fP \fBapplets\fP PANEL
  10. .br
  11. \fBcinnamon-settings\fP \fBapplets\fP|\fBdesklets\fP|\fBextensions\fP [UUID [\fB-i\fP INSTANCE]] [\fB-t\fP TAB_INDEX]
  12. .br
  13. \fBcinnamon-settings\fP \fBapplets\fP|\fBdesklets\fP|\fBextensions\fP UUID INSTANCE
  14. .br
  15. \fBcinnamon-settings\fP \fBapplets\fP|\fBdesklets\fP|\fBextensions\fP|\fBthemes\fP [\fB-t\fP TAB]
  16. .br
  17. \fBcinnamon-settings\fP \fBapplets\fP|\fBdesklets\fP|\fBextensions\fP|\fBthemes -t download\fP [\fB-s\fP SORT]
  18. .SH DESCRIPTION
  19. .LP
  20. \fBcinnamon-settings\fP runs the graphical user interface allowing to configure Cinnamon.
  21. It can also be used to run the graphical user interface allowing to configure a specific module, add applets to a panel, and manage \fIxlets\fP.
  22. .SH MODULE
  23. Specifying a module allows to configure it directly.
  24. .br
  25. The following modules are available. You can use name or synonym.
  26. .br
  27. The modules with \fB*\fP have a configuration interface with tabs. Each tab can be directly opened (see TAB section below).
  28. .br
  29. The modules with \fB**\fP need root rights to open their configuration interface. So the only tab that will always be open is the first one.
  30. \fBNAME SYNONYMS\fP
  31. applets\fB*\fP
  32. backgrounds\fB*\fP background
  33. blueberry bluetooth
  34. calendar
  35. cinnamon-settings-users** users
  36. color colors
  37. default\fB*\fP
  38. desklets\fB*\fP
  39. desktop
  40. display screen, screens
  41. driver-manager\fB**\fP drivers
  42. effects\fB*\fP
  43. extensions\fB*\fP
  44. fonts
  45. general
  46. gufw** firewall
  47. hotcorner hotcorners
  48. info infos
  49. keyboard\fB*\fP
  50. lightdm-settings\fB**\fP login-screen
  51. mintlocale language, locale
  52. mintlocale-im input-method
  53. mintsources\fB**\fP sources
  54. mouse\fB*\fP
  55. network networks
  56. notifications
  57. nvidia-settings nvidia
  58. online-accounts accounts
  59. panel panels
  60. power\fB*\fP
  61. privacy
  62. screensaver\fB*\fP
  63. sound\fB*\fP
  64. startup
  65. system-config-printer printer, printers
  66. themes\fB*\fP
  67. tiling
  68. universal-access\fB*\fP accessibility
  69. user me
  70. wacom tablet
  71. windows\fB*\fP window
  72. workspaces\fB*\fP
  73. .SH "TAB and TAB_INDEX"
  74. Here the modules whose configuration interface contains tabs. Specifying its name or index by the \fB-t\fP option allows to open directly this tab in the configuration interface.
  75. .br
  76. \fBNAME\fP \fBTAB_NAME: TAB_INDEX, ...\fP
  77. universal-access visual: 0, keyboard: 1, typing: 2, mouse: 3
  78. applets installed: 0, more: 1, download: 1
  79. backgrounds images: 0, settings: 1
  80. default preferred: 0, removable: 1
  81. desklets installed: 0, more: 1, download: 1, general: 2
  82. effects effects: 0, customize: 1,
  83. extensions installed: 0, more: 1, download: 1
  84. keyboard typing: 0, shortcuts: 1, layouts: 2
  85. mouse mouse: 0, touchpad: 1,
  86. power power: 0, batteries: 1, brightness: 2
  87. screensaver settings: 0, customize: 1
  88. sound output: 0, input: 1, sounds: 2,
  89. applications: 3, settings: 4
  90. themes themes: 0, download: 1, options: 2
  91. windows titlebar: 0, behavior: 1, alttab: 2
  92. workspaces osd: 0, settings: 1
  93. .SH PANEL
  94. PANEL is the panel on which the user want install some \fBapplets\fP.
  95. User desktop can have up to four panels.
  96. .br
  97. \fBpanel1\fP is the first panel (panel by default).
  98. .br
  99. \fBpanel2\fP, \fBpanel3\fP and \fBpanel4\fP exist only if the user has created them.
  100. .SH "UUID and INSTANCE"
  101. The applets, desklets, extensions and themes are the \fIxlets\fP.
  102. .br
  103. Each xlet has an UUID (Universal Unique IDentifier). The structure of an UUID is xlet_name@author, except for themes.
  104. .br
  105. There are two kinds of xlets: System and Spices.
  106. .br
  107. System xlets are in \fB/usr/share/cinnamon/applets/\fP, \fB/usr/share/cinnamon/desklets/\fP and \fB/usr/share/themes/\fP; their UUID ends with '@cinnamon.org' except for themes. There is no system extension.
  108. .br
  109. Spices are xlets offered by developers to the Cinnamon team, which evaluates and validates them. Complete description of these Spices can be found at https://cinnamon-spices.linuxmint.com/.
  110. .br
  111. The Spices installed by user are in \fB~/.local/share/cinnamon\fP (for applets, desklets and extensions) and in \fB~/.themes\fP.
  112. INSTANCE argument is reserved to developers. When an applet or desklet has multiple instances, the configuration interface of each of them can be directly opened by this INSTANCE argument. Users have neither the possibility nor the need to know the value of INSTANCE.
  113. .SH SORT
  114. .TP
  115. Possible choices are:
  116. .br
  117. - \fBname\fP or \fB0\fP
  118. .br
  119. - \fBscore\fP or \fB1\fP (default value)
  120. .br
  121. - \fBdate\fP or \fB2\fP
  122. .br
  123. - \fBinstalled\fP or \fB3\fP
  124. .SH OPTIONS
  125. The following options are supported:
  126. .TP
  127. \fB-h\fP, \fB--help\fP
  128. Print a help text describing the supported command-line options, and then exit.
  129. .TP
  130. \fB-s\fP SORT, \fB--sort=\fPSORT
  131. Specific to the 'download' tab (see below) for \fBapplets\fP, \fBdesklets\fP, \fBextensions\fP and \fBthemes\fP modules.
  132. .TP
  133. \fB-t\fP TAB, \fB--tab=\fPTAB
  134. Select the tab to open in the settings. Possible choices are:
  135. - A number from 0 to \fIn\fP-1, where \fIn\fP is the number of available tabs.
  136. - The name of the tab (see list below).
  137. .SH EXAMPLES
  138. .TP
  139. To open System Settings:
  140. $ \fBcinnamon-settings\fP
  141. .TP
  142. To open the printer settings:
  143. .br
  144. $ \fBcinnamon-settings printers\fP
  145. .TP
  146. To open the settings of an installed applet, desklet or extension:
  147. $ \fBcinnamon-settings\fP TYPE UUID
  148. .br
  149. Examples:
  150. .br
  151. $ \fBcinnamon-settings applets SpicesUpdate@claudiux\fP
  152. .br
  153. $ \fBcinnamon-settings desklets photoframe@cinnamon.org\fP
  154. .br
  155. $ \fBcinnamon-settings extensions watermark@germanfr\fP
  156. .TP
  157. To add some applets on the second panel (if exists):
  158. $ \fBcinnamon-settings applets panel2\fP
  159. .TP
  160. To open the download tab of the applets settings:
  161. $ \fBcinnamon-settings applets --tab=download\fP
  162. .br
  163. or
  164. .br
  165. $ \fBcinnamon-settings applets -t 1\fP
  166. .TP
  167. To open the download tab of a type of Spices (applets, desklets, extensions, themes), sorting them by 'name', 'score', 'date' or 'installed', use the '--sort=' or '-s' argument:
  168. .br
  169. $ \fBcinnamon-settings TYPE --tab=download --sort=SORT\fP
  170. .br
  171. or
  172. .br
  173. $ \fBcinnamon-settings TYPE -t 1 -s SORT\fP
  174. .br
  175. where TYPE can be \fBapplets\fP, \fBdesklets\fP, \fBextensions\fP or \fBthemes\fP
  176. .br
  177. and SORT can be \fBname\fP (or \fB0\fP), \fBscore\fP (or \fB1\fP), \fBdate\fP (or \fB2\fP), \fBinstalled\fP (or \fB3\fP)
  178. Example:
  179. .br
  180. $ \fBcinnamon-settings applets -t 1 -s date\fP
  181. .SH "SEE ALSO"
  182. .BR cinnamon-menu-editor (1)
  183. .SH "CONTRIBUTORS"
  184. Nicolas Bourdaud (nbourdau) and Claude Clerc (claudiux).