Created page with "Category:Desktop environments zh-CN:Pantheon ja:Pantheon pl:Pantheon [http://elementaryos.org/ Pantheon] is the default desktop environment originally created..."
New page
[[Category:Desktop environments]]
[[zh-CN:Pantheon]]
[[ja:Pantheon]]
[[pl:Pantheon]]
[http://elementaryos.org/ Pantheon] is the default desktop environment originally created for the elementary OS distribution. It is written from scratch using Vala and the GTK3 toolkit. With regards to usability and appearance, the desktop has some similarities with [[GNOME]] Shell and Mac OS X.
==Installation==
Pantheon is split into several packages which are available in an unofficial repository which is daily updated with recent changes from upstream. To use the repository add the following lines at the top of your sources in {{Ic|/etc/pacman.conf}}:
{{bc|<nowiki>
[pantheon]
SigLevel = Optional
Server = http://pkgbuild.com/~alucryd/$repo/$arch
</nowiki>}}
{{Note|All Pantheon related PKGBUILDs can be found in [https://github.com/alucryd/aur-alucryd/tree/master/pantheon Alucryd's GitHub repository].}}
Alternatively, all packages provided by the repository are also available in the [[AUR]] for those who prefer to build the packages from source.
To get a minimal desktop interface, you may start by installing {{AUR|pantheon-session-bzr}}. This will pull the following core components:
* {{AUR|cerbere-bzr}}: Watchdog service to keep core Pantheon apps running
* {{AUR|gala-bzr}}: Window Manager
* {{AUR|wingpanel-bzr}}: Top panel
* {{AUR|slingshot-launcher-bzr}}: Application launcher
* {{AUR|plank-bzr}}: Dock
However,it is recommended to install the following packages to get a fully working Pantheon Shell:
{{Note|Problems can occur when using (non)-mixed bzr packages! You can install the latest release, by adding -bzr to its install package-name.}}
* {{AUR|audience-bzr}}: Video player
* {{AUR|contractor-bzr}}: Service for sharing data between apps
* {{AUR|dexter-contacts-bzr}}{{Broken package link|{{aur-mirror|dexter-contacts-bzr}}}}: Contacts manager (does not build)
* {{AUR|eidete-bzr}}: Simple screencaster
* {{AUR|elementary-icon-theme-bzr}}: elementary icons
* {{AUR|elementary-scan-bzr}}: Simple scan utility (does not build)
* {{AUR|elementary-wallpapers-bzr}}{{Broken package link|{{aur-mirror|elementary-wallpapers-bzr}}}}: elementary wallpaper collection
* {{AUR|gtk-theme-elementary-bzr}}: elementary GTK theme
* {{AUR|feedler-bzr}}{{Broken package link|{{aur-mirror|feedler-bzr}}}}: RSS feeds reader (does not build)
* {{AUR|footnote-bzr}}: Note taking app
* {{Pkg|geary}}: Email client
* {{AUR|indicator-pantheon-session-bzr}}{{Broken package link|{{aur-mirror|indicator-pantheon-session-bzr}}}}: Session indicator
* {{AUR|lightdm-pantheon-greeter-bzr}}: LightDM greeter
* {{AUR|maya-calendar-bzr}}: Calendar
* {{AUR|midori-granite-bzr}}: Web browser
* {{AUR|noise-bzr}}: Audio player
* {{AUR|pantheon-backgrounds-bzr}}: Wallpaper collection
* {{AUR|pantheon-calculator-bzr}}: Calculator
* {{AUR|pantheon-default-settings-bzr}}: Pantheon default's settings (appearance, etc.)
* {{AUR|pantheon-files-bzr}}: File explorer
* {{AUR|pantheon-notify-bzr}}{{Broken package link|{{aur-mirror|pantheon-notify-bzr}}}}: Notification daemon
* {{AUR|pantheon-print-bzr}}: Print settings
* {{AUR|pantheon-terminal-bzr}}: Terminal emulator
* {{AUR|plank-theme-pantheon-bzr}}: Pantheon theme for plank
* {{AUR|scratch-text-editor-bzr}}: Text editor
* {{AUR|snap-photobooth-bzr}}: Webcam app
* {{AUR|switchboard-bzr}}: Settings manager
{{Note|You will also need to install plugs, look for "switchboard-plug-*" in the [https://aur.archlinux.org/packages/?O=0&K=switchboard-plug AUR] or in [https://github.com/alucryd/aur-alucryd/tree/master/pantheon Alucryd's GitHub repository].}}
It is also recommended to install the following fonts:
* {{AUR|ttf-opensans}}: Open Sans Fonts
* {{AUR|ttf-raleway-font-family}}{{Broken package link|{{aur-mirror|ttf-raleway-font-family}}}}: Raleway Font Family
* {{Pkg|ttf-dejavu}}: Font family based on the Bitstream Vera Fonts
* {{Pkg|ttf-droid}}: General-purpose fonts released by Google as part of Android
* {{Pkg|ttf-freefont}}: Set of free outline fonts covering the Unicode character set
* {{Pkg|ttf-liberation}}: Red Hats Liberation fonts
===Additional Info===
====Packages based on older evolution-data-server====
{{AUR|dexter-contacts-bzr}}{{Broken package link|{{aur-mirror|dexter-contacts-bzr}}}} and {{AUR|feedler-bzr}}{{Broken package link|{{aur-mirror|feedler-bzr}}}} do not build because they are based on evolution-data-server 3.2. Arch Linux provides version 3.10 which uses a different Vala API.
==Launching Pantheon==
===Via a Display Manager===
{{AUR|pantheon-session-bzr}} provides a session entry for display managers such as {{Pkg|gdm}} or {{Pkg|lightdm}}.
{{Note|Either use the bzr version of ''cerbere'' or add 'gala' to the monitored processes for this to work.}}
===Via .xinitrc===
You can also use {{Ic|~/.xinitrc}} to launch the Pantheon shell. The following code will successfully launch a Pantheon session:
#!/bin/sh
if [ -d /etc/X11/xinit/xinitrc.d ]; then
for f in /etc/X11/xinit/xinitrc.d/*; do
[ -x "$f" ] && . "$f"
done
unset f
fi
gsettings-data-convert &
xdg-user-dirs-gtk-update &
/usr/lib/polkit-gnome/polkit-gnome-authentication-agent-1 &
/usr/lib/gnome-settings-daemon/gnome-settings-daemon &
/usr/lib/gnome-user-share/gnome-user-share &
eval $(gnome-keyring-daemon --start --components=pkcs11,secrets,ssh,gpg)
export GNOME_KEYRING_CONTROL GNOME_KEYRING_PID GPG_AGENT_INFO SSH_AUTH_SOCK
exec cerbere
{{Note|Pantheon may refuse to start correctly, resulting in errors such as no visible mouse cursor and others. In this case you have to add the window manager 'gala' to the list of monitored processes of cebere. This can be done in {{ic|dconf-editor}} and should look like [http://s0.uploads.im/AvOIT.png this]. Remember do not run dconf-editor as root, use your local username.}}
===Autostart applications===
Pantheon, when launched via {{Ic|~/.xinitrc}}, does not support XDG autostart. However, there are 3 other ways to achieve this for applications which do not provide a systemd unit:
* You may add any program to your {{Ic|~/.xinitrc}}, preferably right before the ''exec cerbere'' line. This is the better choice for one-shot programs.
* Or you may edit the {{Ic|org.pantheon.cerbere.monitored-processes}} key using ''dconf-editor'' and add the programs of your choice. This method is best for applications which keep running in the background.
* Or you may use a program like {{AUR|dapper}}, {{AUR|dex-git}}, or {{AUR|fbautostart}} to add support for XDG autostart in your {{ic|~/.xinitrc}}.
{{Note|Keep in mind that applications started via ''cerbere'' cannot be terminated, they will keep respawning.}}
==Configuration==
Configuring Pantheon is done via {{AUR|switchboard-bzr}} and its plugs, most are available in the AUR and the custom repo. All pantheon settings can also be altered via ''dconf'', they are located in the {{Ic|org.pantheon}} key. Use ''dconf-editor'' for easy editing.
Part of the configuration is handled by {{Pkg|gnome-control-center}} via a dedicated plug, which unfortunately only supports GNOME up to 3.6. Use {{Pkg|gnome-control-center}} itself and {{Pkg|gnome-tweak-tool}} instead.
===Pantheon Files===
====Enable context menu entries====
If you want to enable context menu entries such as for {{Pkg|file-roller}} to extract/compress archives, then you have to additionally install {{AUR|contractor-bzr}}.
===Terminal===
====Opacity (transparency)====
You can set a certain opacity to make Pantheon Terminal (semi-)transparent. Open {{ic|dconf-editor}} and go to {{ic|org.pantheon.terminal.settings.opacity}} to set your desired opacity.
==Known Issues==
=== Indicators not working in wingpanel ===
Make sure the /etc/xdg/autostart/indicator-[name].desktop file contains Pantheon inside OnlyShowIn=
OnlyShowIn=Unity;XFCE;GNOME;Pantheon;
{{Note|
* Indicator support itself is a complex issue, due to standards discrepancies between Ubuntu and Gnome's implementation of KDE's status notification indicators.
* The pantheon devs are working on [https://launchpad.net/~wingpanel-devs a number of their own indicators] for wingpanel.}}
=== Indicator-session menus not working ===
* {{AUR|indicator-session-bzr}}{{Broken package link|{{aur-mirror|indicator-session-bzr}}}}
This version of indicator-session relies on dbus methods native to Unity for most of it's fuctions; it can be made to work by patching out the use of Unity dialogs, such as in [https://github.com/quequotion/pantheon-bzr-qq/tree/master/REDUNDANT/indicator-session-pantheon-bzr indicator-session-pantheon-bzr]
* {{AUR|indicator-session}}
This version of indicator-session fails to interact with the session manager somehow; a (crudely hacked) version that uses systemd/logind instead is available {{AUR|indicator-session-systemd}}{{Broken package link|{{aur-mirror|indicator-session-systemd}}}}
''About This Computer'', ''Lock'' and ''Sound Settings'' ({{AUR|indicator-sound}} or [https://github.com/quequotion/pantheon-bzr-qq/tree/master/REDUNDANT/indicator-session-pantheon-bzr indicator-sound-pantheon-bzr]) rely on gnome components that may not be installed, such as gnome-control-center and gnome-screensaver.
For ''Lock'' functionality (including "Ctrl+L" hotkey), replace gnome-screensaver with [[light-locker]] or [[XScreenSaver]] and [https://github.com/quequotion/pantheon-bzr-qq/tree/master/EXTRAS/xscreensaver-dbus-screenlock a script that emulates the gnome-screensaver dbus].
===No transparency in pantheon-terminal===
Transparency in pantheon-terminal is not yet fully functional with GTK themes other than the elmentaryOS theme. Either use {{AUR|gtk-theme-elementary}} or add [http://bazaar.launchpad.net/~elementary-design/egtk/4.x/revision/210 this] code to your theme.
===White icons in pantheon-files===
Currently there seems to be a bug which displays the view icons in the top location in a white colour instead of black. This can be fixed by installing {{AUR|gtk-theme-elementary-bzr}} or adding the following line to {{ic|gtk-widgets.css}} or {{ic|gtk-widgets.css}} of your {{AUR|gtk-theme-elementary}} theme:
GtkToolItem { color: @text_color; }
===Wingpanel is transparent===
Wingpanel is transparent by design when using the elementary GTK theme. It becomes black when a maximized window occupies your screen. However, using other GTK themes will produce a solid panel most of the time.
===Corrupted graphics in canonical indicators===
Indicators behave incorrectly with every theme I have tried. They are very ancient, all of them date back to 2012 because the newer indicators depend on Ubuntu patches, and they should be killed with fire anyway. Wingpanel is doing just that and I hope the next major release will ship their new plugin system.
===Cannot interact with the LightDM Pantheon greeter===
You need to delete {{ic|/var/lib/lightdm/.pam_environment}}. Do note however that this file is a workaround for the following LightDM bug: https://bugs.launchpad.net/ubuntu/+source/unity-greeter/+bug/1024482
== Troubleshooting ==
=== Gala crashes on start ===
It appears that unconfigured gala tries to use default gnome wallpaper as a background. However, the corresponding file is absent unless you have {{Pkg|gnome-themes-standard}} installed. Thus, install {{Pkg|gnome-themes-standard}} to workaround the crash. It is safe to remove this package after you configure pantheon in a way you want.
=== How can I add new applications to the dock? ===
Either drag and drop a desktop file on it, or right click on a running application and select "Keep in dock". You can then reorder icons by drag and drop.
=== How can I change the default appearance such as GTK theme, font size, etc? ===
Use {{Pkg|gnome-tweak-tool}} or see [[GTK+]].
=== I do not have any mouse cursor ===
The 'gala' window manager is most likely not running. [[#Via .xinitrc]] Add 'gala' to the list of cerbere's monitored processes.
=== Wingpanel is empty except for Applications ===
The indicators that are displayed in the wingpanel are split into separate packages. [[#Installation]] Install additional indicators such as {{AUR|wingpanel-indicator-datetime-bzr}}, {{AUR|indicator-power}}{{Broken package link|{{aur-mirror|indicator-power}}}} or {{AUR|indicator-sound}}.