Difference between revisions of "Pantheon"

From ArchWiki
Jump to navigation Jump to search
(update Pkg/AUR templates)
Tag: wiki-scripts
(→‎Theme: ttf-freefont replaced by gnu-free-font)
(63 intermediate revisions by 9 users not shown)
Line 3: Line 3:
 
[[pl:Pantheon]]
 
[[pl:Pantheon]]
 
[[zh-hans:Pantheon]]
 
[[zh-hans:Pantheon]]
[https://bbs.archlinux.org/viewtopic.php?id=152930 Pantheon] is the default desktop environment originally created for the [http://elementary.io/ 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 OSX.
+
[https://bbs.archlinux.org/viewtopic.php?id=152930 Pantheon] is the desktop environment originally created for the [http://elementary.io/ elementary OS] distribution. It is written from scratch in [[Wikipedia:Vala (programming language)|Vala]], using [[GTK+|GTK3]] and [https://github.com/elementary/granite Granite]. With regards to usability and appearance, the desktop has some similarities with [[GNOME Shell]] and [[Wikipedia:MacOS|macOS]].
 +
 
 +
== Project Status ==
 +
 
 +
Although the [https://elementary.io/ elementary OS] release schedule and toolchain are bound to [[Arch_compared_to_other_distributions#Ubuntu|Ubuntu's]] LTS release cycle, [https://plus.google.com/communities/104613975513761463450 development] moves quickly and has recently moved to [https://github.com/elementary github].
  
 
== Installation ==
 
== Installation ==
  
{{Note|Although their release schedule and toolchain are bound to [[Arch_compared_to_other_distributions#Ubuntu|Ubuntu's]] LTS release cycle, [https://plus.google.com/communities/104613975513761463450 elementary OS development] moves quickly and has recently moved to [https://github.com/elementary github].}}
+
=== Packages ===
  
=== Unofficial repository ===
+
==== Unofficial repository ====
  
[https://github.com/alucryd/aur-alucryd/tree/master/pantheon Alucryd's unofficial repo] contains more and more up-to-date packages than the few available in [[community]]. To use it add the following lines at the top of your sources in {{Ic|/etc/pacman.conf}}:
+
Alucryd's unofficial repository contains more and more [https://github.com/alucryd/aur-alucryd/tree/master/pantheon up-to-date] packages than the few available in the [[community repository]]. To use it add the following lines at the top of your sources in {{Ic|/etc/pacman.conf}}:
 
{{bc|<nowiki>
 
{{bc|<nowiki>
[pantheon]
+
[extra-alucryd]
SigLevel = Optional
 
 
Server = https://pkgbuild.com/~alucryd/$repo/$arch
 
Server = https://pkgbuild.com/~alucryd/$repo/$arch
 
</nowiki>}}
 
</nowiki>}}
{{Note|The PKGBUILDs for these packages are also available in the [[AUR]].}}
+
Do note that some packages are missing from the repository due to [https://github.com/alucryd/aur-alucryd/issues/88#issuecomment-434606676 issues] with upstream. You will have to supplement the repo with locally compiled packages.
 +
 
 +
==== AUR ====
 +
 
 +
Alternatively, the [[PKGBUILD]]s for the pantheon packages are also available in the [[AUR]].
  
 
=== Desktop Environment ===
 
=== Desktop Environment ===
Line 23: Line 30:
 
For the minimal Pantheon shell, install {{AUR|pantheon-session-git}}, which pulls--among other dependencies--the core components:
 
For the minimal Pantheon shell, install {{AUR|pantheon-session-git}}, which pulls--among other dependencies--the core components:
 
* {{AUR|cerbere-git}}: Watchdog service; restarts core components if they crash.
 
* {{AUR|cerbere-git}}: Watchdog service; restarts core components if they crash.
* {{AUR|gala-git}}: Window and composting manager
+
* {{AUR|gala-git}}: Window and composting manager  
* {{AUR|wingpanel-git}}: Top panel (launcher, clock, indicators)
+
* {{AUR|wingpanel-git}}: Top panel (holds the launcher, clock, and indicators)
 
* {{AUR|pantheon-applications-menu-git}}: Application launcher formerly known as "Slingshot"
 
* {{AUR|pantheon-applications-menu-git}}: Application launcher formerly known as "Slingshot"
* {{Pkg|plank}}: OSX-style Dock
+
* {{Pkg|plank}}: macOS-style Dock
  
 
=== Services and Configuration ===
 
=== Services and Configuration ===
  
These packages provide background services and default settings for Pantheon and elementary OS applications:
+
These optional packages provide background services and default settings for Pantheon and elementary OS applications:
 
* {{AUR|pantheon-default-settings-git}}: Default appearance, behavior, and configuration; pulls in theme packages {{Pkg|elementary-icon-theme}},  {{AUR|gtk-theme-elementary-git}}, and {{AUR|elementary-wallpapers-git}}
 
* {{AUR|pantheon-default-settings-git}}: Default appearance, behavior, and configuration; pulls in theme packages {{Pkg|elementary-icon-theme}},  {{AUR|gtk-theme-elementary-git}}, and {{AUR|elementary-wallpapers-git}}
* {{AUR|gnome-settings-daemon-elementary}}: A patched {{AUR|gnome-settings-daemon-ubuntu}} required by {{AUR|elementary-dpms-helper-git}}{{Broken package link|package not found}} and {{AUR|wingpanel-indicator-power-git}}
+
* {{AUR|gnome-settings-daemon-elementary}}: A patched {{AUR|gnome-settings-daemon-ubuntu}} required by {{AUR|pantheon-dpms-helper-git}} and {{AUR|wingpanel-indicator-power-git}}
 
* {{AUR|pantheon-print-git}}: Print settings dialog
 
* {{AUR|pantheon-print-git}}: Print settings dialog
 
* {{AUR|pantheon-polkit-agent-git}}: Polkit authentication agent
 
* {{AUR|pantheon-polkit-agent-git}}: Polkit authentication agent
Line 38: Line 45:
 
=== Theme ===
 
=== Theme ===
  
These packages contribute to the look and feel of the desktop:
+
These optional packages contribute to the look and feel of the desktop:
* {{AUR|elementary-icon-theme-git}}: Icon theme designed to be smooth, sexy, clear, and efficient (development version)
+
* {{Pkg|elementary-icon-theme}} or {{AUR|elementary-icon-theme-git}}: Icon theme designed to be smooth, sexy, clear, and efficient
 
* {{AUR|lightdm-pantheon-greeter}} or {{AUR|lightdm-pantheon-greeter-git}}: LightDM greeter
 
* {{AUR|lightdm-pantheon-greeter}} or {{AUR|lightdm-pantheon-greeter-git}}: LightDM greeter
 
It is also recommended to install the following fonts:
 
It is also recommended to install the following fonts:
* {{AUR|ttf-opensans}}: Open Sans Fonts
+
* {{Pkg|ttf-opensans}}: Open Sans Fonts
 
* {{AUR|ttf-raleway}}: Raleway Font
 
* {{AUR|ttf-raleway}}: Raleway Font
 
* {{Pkg|ttf-dejavu}}: Font family based on the Bitstream Vera Fonts
 
* {{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-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|gnu-free-fonts}}: Set of free outline fonts covering the Unicode character set
 
* {{Pkg|ttf-liberation}}: Red Hats Liberation fonts
 
* {{Pkg|ttf-liberation}}: Red Hats Liberation fonts
  
 
=== Applications ===
 
=== Applications ===
  
These are some of the original, patched, and selected packages that comprise the elementary OS software suite:
+
These are some of the original, patched, and selected packages that comprise the optional elementary OS software suite:
 
* {{Pkg|pantheon-files}} or {{AUR|pantheon-files-git}}: File explorer developed from Marlin
 
* {{Pkg|pantheon-files}} or {{AUR|pantheon-files-git}}: File explorer developed from Marlin
 
* {{Pkg|pantheon-terminal}} or {{AUR|pantheon-terminal-git}}: Terminal emulator
 
* {{Pkg|pantheon-terminal}} or {{AUR|pantheon-terminal-git}}: Terminal emulator
* {{Pkg|scratch-text-editor}} or {{AUR|scratch-text-editor-git}}: Text editor
+
* {{Pkg|pantheon-code}} or {{AUR|pantheon-code-git}}: Text editor formerly known as "Scratch"
* {{AUR|pantheon-calculator}} or {{AUR|pantheon-calculator-git}}: Calculator
+
* {{Pkg|pantheon-calculator}} or {{AUR|pantheon-calculator-git}}: Calculator
 
* {{Pkg|pantheon-music}} or {{AUR|pantheon-music-git}}: Audio player formerly known as "Noise"
 
* {{Pkg|pantheon-music}} or {{AUR|pantheon-music-git}}: Audio player formerly known as "Noise"
 
* {{Pkg|pantheon-videos}} or {{AUR|pantheon-videos-git}}: Video player formerly known as "Audience"
 
* {{Pkg|pantheon-videos}} or {{AUR|pantheon-videos-git}}: Video player formerly known as "Audience"
* {{AUR|pantheon-calendar-git}}: Calendar developed from {{AUR|maya-calendar}}, integrates default calendar with {{AUR|wingpanel-indicator-datetime-git}}
+
* {{AUR|pantheon-calendar-git}}: Calendar application formerly known as "Maya", integrates with {{AUR|wingpanel-indicator-datetime-git}}
* {{AUR|epiphany-pantheon-bzr}}: Web browser, replacing {{AUR|midori-granite}}
+
* {{AUR|epiphany-pantheon}}: Web browser replacing {{AUR|midori-granite}}
 
* {{AUR|pantheon-mail-git}}: Email client developed from {{Pkg|geary}}
 
* {{AUR|pantheon-mail-git}}: Email client developed from {{Pkg|geary}}
* {{AUR|pantheon-screenshot}} or {{AUR|pantheon-screenshot-git}}: Screenshot tool
+
* {{Pkg|pantheon-screenshot}} or {{AUR|pantheon-screenshot-git}}: Screenshot tool
 
* {{AUR|eidete-bzr}}: Simple screencaster
 
* {{AUR|eidete-bzr}}: Simple screencaster
 
* {{Pkg|pantheon-photos}} or {{AUR|pantheon-photos-git}}: Photo manager developed from {{Pkg|shotwell}}
 
* {{Pkg|pantheon-photos}} or {{AUR|pantheon-photos-git}}: Photo manager developed from {{Pkg|shotwell}}
* {{AUR|pantheon-camera-git}}: Webcam app developed from {{AUR|snap-photobooth}}
+
* {{AUR|pantheon-camera-git}}: Webcam app developed from {{AUR|snap-photobooth}}{{Broken package link|package not found}}
 
* {{AUR|elementary-scan-bzr}}: Simple scan utility (does not build)
 
* {{AUR|elementary-scan-bzr}}: Simple scan utility (does not build)
* {{AUR|switchboard}} or {{AUR|switchboard-git}}: Pluggable settings manager similar to {{Pkg|gnome-control-center}}
+
* {{Pkg|switchboard}} or {{AUR|switchboard-git}}: Pluggable settings manager similar to {{Pkg|gnome-control-center}}
  
 
== Launching Pantheon ==
 
== Launching Pantheon ==
Line 73: Line 80:
  
 
{{AUR|pantheon-session-git}} provides a {{Pkg|gnome-session}} entry for display managers such as {{Pkg|gdm}} or {{Pkg|lightdm}}.
 
{{AUR|pantheon-session-git}} provides a {{Pkg|gnome-session}} entry for display managers such as {{Pkg|gdm}} or {{Pkg|lightdm}}.
 +
 +
==== Autostart applications with a display manager ====
 +
 +
As a gnome-session, Pantheon implements [[GNOME#Autostart|XDG Autostart]].
  
 
=== Via [[xinit]] ===
 
=== Via [[xinit]] ===
  
Alternatively, you can use {{Ic|~/.xinitrc}} to launch the Pantheon shell, by adding {{ic|exec cerbere}} at to the end of the file.
+
Alternatively, you can use {{Ic|~/.xinitrc}} to launch the Pantheon shell, by adding {{ic|exec cerbere}} to the end of the file.
  
 
==== Autostart applications with ''xinit'' ====
 
==== Autostart applications with ''xinit'' ====
Line 90: Line 101:
  
 
* Launch from a [[.desktop]] file:
 
* Launch from a [[.desktop]] file:
:Use a program like {{AUR|dapper}}, {{AUR|dex-git}}, or {{AUR|fbautostart}} to implement [[Desktop_entries#Autostart|XDG autostart]].
+
:Use a program like {{AUR|dapper}}, {{AUR|dex-git}}, or {{AUR|fbautostart}} to implement [[XDG Autostart]].
  
 
==Configuration==
 
==Configuration==
  
Configure Pantheon via {{AUR|switchboard}} and its plugs (''switchboard-plug-*''), which must be installed separately. Not all of {{Pkg|gnome-control-center}}'s settings panels have been ported. Except [[plank]], all the Pantheon components store their configuration in the {{Ic|org.pantheon}} [[GNOME#Configuration|dconf key]], which can be edited with {{Pkg|dconf-editor}}.
+
Configure Pantheon via {{Pkg|switchboard}} or {{AUR|switchboard-git}} and its plugs (''switchboard-plug-*''), which must be installed separately. Not all of {{Pkg|gnome-control-center}}'s settings panels have been ported. In addition, except [[plank]], all the Pantheon components store their configuration in the {{Ic|org.pantheon}} or {{Ic|io.elementary}} [[GNOME#Configuration|gsettings keys]], which can be edited with {{Pkg|dconf-editor}}.
  
{{Note|{{AUR|switchboard-plug-elementary-tweaks-git}} provides easy access to [https://raw.githubusercontent.com/elementary-tweaks/elementary-tweaks/master/docs/screenshot.png customizations for various aspects of the Pantheon desktop and applications], similar to {{Pkg|gnome-tweak-tool}}.}}
+
{{Note|{{AUR|switchboard-plug-elementary-tweaks-git}} provides easy access to [https://raw.githubusercontent.com/elementary-tweaks/elementary-tweaks/master/docs/screenshot.png customizations for various aspects of the Pantheon desktop and applications], similar to {{Pkg|gnome-tweaks}}.}}
  
=== Plank ===
+
=== Wingpanel ===
  
==== Adding new application icons ====
+
Wingpanel does not come with any indicators; they must be installed separately.
  
Either drag and drop a desktop file on to the dock, or right click on a running application and select "Keep in dock". You can then reorder icons by drag and drop.
+
At the minimum, you'll probably want to install:
{{Note|Plank stores its configuration files in {{ic|~/.config/plank/}}}}
+
* {{AUR|pantheon-applications-menu}} or {{AUR|pantheon-applications-menu-git}}: Applications menu and "Run" dialog
 +
* {{AUR|wingpanel-indicator-datetime}} or {{AUR|wingpanel-indicator-datetime-git}}: Clock and calendar widget
 +
* {{AUR|wingpanel-indicator-session}} or {{AUR|wingpanel-indicator-session-git}}: User and session menu (Switch user, Logout, Shutdown, etc.)
  
=== Pantheon Files ===
+
{{Note|{{AUR|wingpanel}} supports [[Unity|Ayatana indicators]], while {{AUR|wingpanel-git}} has native indicators (''wingpanel-indicator-*-git'').}}
  
==== Enable context menu entries ====
+
==== Third-party indicators ====
  
If you want to enable context menu entries such as for {{Pkg|file-roller}} to extract/compress archives, then you have to additionally install {{Pkg|contractor}}.
+
* If launched by a [[#Via Display manager|display manager]], append {{Ic|Pantheon;}} to {{ic|1=OnlyShowIn=}} in third-party indicators' [[XDG_Autostart|*.desktop files]]
  
=== Terminal ===
+
* If launched by [[#Via xinit|~/.xinitrc]], add third-party indicators to one of the start-up methods described [[#Launching Pantheon|above]].
  
====Opacity====
+
* [[Unity|Ayatana Indicators]] require {{AUR|wingpanel-indicator-ayatana}} or {{AUR|wingpanel-indicator-ayatana-git}} to appear in {{AUR|wingpanel-git}}.
  
To make {{Pkg|pantheon-terminal}} (semi-)transparent, [[#Configuration|set the dconf key]] {{ic|org.pantheon.terminal.settings.opacity}} to your desired opacity; for {{AUR|pantheon-terminal-git}}, the background color and transparency are set by {{ic|org.pantheon.terminal.settings.background}}.
+
==== Indicator-session menus unresponsive ====
  
== Known Issues ==
+
* {{AUR|indicator-session}} relies on dbus methods provided by [[Unity]] for most of its functions and fails to fallback to gnome or systemd methods in its absence.
{{Out of date|This information is quite old; some of these issues may have been resolved.}}
 
=== Usability ===
 
  
==== Cannot interact with the LightDM Pantheon greeter ====
+
* {{AUR|wingpanel-indicator-session-git}} needs [[light-locker]] or {{AUR|xscreensaver-dbus-screenlock}} installed for the {{Ic|Lock}} menu item.
  
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
+
=== Plank ===
  
==== Gala crashes on start ====
+
==== Adding new application icons ====
  
Unconfigured gala tries to use default gnome wallpaper, which is absent unless you have the package {{Pkg|gnome-themes-standard}} installed. Install it workaround the crash; it is safe to remove after you configure another wallpaper.
+
Either drag and drop a desktop file on to the dock, or right click on a running application and select "Keep in dock". You can then reorder icons by drag and drop.
 +
{{Note|Plank stores .dockitem launchers in {{ic|~/.config/plank/}} and configuration in the gsettings key {{ic|net.launchpad.plank}}}}
  
==== No mouse cursor after login ====
+
=== Pantheon Files ===
  
The Gala window manager is most likely not running. Either install {{AUR|cerbere-git}} or add {{ic|gala}} to the list of cerbere's [[#Via_xinit|monitored processes]].
+
==== Enable context menu entries ====
  
=== Indicators ===
+
If you want to enable context menu entries such as for {{Pkg|file-roller}} to extract/compress archives, then you have to additionally install {{Pkg|contractor}} or {{AUR|contractor-git}}.
  
==== Indicators not appearing in wingpanel ====
+
=== Terminal ===
  
Wingpanel does not come with any indicators; they must be installed separately.
+
====Opacity====
{{Note|{{AUR|wingpanel}} supports [[Unity|Ayatana indicators]], while {{AUR|wingpanel-git}} has native indicators (''wingpanel-indicator-*-git'').}}
 
  
==== Third-party indicators ====
+
To make {{Pkg|pantheon-terminal}} (semi-)transparent, [[#Configuration|set the dconf key]] {{ic|org.pantheon.terminal.settings.opacity}} to your desired opacity; for {{AUR|pantheon-terminal-git}}, the background color and transparency are set by {{ic|io.elementary.terminal.settings.background}}.
  
* If launched by a [[#Via Display manager|display manager]], append {{Ic|Pantheon}} to {{ic|1=OnlyShowIn=}} in third-party indicators' [[Desktop_entries#Autostart|*.desktop files]]
+
== Known Issues ==
 
 
* If launched by [[#Via xinit|~/.xinitrc]], add third-party indicators to one of the start-up methods described [[#Launching Pantheon|above]].
 
 
 
* For {{AUR|wingpanel-git}}, indicators designed for [[Unity]] require {{AUR|wingpanel-indicator-ayatana-bzr}}{{Broken package link|package not found}}.
 
 
 
==== Indicator-session menus not responsive ====
 
 
 
* {{AUR|indicator-session}} relies on dbus methods provided by [[Unity]] for most of its functions and fails to fallback to gnome or systemd methods in its absence.
 
 
 
* {{AUR|wingpanel-indicator-session-git}} needs [[light-locker]] or {{AUR|xscreensaver-dbus-screenlock}} installed for the {{Ic|Lock}} menu item.
 
  
 
=== Appearance ===
 
=== Appearance ===
Line 158: Line 159:
 
==== Pantheon-terminal transparency ====
 
==== Pantheon-terminal transparency ====
  
Transparency in pantheon-terminal is not yet fully functional with GTK themes other than the elmentary OS theme. Either use {{AUR|gtk-theme-elementary}}, {{AUR|gtk-theme-elementary-git}} or add [http://bazaar.launchpad.net/~elementary-design/egtk/4.x/revision/210 this] code to your theme or the override file in {{ic|~/.config/gtk-3.0/gtk.css}}.
+
Transparency in pantheon-terminal is not yet fully functional with GTK themes other than the elmentary OS theme. Either use {{AUR|gtk-theme-elementary}}, {{AUR|gtk-theme-elementary-git}} or add the following code to your theme's css or the override file in {{ic|~/.config/gtk-3.0/gtk.css}}:
 +
/************
 +
  * Terminal *
 +
  ***********/
 +
 +
PantheonTerminalPantheonTerminalWindow.background {
 +
    background-color: transparent;
 +
}
  
 
==== Wingpanel transparency ====
 
==== Wingpanel transparency ====
Line 164: Line 172:
 
Wingpanel is transparent by design when using {{AUR|gtk-theme-elementary}} or {{AUR|gtk-theme-elementary-git}}, and becomes opaque when a maximized window occupies your screen. However, using other GTK themes will produce a solid panel most of the time.
 
Wingpanel is transparent by design when using {{AUR|gtk-theme-elementary}} or {{AUR|gtk-theme-elementary-git}}, and becomes opaque when a maximized window occupies your screen. However, using other GTK themes will produce a solid panel most of the time.
  
To achieve the former behavior within other themes, add the following lines to the end of its css or the override file in {{ic|~/.config/gtk-3.0/gtk.css}}:
+
To achieve the former behavior within another theme, add the following code to its css or the override file in {{ic|~/.config/gtk-3.0/gtk.css}}:
  
 
  /*********************
 
  /*********************
 
   * wingpanel support *
 
   * wingpanel support *
 
   ********************/
 
   ********************/
 +
 
  .panel {
 
  .panel {
 
     background-color: transparent;
 
     background-color: transparent;
Line 177: Line 186:
 
     background-color: #000;
 
     background-color: #000;
 
  }
 
  }
 
==== GTK+ applications surrounded by awful black shadow box ====
 
 
The elementary GTK theme seems to be using its own files and ignoring the {{Ic|~/.config/gtk-3.0/gtk.css}} user-override config file. This has been reported on https://bugs.launchpad.net/elementaryos/+bug/1592441. To work around the issue, go to the file {{Ic|/usr/share/themes/elementary/gtk-3.0/gtk-widgets.css}} and look for the following (around line 3669):
 
 
decoration,
 
.window-frame {
 
    border-radius: 4px 4px 0 0;
 
    box-shadow: 0 0 0 1px alpha (#000, 0.3),
 
                0 14px 28px rgba(0,0,0,0.35),
 
                0 10px 10px rgba(0,0,0,0.22);
 
    margin: 12px;
 
}
 
 
Replace the above by the the code below
 
 
decoration,
 
.window-frame {
 
    box-shadow: none;
 
    border: none;
 
    padding: 0;
 
    margin: 0;
 
}
 
 
==== 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-git}} or, for {{AUR|gtk-theme-elementary}}, add the following line to {{ic|gtk-widgets.css}}:
 
 
GtkToolItem { color: @text_color; }
 

Revision as of 11:18, 15 July 2019

Pantheon is the desktop environment originally created for the elementary OS distribution. It is written from scratch in Vala, using GTK3 and Granite. With regards to usability and appearance, the desktop has some similarities with GNOME Shell and macOS.

Project Status

Although the elementary OS release schedule and toolchain are bound to Ubuntu's LTS release cycle, development moves quickly and has recently moved to github.

Installation

Packages

Unofficial repository

Alucryd's unofficial repository contains more and more up-to-date packages than the few available in the community repository. To use it add the following lines at the top of your sources in /etc/pacman.conf:

[extra-alucryd]
Server = https://pkgbuild.com/~alucryd/$repo/$arch

Do note that some packages are missing from the repository due to issues with upstream. You will have to supplement the repo with locally compiled packages.

AUR

Alternatively, the PKGBUILDs for the pantheon packages are also available in the AUR.

Desktop Environment

For the minimal Pantheon shell, install pantheon-session-gitAUR, which pulls--among other dependencies--the core components:

Services and Configuration

These optional packages provide background services and default settings for Pantheon and elementary OS applications:

Theme

These optional packages contribute to the look and feel of the desktop:

It is also recommended to install the following fonts:

Applications

These are some of the original, patched, and selected packages that comprise the optional elementary OS software suite:

Launching Pantheon

Via Display manager

pantheon-session-gitAUR provides a gnome-session entry for display managers such as gdm or lightdm.

Autostart applications with a display manager

As a gnome-session, Pantheon implements XDG Autostart.

Via xinit

Alternatively, you can use ~/.xinitrc to launch the Pantheon shell, by adding exec cerbere to the end of the file.

Autostart applications with xinit

For applications which do not provide a systemd unit, consider these options:

  • Run once when X starts:
Add it to your ~/.xinitrc Shell script, before the exec cerbere line.
  • Keep running in the background:
Add it to the dconf key org.pantheon.desktop.cerbere.monitored-processes.
Should the process stop, cerbereAUR will respawn it.
Use a program like dapperAUR, dex-gitAUR, or fbautostartAUR to implement XDG Autostart.

Configuration

Configure Pantheon via switchboard or switchboard-gitAUR and its plugs (switchboard-plug-*), which must be installed separately. Not all of gnome-control-center's settings panels have been ported. In addition, except plank, all the Pantheon components store their configuration in the org.pantheon or io.elementary gsettings keys, which can be edited with dconf-editor.

Wingpanel

Wingpanel does not come with any indicators; they must be installed separately.

At the minimum, you'll probably want to install:

Note: wingpanelAUR supports Ayatana indicators, while wingpanel-gitAUR has native indicators (wingpanel-indicator-*-git).

Third-party indicators

  • If launched by ~/.xinitrc, add third-party indicators to one of the start-up methods described above.

Indicator-session menus unresponsive

  • indicator-sessionAUR relies on dbus methods provided by Unity for most of its functions and fails to fallback to gnome or systemd methods in its absence.

Plank

Adding new application icons

Either drag and drop a desktop file on to the dock, or right click on a running application and select "Keep in dock". You can then reorder icons by drag and drop.

Note: Plank stores .dockitem launchers in ~/.config/plank/ and configuration in the gsettings key net.launchpad.plank

Pantheon Files

Enable context menu entries

If you want to enable context menu entries such as for file-roller to extract/compress archives, then you have to additionally install contractor or contractor-gitAUR.

Terminal

Opacity

To make pantheon-terminal (semi-)transparent, set the dconf key org.pantheon.terminal.settings.opacity to your desired opacity; for pantheon-terminal-gitAUR, the background color and transparency are set by io.elementary.terminal.settings.background.

Known Issues

Appearance

Pantheon-terminal transparency

Transparency in pantheon-terminal is not yet fully functional with GTK themes other than the elmentary OS theme. Either use gtk-theme-elementaryAUR, gtk-theme-elementary-gitAUR or add the following code to your theme's css or the override file in ~/.config/gtk-3.0/gtk.css:

/************
 * Terminal *
 ***********/

PantheonTerminalPantheonTerminalWindow.background {
   background-color: transparent;
}

Wingpanel transparency

Wingpanel is transparent by design when using gtk-theme-elementaryAUR or gtk-theme-elementary-gitAUR, and becomes opaque when a maximized window occupies your screen. However, using other GTK themes will produce a solid panel most of the time.

To achieve the former behavior within another theme, add the following code to its css or the override file in ~/.config/gtk-3.0/gtk.css:

/*********************
 * wingpanel support *
 ********************/

.panel {
    background-color: transparent;
    transition: all 1s ease-in-out;
}

.panel.maximized {
    background-color: #000;
}