Difference between revisions of "Cinnamon"

From ArchWiki
Jump to: navigation, search
(Starting Cinnamon)
(Installation: added info about the [cinnamon] unofficial repo)
(26 intermediate revisions by 8 users not shown)
Line 3: Line 3:
 
[[ru:Cinnamon]]
 
[[ru:Cinnamon]]
 
[[tr:Cinnamon_Masaüstü_Ortamı]]
 
[[tr:Cinnamon_Masaüstü_Ortamı]]
{{Article summary start}}
+
{{Related articles start}}
{{Article summary text|This article covers basic installation procedures and configuration methods in Cinnamon.}}
+
{{Related|Nemo}}
{{Article summary heading|Related}}
+
{{Related|GNOME}}
{{Article summary wiki|GNOME}}
+
{{Related|MATE}}
{{Article summary wiki|Nemo}}
+
{{Related|Desktop environment}}
{{Article summary end}}
+
{{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 Linux desktop which provides advanced innovative features and a traditional user experience.  
The desktop layout is similar to GNOME 2; however, the underlying technology was forked from GNOME Shell.
+
The desktop layout is similar to GNOME Panel (GNOME 2); however, the underlying technology was forked from GNOME Shell (GNOME 3).
The emphasis is put on making users feel at home and providing them with an easy to use and comfortable desktop experience.
+
The emphasis is put on making users feel at home and providing them with an easy to use and comfortable desktop experience. As of version 2.0, Cinnamon is a complete desktop environment and not merely a frontend for GNOME like GNOME Shell and Unity.
  
 
==Installation==
 
==Installation==
Line 18: Line 19:
 
Cinnamon can be [[Pacman|installed]] with the package {{Pkg|cinnamon}}, available in the [[official repositories]].
 
Cinnamon can be [[Pacman|installed]] with the package {{Pkg|cinnamon}}, available in the [[official repositories]].
  
To get a complete desktop interface, install at least the following additional packages:
+
To install additional Cinnamon themes, applets and extensions, you may wish to add the [[Unofficial user repositories#cinnamon|Cinnamon unofficial repository]] to your {{ic|pacman.conf}}.
* {{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 ===
+
==Starting Cinnamon==
  
'''Graphical log-in'''
+
===Graphical log-in===
  
Simply choose '''Cinnamon''' or '''Cinnamon (Software Rendering)''' 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 (Software Rendering) session, which disables 3D acceleration.
+
Simply choose ''Cinnamon'' or ''Cinnamon (Software Rendering)'' 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 (Software Rendering)'' 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 your {{ic|~/.xinitrc}} file:
 
If you prefer to start Cinnamon manually from the console, add the following line to your {{ic|~/.xinitrc}} file:
{{hc|~/.xinitrc|<nowiki>
+
{{hc|~/.xinitrc|
 
  exec cinnamon-session
 
  exec cinnamon-session
</nowiki>}}
+
}}
  
If the Cinnamon (Software Rendering) session is required, use {{ic|cinnamon-session-cinnamon2d}} instead of {{ic|cinnamon-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.
 
After the {{ic|exec}} command is placed, Cinnamon can be launched by typing {{ic|startx}}. See [[xinitrc]] for details.
  
{{Note|Versions before Cinnamon 1.9 used the gnome session manager. Put {{ic|gnome-session-cinnamon}} instead of {{ic|cinnamon-session-cinnamon}}.}}
+
{{Note|Versions before Cinnamon 1.9 used the GNOME session manager. For versions of Cinnamon currently in the [[official repositories]], use {{ic|cinnamon-session}} instead of {{ic|gnome-session-cinnamon}}.}}
  
 
==Configuration==
 
==Configuration==
  
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 is quite easy to configure &mdash; 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===
  
 
Simply run the following command:
 
Simply run the following command:
{{bc|cinnamon-settings}}
+
{{bc|$ cinnamon-settings}}
  
 
Each settings panel can be accessed directly with the following commands:
 
Each settings panel can be accessed directly with the following commands:
{{bc|cinnamon-settings panel
+
{{bc|$ cinnamon-settings panel
cinnamon-settings calendar
+
$ cinnamon-settings calendar
cinnamon-settings themes
+
$ cinnamon-settings themes
cinnamon-settings applets
+
$ cinnamon-settings applets
cinnamon-settings windows
+
$ cinnamon-settings windows
cinnamon-settings fonts
+
$ cinnamon-settings fonts
cinnamon-settings hotcorner}} so on.
+
$ cinnamon-settings hotcorner}} and so on.
  
===Installing applets/extensions===
+
====Bluetooth support in cinnamon-settings and the panel====
 +
{{warning|{{AUR|cinnamon-bluetooth}} is incompatible with GNOME 3.10. See the [[Bluetooth]] article for alternatives.}}
  
{{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/.}}
+
A GNOME bluetooth frontend for Cinnamon Panel and Cinnamon Settings is available in the AUR under the name {{AUR|cinnamon-bluetooth}}.
 +
 
 +
===Installing applets/extensions===
  
 
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.
 
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.
  
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.
+
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.
  
 
Installing applets in Cinnamon is relatively easy. First visit [http://cinnamon-spices.linuxmint.com/applets Cinnamon Applets] to see all of the current applets.
 
Installing applets in Cinnamon is relatively easy. First visit [http://cinnamon-spices.linuxmint.com/applets Cinnamon Applets] to see all of the current applets.
 
Download the zip file for the desired applet, and extract to {{ic|~/.local/share/cinnamon/applets/}} or {{ic|/usr/share/cinnamon/applets}}.
 
Download the zip file for the desired applet, and extract to {{ic|~/.local/share/cinnamon/applets/}} or {{ic|/usr/share/cinnamon/applets}}.
 
Then run
 
Then run
{{bc|cinnamon-settings applets}}
+
{{bc|$ cinnamon-settings applets}}
to bring up the graphical applets manager. If the applet does not show up, press {{ic|Alt+F2}} and type {{ic|r}} and press {{ic|Enter}}. This will restart gnome-shell and likely, the new applet.
+
to bring up the graphical applets manager. If the applet does not show up, press {{ic|Alt+F2}} and type {{ic|r}} and press {{ic|Enter}}. This will restart cinnamon 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".
 
The process is analogous for extensions, with the only difference being that directories titled "applets" can be changed to "extensions".
Line 83: Line 84:
 
===Default desktop background wallpaper path===
 
===Default desktop background wallpaper path===
 
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}}.
 
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}}.
 +
 +
===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.
 +
 +
===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 move the mouse cursor into the top left corner to enter 'Expose mode.' Click the plus sign button on the right of the screen to add more workspaces.
 +
 +
===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
  
 
==Troubleshooting==
 
==Troubleshooting==
Line 107: Line 122:
 
  $ gsettings set org.gnome.settings-daemon.plugins.power button-power 'interactive'
 
  $ gsettings set org.gnome.settings-daemon.plugins.power button-power 'interactive'
  
===Icons do not show on the desktop===
+
=== Laptop lid power management settings are ignored ===
 +
{{Note|This workaround is no longer needed with {{Pkg|cinnamon-settings-daemon}} version 2.0.8-4.}}
 +
If your system ignores the laptop lid close action, which set in Power Management tool, you have to edit the file /etc/systemd/login.conf and uncomment/modify the following two lines:
  
The desktop icons rendering feature is enabled in nemo, and disabled in nautilus by default. To enable this feature, change the setting for nemo:
+
  HandleLidSwitch=ignore
 
+
  LidSwitchIgnoreInhibited=no
  $ gsettings set org.nemo.desktop show-desktop-icons true
+
 
+
Or for nautilus:
+
 
+
  $ gsettings set org.gnome.desktop.background show-desktop-icons true
+
 
+
The feature can be disabled by calling the commands above, but replace 'true' with 'false'.
+
  
 
===Volume level is not saved===
 
===Volume level is not saved===
Line 126: Line 136:
  
 
  $ gpasswd -a [user] [group]
 
  $ gpasswd -a [user] [group]
 +
 +
===cinnamon-settings: No module named Image===
 +
 +
If {{ic|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.

Revision as of 00:09, 23 March 2014

Cinnamon is a Linux desktop which provides advanced innovative features and a traditional user experience. The desktop layout is similar to GNOME Panel (GNOME 2); however, the underlying technology was forked from GNOME Shell (GNOME 3). The emphasis is put on making users feel at home and providing them with an easy to use and comfortable desktop experience. 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, available in the official repositories.

To install additional Cinnamon themes, applets and extensions, you may wish to add the Cinnamon unofficial repository to your pacman.conf.

Starting Cinnamon

Graphical log-in

Simply choose Cinnamon or Cinnamon (Software Rendering) 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 (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 your ~/.xinitrc file:

~/.xinitrc
 exec cinnamon-session

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

After the exec command is placed, Cinnamon can be launched by typing startx. See xinitrc for details.

Note: Versions before Cinnamon 1.9 used the GNOME session manager. For versions of Cinnamon currently in the official repositories, use cinnamon-session instead of gnome-session-cinnamon.

Configuration

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 applets and extensions, and also it supports theming.

Cinnamon Settings

Simply run the following command:

$ cinnamon-settings

Each settings panel can be accessed directly with the following commands:

$ cinnamon-settings panel
$ cinnamon-settings calendar
$ cinnamon-settings themes
$ cinnamon-settings applets
$ cinnamon-settings windows
$ cinnamon-settings fonts
$ cinnamon-settings hotcorner
and so on.

Bluetooth support in cinnamon-settings and the panel

Warning: cinnamon-bluetoothAUR is incompatible with GNOME 3.10. See the Bluetooth article for alternatives.

A GNOME bluetooth frontend for Cinnamon Panel and Cinnamon Settings is available in the AUR under the name cinnamon-bluetoothAUR.

Installing applets/extensions

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.

There are quite a few packages in the AUR (AUR package search for cinnamon). The process described here is a generic installation process.

Installing applets in Cinnamon is relatively easy. First visit Cinnamon Applets to see all of the current applets. Download the zip file for the desired applet, and extract to ~/.local/share/cinnamon/applets/ or /usr/share/cinnamon/applets. Then run

$ cinnamon-settings applets

to bring up the graphical applets manager. If the applet does not show up, press Alt+F2 and type r and press Enter. This will restart cinnamon 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".

Tips and tricks

Creating custom applets/themes

The official tutorial on creating an applet can be found here, and on creating a custom theme 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/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 ~/.cinnamon/background.

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.

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 move the mouse cursor into the top left corner to enter 'Expose mode.' Click the plus sign button on the right of the screen to add more workspaces.

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

Troubleshooting

QGtkStyle unable to detect the current theme

Installing 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:

$ gconftool-2 --set --type string /desktop/gnome/interface/icon_theme Faenza-Dark

This sets the icon theme to Faenza-Dark located in /usr/share/icons/Faenza-Dark.

The cursor theme for Qt apps can be selected by creating a symbolic link:

$ mkdir ~/.icons
$ ln -s /usr/share/icons/Adwaita ~/.icons/default

This sets the cursor theme to Adwaita located in /usr/share/icons/Adwaita.

Pressing power buttons suspend the system

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'

Laptop lid power management settings are ignored

Note: This workaround is no longer needed with cinnamon-settings-daemon version 2.0.8-4.

If your system ignores the laptop lid close action, which set in Power Management tool, you have to edit the file /etc/systemd/login.conf and uncomment/modify the following two lines:

HandleLidSwitch=ignore
LidSwitchIgnoreInhibited=no

Volume level is not saved

The volume level is not be saved after reboot. The volume will be at 0 but not muted. Installing alsa-utils will solve the problem.

Applets not working

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]

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.