Difference between revisions of "Cinnamon"

From ArchWiki
Jump to: navigation, search
(Installation)
(Workspace expo and scale background missing: I can't reproduce this problem. The setting should be persistent.)
(43 intermediate revisions by 16 users not shown)
Line 1: Line 1:
 
[[Category:Desktop environments]]
 
[[Category:Desktop environments]]
 +
[[ja:Cinnamon]]
 +
[[ru:Cinnamon]]
 
[[tr:Cinnamon_Masaüstü_Ortamı]]
 
[[tr:Cinnamon_Masaüstü_Ortamı]]
{{i18n|Cinnamon}}
+
{{Article summary start}}
{{Expansion}}
+
{{Article summary text|This article covers basic installation procedures and configuration methods in Cinnamon.}}
 +
{{Article summary heading|Related}}
 +
{{Article summary wiki|GNOME}}: GNOME is the framework that Cinnamon is based on.
 +
{{Article summary wiki|MATE}}: Another fork of GNOME that is geared towards a GNOME 2 experience.
 +
{{Article summary 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.
+
The desktop layout is similar to GNOME 2; however, the underlying technology was forked from GNOME Shell.
The underlying technology is 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.
 
The emphasis is put on making users feel at home and providing them with an easy to use and comfortable desktop experience.
  
 
==Installation==
 
==Installation==
  
Install {{AUR|cinnamon-git}} from the [[Arch User Repository]].
+
Cinnamon can be [[Pacman|installed]] with the package {{Pkg|cinnamon}}, available in the [[official repositories]].
  
You will probably want to install also {{AUR|cinnamon-extensions-git}} and {{AUR|cinnamon-themes-git}}.
+
To get a complete desktop environment, install at least the following additional packages:
 +
* {{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.
  
{{Note|{{AUR|cinnamon-extensions-git}} and {{AUR|cinnamon-themes-git}} are deprecated (see [https://github.com/linuxmint/Cinnamon/issues/668 here]). Instead, visit http://cinnamon-spices.linuxmint.com/.}}
+
=== Starting Cinnamon ===
  
Because Cinnamon is a fork of the GNOME3 shell you can [[pacman|install]] the whole {{Grp|gnome}} group from the [[Official Repositories]], or just the packages you need.
+
'''Graphical log-in'''
  
At last you have to add this to your {{ic|~/.xinitrc}}:
+
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.
  
{{bc|1=
+
'''Starting Cinnamon manually'''
exec ck-launch-session gnome-session-cinnamon
+
}}
+
  
Users of [[SLiM]] can omit ck-launch-session (See [https://wiki.archlinux.org/index.php/Slim#Single_environments SLiM note]):
+
If you prefer to start Cinnamon manually from the console, add the following line to your {{ic|~/.xinitrc}} file:
{{bc|exec gnome-session-cinnamon}}
+
{{hc|~/.xinitrc|<nowiki>
 +
exec gnome-session-cinnamon
 +
</nowiki>}}
 +
 
 +
After the {{ic|exec}} command is placed, Cinnamon can be launched by typing {{ic|startx}}. See [[xinitrc]] for details.
 +
 
 +
==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 Settings===
 +
 
 +
Simply run the following command:
 +
{{bc|cinnamon-settings}}
 +
 
 +
Each settings panel can be accessed directly with the following commands:
 +
{{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===
 +
 
 +
{{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/.}}
 +
 
 +
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.
 +
 
 +
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}}.
 +
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 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".
 +
 
 +
==Tips and tricks==
 +
 
 +
===Creating custom applets/themes===
 +
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===
 +
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==
 +
 
 +
===QGtkStyle unable to detect the current theme===
 +
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:
 +
 
 +
$ gconftool-2 --set --type string /desktop/gnome/interface/icon_theme Faenza-Dark
 +
 
 +
This sets the icon theme to Faenza-Dark located in {{ic|/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 {{ic|/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'
 +
 
 +
===Icons do not show on the desktop===
 +
 
 +
The desktop icons rendering feature is enabled in nemo, and disabled in nautilus by default. To enable this feature, change the setting for nemo:
 +
 
 +
$ gsettings set org.nemo.desktop show-desktop-icons true
 +
 
 +
And for nautilus:
 +
 
 +
$ gsettings set org.gnome.desktop.background show-desktop-icons true
 +
 
 +
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'.
 +
 
 +
===Volume level is not saved===
 +
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.
 +
 
 +
==Known issues==
 +
 
 +
===Nemo crashes randomly with animated wallpaper===
 +
It's a [https://github.com/linuxmint/nemo/issues/227 known issue with nemo], which crashes when animated wallpaper used as desktop background. To solve it, replace the wallpaper with a static one:
 +
 
 +
$ gsettings set org.gnome.desktop.background 'file:///usr/share/themes/Adwaita/backgrounds/bright-day.jpg'
 +
 
 +
Alternatively, nemo's desktop rendering feature can be disabled:
 +
$ gsettings set org.nemo.desktop show-desktop-icons false
 +
 
 +
===Keyboard layout panel missing from Cinnamon Settings===
 +
It's a [https://github.com/linuxmint/cinnamon-control-center/issues/3 known issue with cinnamon-control-center], which is not compatible with gnome-settings-daemon 3.6. Until this problem not solved, {{ic|gnome-control-center region}} panel can be used to configure keyboard layouts.
 +
 
 +
===Workspace expo and scale background missing===
 +
It's a [https://github.com/linuxmint/Cinnamon/issues/696 known issue with nemo] , which for some causes the workspace expo and scale modes to appear with a black background as opposed to the wallpaper. This only occurs when using nemo as the desktop manager. To solve it, disable the background-fade option for nemo:
 +
 
 +
$ gsettings set org.nemo.desktop background-fade false
 +
 
 +
The issue should be solved after a logout, or, alternatively, just restarting nemo:
 +
 
 +
$ nemo -q && nemo -n

Revision as of 20:21, 13 March 2013

Summary help replacing me
This article covers basic installation procedures and configuration methods in Cinnamon.
Related
GNOME: GNOME is the framework that Cinnamon is based on.
MATE: Another fork of GNOME that is geared towards a GNOME 2 experience.

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 emphasis is put on making users feel at home and providing them with an easy to use and comfortable desktop experience.

Installation

Cinnamon can be installed with the package cinnamon, available in the official repositories.

To get a complete desktop environment, install at least the following additional packages:

Starting Cinnamon

Graphical log-in

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

If you prefer to start Cinnamon manually from the console, add the following line to your ~/.xinitrc file:

~/.xinitrc
 exec gnome-session-cinnamon

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

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
so on.

Installing applets/extensions

Note: Previously, cinnamon-extensions-gitAUR and cinnamon-themes-gitAUR were used to install some themes and extensions, but they are now deprecated (see here). Instead, visit http://cinnamon-spices.linuxmint.com/.

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 Template:Keypress and type r and press 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".

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.

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'

Icons do not show on the desktop

The desktop icons rendering feature is enabled in nemo, and disabled in nautilus by default. To enable this feature, change the setting for nemo:

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

And for nautilus:

$ gsettings set org.gnome.desktop.background show-desktop-icons true

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'.

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.

Known issues

Nemo crashes randomly with animated wallpaper

It's a known issue with nemo, which crashes when animated wallpaper used as desktop background. To solve it, replace the wallpaper with a static one:

$ gsettings set org.gnome.desktop.background 'file:///usr/share/themes/Adwaita/backgrounds/bright-day.jpg'

Alternatively, nemo's desktop rendering feature can be disabled:

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

Keyboard layout panel missing from Cinnamon Settings

It's a known issue with cinnamon-control-center, which is not compatible with gnome-settings-daemon 3.6. Until this problem not solved, gnome-control-center region panel can be used to configure keyboard layouts.

Workspace expo and scale background missing

It's a known issue with nemo , which for some causes the workspace expo and scale modes to appear with a black background as opposed to the wallpaper. This only occurs when using nemo as the desktop manager. To solve it, disable the background-fade option for nemo:

$ gsettings set org.nemo.desktop background-fade false

The issue should be solved after a logout, or, alternatively, just restarting nemo:

$ nemo -q && nemo -n