Difference between revisions of "Cinnamon"

From ArchWiki
Jump to: navigation, search
m (Installation)
(nautilus is no longer enabled in Cinnamon)
(35 intermediate revisions by 11 users not shown)
Line 6: Line 6:
 
{{Article summary text|This article covers basic installation procedures and configuration methods in Cinnamon.}}
 
{{Article summary text|This article covers basic installation procedures and configuration methods in Cinnamon.}}
 
{{Article summary heading|Related}}
 
{{Article summary heading|Related}}
{{Article summary wiki|GNOME}}: GNOME is the framework that Cinnamon is based on.
+
{{Article summary wiki|GNOME}}
{{Article summary wiki|MATE}}: Another fork of GNOME that is geared towards a GNOME 2 experience.
+
{{Article summary wiki|Nemo}}
 
{{Article summary end}}
 
{{Article summary end}}
  
Line 17: Line 17:
  
 
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 full desktop environment, it's recommended to install the whole {{Grp|gnome}} group additionally.
 
  
 
=== Starting Cinnamon ===
 
=== Starting Cinnamon ===
  
'''Graphical log-in'''
+
==== 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.
+
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 gnome-session-cinnamon
+
  exec cinnamon-session
</nowiki>}}
+
}}
 +
 
 +
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. For versions of Cinnamon currently in the [[Official Repositories|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===
Line 53: Line 55:
 
cinnamon-settings hotcorner}} so on.
 
cinnamon-settings hotcorner}} so on.
  
===Installing Applets/Extensions===
+
===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/.}}
 
{{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/.}}
Line 65: Line 67:
 
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 {{Keypress|Alt+F2}} and type {{ic|r}} and press 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 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".
 
The process is analogous for extensions, with the only difference being that directories titled "applets" can be changed to "extensions".
  
===Creating Custom Applets/Themes===
+
==Tips and tricks==
  
The official tutorial from Clement Lefebvre on creating an '''applet''' can be found [http://cinnamon.linuxmint.com/?p=156 here].
+
===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].
  
The official tutorial from Clement Lefebvre 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==
+
===Hide desktop icons===
  
===QGtkStyle was unable to detect the current GTK+ theme===
+
The desktop icons rendering feature is enabled in nemo by default. To disable this feature, change the setting with the following command:  
If it turns out that QT applications are not able to detect the GTK theme, users must specify the theme explicitly. In case of the default Adwaita theme it would look like this:
+
  
  gconftool-2 --set --type string /desktop/gnome/interface/gtk_theme Adwaita
+
  $ gsettings set org.nemo.desktop show-desktop-icons false
  
To set the same icon and cursor theme, users should specify them, too.
+
==Troubleshooting==
  
gconftool-2 --set --type string /desktop/gnome/interface/icon_theme Faenza-Dark
+
===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.
  
This sets the icon theme to Faenza-Dark located in {{ic|/usr/share/icons/Faenza-Dark}}.
+
The icon theme for Qt apps can be configured by the following command:
  
The following will set the gconf value for the mouse cursor.
+
$ gconftool-2 --set --type string /desktop/gnome/interface/icon_theme Faenza-Dark
  
gconftool-2 --set --type string /desktop/gnome/peripherals/mouse/cursor_theme Adwaita
+
This sets the icon theme to Faenza-Dark located in {{ic|/usr/share/icons/Faenza-Dark}}.
  
Finally, create {{ic|/usr/share/icons/default/index.theme}} with the following lines:
+
The cursor theme for Qt apps can be selected by creating a symbolic link:
  
  [Icon Theme]
+
  $ mkdir ~/.icons
  Inherits=Adwaita
+
  $ ln -s /usr/share/icons/Adwaita ~/.icons/default
  
===Pressing power buttons suspends the system===
+
This sets the cursor theme to Adwaita located in {{ic|/usr/share/icons/Adwaita}}.
This is the default behavior. To show the shutdown menu for example, change the dconf setting for the respective buttons:
+
  
GSETTINGS_BACKEND=dconf gsettings set org.gnome.settings-daemon.plugins.power button-power 'interactive'
+
===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:
  
Users may need to do this for the hibernate button as well:
+
$ gsettings set org.gnome.settings-daemon.plugins.power button-power 'interactive'
  
GSETTINGS_BACKEND=dconf gsettings set org.gnome.settings-daemon.plugins.power button-power 'interactive'
+
===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.
  
===Icons do not show on the desktop===
+
===Applets not working===
Icons might not show when nautilus and nemo are both installed. To fix the issue remove the file manager(s) not in use. In case icons are not showing despite having just one file manager installed, users can try to enable them by using dconf editor.
+
If audio or network applets don't work the user may be required to be added to the relevant groups (audio, network):
Browse the tree to org > gnome > desktop > background and check the "Show desktop icons" box.
+
  
===Volume level is not saved===
+
$ gpasswd -a [user] [group]
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.
+

Revision as of 00:37, 2 November 2013

Template:Article summary start Template:Article summary text Template:Article summary heading Template:Article summary wiki Template:Article summary wiki Template:Article summary end

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.

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
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 Alt+F2 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.

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'

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]