Difference between revisions of "Cinnamon"

From ArchWiki
Jump to: navigation, search
(Crashing/freezing with Intel Graphics after Gnome Shell update: capitalization fixes)
m (Manage languages used in Cinnamon: Add a small note as to where to find the keyboard layout settings)
 
(153 intermediate revisions by 41 users not shown)
Line 2: Line 2:
 
[[ja:Cinnamon]]
 
[[ja:Cinnamon]]
 
[[ru:Cinnamon]]
 
[[ru:Cinnamon]]
[[tr:Cinnamon_Masaüstü_Ortamı]]
+
[[tr:Cinnamon Masaüstü Ortamı]]
{{Article summary start}}
+
[[zh-CN:Cinnamon]]
{{Article summary text|This article covers basic installation procedures and configuration methods in Cinnamon.}}
+
{{Related articles start}}
{{Article summary heading|Related}}
+
{{Related|Nemo}}
{{Article summary wiki|GNOME}}: GNOME is the framework that Cinnamon is based on.
+
{{Related|GNOME}}
{{Article summary wiki|MATE}}: Another fork of GNOME that is geared towards a GNOME 2 experience.
+
{{Related|MATE}}
{{Article summary end}}
+
{{Related|Desktop environment}}
 +
{{Related|Display manager}}
 +
{{Related articles end}}
  
[http://cinnamon.linuxmint.com/ Cinnamon] is a Linux desktop which provides advanced innovative features and a traditional user experience.
+
[http://cinnamon.linuxmint.com/ Cinnamon] is a [[desktop environment]] which combines a traditional desktop layout with modern graphical effects. The underlying technology was forked from the [[GNOME]] desktop. As of version 2.0, Cinnamon is a complete desktop environment and not merely a frontend for GNOME like GNOME Shell and Unity.
The desktop layout is similar to GNOME 2; however, the underlying technology was forked from GNOME Shell.
+
The emphasis is put on making users feel at home and providing them with an easy to use and comfortable desktop experience.
+
  
==Installation==
+
== Installation ==
  
Cinnamon can be [[Pacman|installed]] with the package {{Pkg|cinnamon}}, available in the [[official repositories]].
+
Cinnamon can be [[installed]] with the package {{Pkg|cinnamon}}.
  
To get a complete desktop interface, install at least the following additional packages:
+
== Starting Cinnamon ==
* {{Pkg|cinnamon-control-center}}: provides access to various hardware and system settings within cinnamon-settings.
+
* {{Pkg|cinnamon-screensaver}}: provides a lock screen functionality.
+
* {{Pkg|nemo}}: Cinnamon's official file manager.
+
  
=== Starting Cinnamon ===
+
=== Graphical log-in ===
  
'''Graphical log-in'''
+
Choose ''Cinnamon'' or ''Cinnamon (Software Rendering)'' from the menu in a [[display manager]] of choice. Cinnamon is the 3D accelerated version, which should normally be used. If you experience problems with your video driver (e.g. artifacts or crashing), try the ''Cinnamon (Software Rendering)'' session, which disables 3D acceleration.
  
Simply choose '''Cinnamon''' or '''Cinnamon 2D''' session from your favourite [[display manager]]. Cinnamon is the 3D accelerated version, which should be normally used. If you experience problems with your video driver (e.g. artifacts or crashing), try the Cinnamon 2D session, which disables 3D acceleration.
+
=== Starting Cinnamon manually ===
  
'''Starting Cinnamon manually'''
+
If you prefer to start Cinnamon manually from the console, add the following line to [[Xinitrc]]:
  
If you prefer to start Cinnamon manually from the console, add the following line to your {{ic|~/.xinitrc}} file:
+
{{hc|~/.xinitrc|
{{hc|~/.xinitrc|<nowiki>
+
  exec cinnamon-session
  exec gnome-session-cinnamon
+
}}
</nowiki>}}
+
  
If the Cinnamon 2D session is required, use {{ic|gnome-session-cinnamon2d}} instead of {{ic|gnome-session-cinnamon}}.
+
If the ''Cinnamon (Software Rendering)'' session is required, use {{ic|cinnamon-session-cinnamon2d}} instead of {{ic|cinnamon-session}}.
  
After the {{ic|exec}} command is placed, Cinnamon can be launched by typing {{ic|startx}}. See [[xinitrc]] for details.
+
== Configuration ==
  
==Configuration==
+
Cinnamon is quite easy to configure &mdash; most common settings can be configured graphically. Its usability can be expanded with [http://cinnamon-spices.linuxmint.com/applets applets] and [http://cinnamon-spices.linuxmint.com/extensions extensions], and also it supports [http://cinnamon-spices.linuxmint.com/themes theming].
  
Cinnamon is quite easy to configure - a lot of the configuration that most people will want can be done graphically. Its usability can be customized with [http://cinnamon-spices.linuxmint.com/applets applets] and [http://cinnamon-spices.linuxmint.com/extensions extensions], and also it supports [http://cinnamon-spices.linuxmint.com/themes theming].
+
=== Cinnamon settings ===
  
===Cinnamon Settings===
+
''cinnamon-settings'' launches a settings module specified on the command line. Without (correct) arguments, it launches ''System Settings''. For example, to start the panel settings:
  
Simply run the following command:
+
$ cinnamon-settings panel
{{bc|cinnamon-settings}}
+
  
Each settings panel can be accessed directly with the following commands:
+
To list all available modules:
{{bc|cinnamon-settings panel
+
cinnamon-settings calendar
+
cinnamon-settings themes
+
cinnamon-settings applets
+
cinnamon-settings windows
+
cinnamon-settings fonts
+
cinnamon-settings hotcorner}} so on.
+
  
===Installing applets/extensions===
+
$ pacman -Ql cinnamon | awk -F'[_.]' '/cs_.+\.py/ {print $2}'
  
{{Note|Previously, {{AUR|cinnamon-extensions-git}} and {{AUR|cinnamon-themes-git}} were used to install some themes and extensions, but they are now deprecated (see [https://github.com/linuxmint/Cinnamon/issues/668 here]). Instead, visit http://cinnamon-spices.linuxmint.com/.}}
+
; Printers
 +
: For configure printers, install the {{Pkg|system-config-printer}} package.
 +
; Networking
 +
: To add support for the networking module, enable [[NetworkManager#Configuration|Network Manager]]. In order for NetworkManager to store Wi-Fi passwords, you will need to also install [[GNOME Keyring]].
 +
; Bluetooth
 +
: For Bluetooth device support, install the {{Pkg|blueberry}} package.
  
The difference between an applet and an extension is that an '''applet''' is basically an addition to a panel, whereas an '''extension''' can completely change the Cinnamon experience and can do much more than an applet.
+
=== Applets and extensions ===
  
There are quite a few packages in the [https://aur.archlinux.org/packages.php?O=0&K=cinnamon&do_Search=Go AUR] (AUR package search for cinnamon). The process described here is a generic installation process.
+
While an '''applet''' is an addition to the Cinnamon panel, an '''extension''' can fully change the Cinnamon experience. They can be installed from the [[AUR]], ([https://aur.archlinux.org/packages.php?O=0&K=cinnamon-&do_Search=Go package search]), or from inside Cinnamon (''Get more online''):
  
Installing applets in Cinnamon is relatively easy. First visit [http://cinnamon-spices.linuxmint.com/applets Cinnamon Applets] to see all of the current applets.
+
$ cinnamon-settings applets
Download the zip file for the desired applet, and extract to {{ic|~/.local/share/cinnamon/applets/}} or {{ic|/usr/share/cinnamon/applets}}.
+
$ cinnamon-settings extensions
Then run
+
{{bc|cinnamon-settings applets}}
+
to bring up the graphical applets manager. If the applet does not show up, press {{Keypress|Alt+F2}} and type {{ic|r}} and press {{keypress|Enter}}. This will restart gnome-shell and likely, the new applet.
+
  
The process is analogous for extensions, with the only difference being that directories titled "applets" can be changed to "extensions".
+
Alternatively, install manually from [http://cinnamon-spices.linuxmint.com/ Cinnamon spices].
  
==Tips and tricks==
+
{{Note|If applets do not appear, restart Cinnamon with {{ic|r}} in the {{ic|Alt+F2}} dialog box.}}
  
===Creating custom applets/themes===
+
=== Pressing power buttons suspend the system ===
The official tutorial on creating an '''applet''' can be found [http://cinnamon.linuxmint.com/?p=156 here], and on creating a '''custom theme''' can be found [http://cinnamon.linuxmint.com/?p=144 here].
+
  
===Default desktop background wallpaper path===
+
This is the default behaviour. To change the setting open the {{ic|cinnamon-settings}} panel and click on the "Power Management" option. Change the "When the power button is pressed" option to your desired behaviour.
When you add a wallpaper from a custom path in Cinnamon Settings, Cinnamon copies it to {{ic|~/.cinnamon/background}}. Thus, with every change of your wallpaper you would have to add your updated wallpaper again from the settings menu or copy / symlink it manually to {{ic|~/.cinnamon/background}}.
+
  
==Troubleshooting==
+
=== Manage languages used in Cinnamon ===
  
===QGtkStyle unable to detect the current theme===
+
{{Note|The language module was removed from the Cinnamon Control Panel with the release of Cinnamon 2.2. [http://segfault.linuxmint.com/2014/04/cinnamon-2-2/]}}
Installing {{Pkg|libgnome-data}} solves the problem partially, and QGtkStyle will detect the current GTK+ theme. However, to set the same icon and cursor theme, users must specify them explicitly.
+
  
The icon theme for Qt apps can be configured by the following command:
+
*To add/remove languages: see [[Locale]].
 +
*To change between enabled languages: install the {{AUR|mintlocale}} package.
 +
*To change the keyboard layout: navigate to '''System Settings > Hardware > Keyboard > Layouts'''.
  
$ gconftool-2 --set --type string /desktop/gnome/interface/icon_theme Faenza-Dark
+
== Tips and tricks ==
  
This sets the icon theme to Faenza-Dark located in {{ic|/usr/share/icons/Faenza-Dark}}.
+
=== Creating custom applets ===
  
The cursor theme for Qt apps can be selected by creating a symbolic link:
+
The official tutorial on creating a Cinnamon ''applet'' can be found [http://developer.linuxmint.com/reference/2.6/cinnamon-tutorials/write-applet.html here].
  
$ mkdir ~/==.icons
+
=== Default desktop background wallpaper path ===
$ ln -s /usr/share/icons/Adwaita ~/.icons/default
+
  
This sets the cursor theme to Adwaita located in {{ic|/usr/share/icons/Adwaita}}.
+
When you add a wallpaper from a custom path in Cinnamon Settings, Cinnamon copies it to {{ic|~/.cinnamon/backgrounds}}. Thus, with every change of your wallpaper you would have to add your updated wallpaper again from the settings menu or copy / symlink it manually to {{ic|~/.cinnamon/backgrounds}}.
  
===Pressing power buttons suspend the system===
+
=== Show home, filesystem desktop icons ===
This is the default behaviour. To show the shutdown menu for example, change the setting for the respective button:
+
  
$ gsettings set org.gnome.settings-daemon.plugins.power button-power 'interactive'
+
By default Cinnamon starts with desktop icons enabled but with no desktop icons on screen. To show desktop icons for the home folder, the filesystem, the trash, mounted volumes and network servers open Cinnamon settings and click on desktop. Enable the checkboxes of the icons you want to see on screen.
  
===Icons do not show on the desktop===
+
=== Menu editor ===
  
The desktop icons rendering feature is enabled in nemo, and disabled in nautilus by default. To enable this feature, change the setting for nemo:
+
The Menu applet supports launching custom commands. Right click on the applet, click on ''Configure...'' and then ''Open the menu editor''. Select a sub-menu (or create a new one) and select ''New Item''. Set ''Name'', ''Command'' and ''Comment''. Check the launch in terminal checkbox if needed. Leave unchecked for graphical applications. Click ''OK'' and close the menu editor afterwards. The launcher is added to the menu.
  
$ gsettings set org.nemo.desktop show-desktop-icons true
+
=== Workspaces ===
  
And for nautilus:
+
A workspace pager can be added to the panel. Right click the panel and choose the option ''Add applets to the panel''. Add the ''Workspace switch'' applet to the panel. To change its position right click on the panel and change the ''Panel edit mode'' on/off switch to on. Click and drag the switcher to the desired position and turn the panel edit mode off when finished.
  
$ gsettings set org.gnome.desktop.background show-desktop-icons true
+
By default there are 2 workspaces. To add more, hit {{ic|Control+Alt+Up}} to show all workspaces. Then click on the plus sign button on the right of the screen to add more workspaces.
  
Make sure to '''not''' enable both settings, otherwise the desktop icons will be not rendered. The feature can be disabled by calling the commands above, but replace 'true' with 'false'.
+
Alternatively, you can choose the number by command-line:
  
===Volume level is not saved===
+
$ gsettings set org.cinnamon.desktop.wm.preferences num-workspaces 4
The volume level is not be saved after reboot. The volume will be at 0 but not muted. Installing {{Pkg|alsa-utils}} will solve the problem.
+
  
===Applets not working===
+
Replacing 4 with the number of workspaces you want.
If audio or network applets don't work the user may be required to be added to the relevant groups (audio, network):
+
  
$ gpasswd -a [user] [group]
+
=== Hide desktop icons ===
  
===Crashing/freezing with Intel graphics after GNOME Shell update===
+
The desktop icons rendering feature is enabled in nemo by default. To disable this feature, change the setting with the following command:  
It is possible that the update to GNOME Shell 3.8 may be the cause of these issues. If Cinnamon worked prior to GNOME Shell 3.8, try creating {{ic|/etc/X11/xorg.conf.d/20-intel.conf}} and adding the following to it to enable SNA acceleration. More information about this can be found [https://wiki.archlinux.org/index.php/Intel_Graphics#Choose_acceleration_method here].
+
  
{{hc|/etc/X11/xorg.conf.d/20-intel.conf|
+
$ gsettings set org.nemo.desktop show-desktop-icons false
Section "Device"
+
 
  Identifier "Intel Graphics"
+
=== Themes and icons ===
  Driver      "intel"
+
 
  Option      "AccelMethod"  "sna"
+
Linux Mint styled themes and icons can be installed with the {{AUR|mint-x-theme}} and {{AUR|mint-x-icons}} packages. The themes can be edited in {{ic|Settings → Themes → Other settings}}.
EndSection}}
+
 
 +
Official Linux Mint Cinnamon themes can be installed using the {{AUR|mint-cinnamon-themes}} package.
 +
 
 +
=== Sound events ===
 +
 
 +
Cinnamon does not come with sounds used for events like the startup of the desktop that are also used in Linux Mint by default. These sound effects can be installed with the {{AUR|cinnamon-sound-effects}} and {{AUR|mint-sounds}} packages. The sound events can be edited in {{ic|Settings → Sound → Sound Effects}}.
 +
 
 +
=== Resize windows by mouse ===
 +
 
 +
To resize windows with {{ic|Alt+Right click}}, use {{ic|gsettings}}:
 +
 
 +
gsettings set org.cinnamon.desktop.wm.preferences resize-with-right-button true
 +
 
 +
=== Portable keybindings ===
 +
 
 +
To export your keyboard shortcut keys, you should do:
 +
 
 +
dconf dump /org/cinnamon/desktop/keybindings/ >keybindings-backup.dconf
 +
 
 +
To later import it (for example) on another computer, do:
 +
 
 +
dconf load /org/cinnamon/desktop/keybindings/ <keybindings-backup.dconf
 +
 
 +
=== Screenshot ===
 +
 
 +
As explained in [[Taking_a_screenshot#Cinnamon|Taking a screenshot]], installing {{Pkg|gnome-screenshot}} will add this functionality. The default shortcut key is {{ic|Prt Sc}} key. This binding ca be changed in the applet ''Menu > Preferences > Keyboard'' under ''Shortcuts > System > Screenshots and Recording''. The default save directory is {{ic|$HOME/Pictures}}, but can be customized with eg.
 +
 
 +
  $ gsettings set org.gnome.gnome-screenshot auto-save-directory file:///home/''USER''/''some_path''
 +
 
 +
== Troubleshooting ==
 +
 
 +
=== cinnamon-settings: No module named Image ===
 +
 
 +
If ''cinnamon-settings'' does not start with the message that it cannot find a certain module, e.g. the Image module, it is likely that it uses outdated compiled files which refer to no longer existing file locations. In this case remove all {{ic|*.pyc}} files in {{ic|/usr/lib/cinnamon-settings}} and its sub-folders. See the [https://github.com/linuxmint/Cinnamon/issues/2495 upstream bug report].
 +
 
 +
=== Video tearing ===
 +
 
 +
Because {{Pkg|muffin}} is based upon {{Pkg|mutter}}, video tearing fixes for [[GNOME]] should also work in Cinnamon. See [[GNOME/Troubleshooting#Tear-free video with Intel HD Graphics]] for more information.
 +
 
 +
=== Disable the NetworkManager applet ===
 +
 
 +
Even if you do not use [[NetworkManager]] and remove the ''Network Manager'' applet from the default panel, Cinnamon will still load ''nm-applet'' and display it in the system tray.
 +
You cannot uninstall the package, because it is required by {{Pkg|cinnamon}} and {{Pkg|cinnamon-control-center}}, but you can still easily disable it. To do so copy the autostart file from {{ic|/etc/xdg/autostart/nm-applet.desktop}} to {{ic|~/.config/autostart/nm-applet.desktop}}. Open it with your favorite text editor and add at the end {{ic|1=X-GNOME-Autostart-enabled=false}}.
 +
 
 +
Alternatively you can disable it is by creating the following symlink:
 +
 
 +
$ ln -s /bin/true /usr/local/bin/nm-applet
 +
 
 +
The ability to blacklist particular icons from the system tray (such as the ''nm-applet'' icon) has been [https://github.com/linuxmint/Cinnamon/issues/3318 requested upstream].

Latest revision as of 18:44, 29 May 2016

Cinnamon is a desktop environment which combines a traditional desktop layout with modern graphical effects. The underlying technology was forked from the GNOME desktop. As of version 2.0, Cinnamon is a complete desktop environment and not merely a frontend for GNOME like GNOME Shell and Unity.

Installation

Cinnamon can be installed with the package cinnamon.

Starting Cinnamon

Graphical log-in

Choose Cinnamon or Cinnamon (Software Rendering) from the menu in a display manager of choice. Cinnamon is the 3D accelerated version, which should normally be used. If you experience problems with your video driver (e.g. artifacts or crashing), try the Cinnamon (Software Rendering) session, which disables 3D acceleration.

Starting Cinnamon manually

If you prefer to start Cinnamon manually from the console, add the following line to Xinitrc:

~/.xinitrc
 exec cinnamon-session

If the Cinnamon (Software Rendering) session is required, use cinnamon-session-cinnamon2d instead of cinnamon-session.

Configuration

Cinnamon is quite easy to configure — most common settings can be configured graphically. Its usability can be expanded with applets and extensions, and also it supports theming.

Cinnamon settings

cinnamon-settings launches a settings module specified on the command line. Without (correct) arguments, it launches System Settings. For example, to start the panel settings:

$ cinnamon-settings panel

To list all available modules:

$ pacman -Ql cinnamon | awk -F'[_.]' '/cs_.+\.py/ {print $2}'
Printers
For configure printers, install the system-config-printer package.
Networking
To add support for the networking module, enable Network Manager. In order for NetworkManager to store Wi-Fi passwords, you will need to also install GNOME Keyring.
Bluetooth
For Bluetooth device support, install the blueberry package.

Applets and extensions

While an applet is an addition to the Cinnamon panel, an extension can fully change the Cinnamon experience. They can be installed from the AUR, (package search), or from inside Cinnamon (Get more online):

$ cinnamon-settings applets
$ cinnamon-settings extensions

Alternatively, install manually from Cinnamon spices.

Note: If applets do not appear, restart Cinnamon with r in the Alt+F2 dialog box.

Pressing power buttons suspend the system

This is the default behaviour. To change the setting open the cinnamon-settings panel and click on the "Power Management" option. Change the "When the power button is pressed" option to your desired behaviour.

Manage languages used in Cinnamon

Note: The language module was removed from the Cinnamon Control Panel with the release of Cinnamon 2.2. [1]
  • To add/remove languages: see Locale.
  • To change between enabled languages: install the mintlocaleAUR package.
  • To change the keyboard layout: navigate to System Settings > Hardware > Keyboard > Layouts.

Tips and tricks

Creating custom applets

The official tutorial on creating a Cinnamon applet can be found here.

Default desktop background wallpaper path

When you add a wallpaper from a custom path in Cinnamon Settings, Cinnamon copies it to ~/.cinnamon/backgrounds. Thus, with every change of your wallpaper you would have to add your updated wallpaper again from the settings menu or copy / symlink it manually to ~/.cinnamon/backgrounds.

Show home, filesystem desktop icons

By default Cinnamon starts with desktop icons enabled but with no desktop icons on screen. To show desktop icons for the home folder, the filesystem, the trash, mounted volumes and network servers open Cinnamon settings and click on desktop. Enable the checkboxes of the icons you want to see on screen.

Menu editor

The Menu applet supports launching custom commands. Right click on the applet, click on Configure... and then Open the menu editor. Select a sub-menu (or create a new one) and select New Item. Set Name, Command and Comment. Check the launch in terminal checkbox if needed. Leave unchecked for graphical applications. Click OK and close the menu editor afterwards. The launcher is added to the menu.

Workspaces

A workspace pager can be added to the panel. Right click the panel and choose the option Add applets to the panel. Add the Workspace switch applet to the panel. To change its position right click on the panel and change the Panel edit mode on/off switch to on. Click and drag the switcher to the desired position and turn the panel edit mode off when finished.

By default there are 2 workspaces. To add more, hit Control+Alt+Up to show all workspaces. Then click on the plus sign button on the right of the screen to add more workspaces.

Alternatively, you can choose the number by command-line:

$ gsettings set org.cinnamon.desktop.wm.preferences num-workspaces 4

Replacing 4 with the number of workspaces you want.

Hide desktop icons

The desktop icons rendering feature is enabled in nemo by default. To disable this feature, change the setting with the following command:

$ gsettings set org.nemo.desktop show-desktop-icons false

Themes and icons

Linux Mint styled themes and icons can be installed with the mint-x-themeAUR and mint-x-iconsAUR packages. The themes can be edited in Settings → Themes → Other settings.

Official Linux Mint Cinnamon themes can be installed using the mint-cinnamon-themesAUR package.

Sound events

Cinnamon does not come with sounds used for events like the startup of the desktop that are also used in Linux Mint by default. These sound effects can be installed with the cinnamon-sound-effectsAUR and mint-soundsAUR packages. The sound events can be edited in Settings → Sound → Sound Effects.

Resize windows by mouse

To resize windows with Alt+Right click, use gsettings:

gsettings set org.cinnamon.desktop.wm.preferences resize-with-right-button true

Portable keybindings

To export your keyboard shortcut keys, you should do:

dconf dump /org/cinnamon/desktop/keybindings/ >keybindings-backup.dconf

To later import it (for example) on another computer, do:

dconf load /org/cinnamon/desktop/keybindings/ <keybindings-backup.dconf

Screenshot

As explained in Taking a screenshot, installing gnome-screenshot will add this functionality. The default shortcut key is Prt Sc key. This binding ca be changed in the applet Menu > Preferences > Keyboard under Shortcuts > System > Screenshots and Recording. The default save directory is $HOME/Pictures, but can be customized with eg.

$ gsettings set org.gnome.gnome-screenshot auto-save-directory file:///home/USER/some_path

Troubleshooting

cinnamon-settings: No module named Image

If cinnamon-settings does not start with the message that it cannot find a certain module, e.g. the Image module, it is likely that it uses outdated compiled files which refer to no longer existing file locations. In this case remove all *.pyc files in /usr/lib/cinnamon-settings and its sub-folders. See the upstream bug report.

Video tearing

Because muffin is based upon mutter, video tearing fixes for GNOME should also work in Cinnamon. See GNOME/Troubleshooting#Tear-free video with Intel HD Graphics for more information.

Disable the NetworkManager applet

Even if you do not use NetworkManager and remove the Network Manager applet from the default panel, Cinnamon will still load nm-applet and display it in the system tray. You cannot uninstall the package, because it is required by cinnamon and cinnamon-control-center, but you can still easily disable it. To do so copy the autostart file from /etc/xdg/autostart/nm-applet.desktop to ~/.config/autostart/nm-applet.desktop. Open it with your favorite text editor and add at the end X-GNOME-Autostart-enabled=false.

Alternatively you can disable it is by creating the following symlink:

$ ln -s /bin/true /usr/local/bin/nm-applet

The ability to blacklist particular icons from the system tray (such as the nm-applet icon) has been requested upstream.