{{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==

Revision as of 06:11, 10 October 2013

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.

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:

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.

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: