Differences between revisions 23 and 98 (spanning 75 versions)
Revision 23 as of 2012-10-18 18:05:36
Size: 2914
Editor: Calinou
Comment:
Revision 98 as of 2022-07-26 13:54:26
Size: 10914
Editor: vauss
Comment: typo fix
Deletions are marked like this. Additions are marked like this.
Line 2: Line 2:
~-[[DebianWiki/EditorGuide#translation|Translation(s)]]: English - [[fr/Xfce|Français]] - [[it/Xfce|Italiano]] - [[ko/Xfce|한국어]] - [[ru/Xfce|Русский]] - [[es/Xfce|Español]] - [[zh_CN/Xfce|简体中文]]-~
----

~-[[DebianWiki/EditorGuide#translation|Translation(s)]]:
English - [[es/Xfce|Español]] - [[fr/Xfce|Français]] - [[he/Xfce|עברית]] - [[it/Xfce|Italiano]] - [[ko/Xfce|한국어]] - [[pt_BR/Xfce|Português (Brasil)]] - [[ru/Xfce|Русский]] - [[sv/Xfce|Svenska]] - [[uk/Xfce|Українська]] - [[zh_CN/Xfce|简体中文]]-~

----

|| {{https://upload.wikimedia.org/wikipedia/commons/5/5b/Xfce_logo.svg|Xfce Logo (GPLv2)|width=200}} || {{https://screenshots.debian.net/screenshots/000/018/423/large.png|Xfce Logo (GPLv2)|height=200)}} ||


 . '''[[WikiPedia:Xfce|Xfce]]''' is a lightweight [[DesktopEnvironment|desktop environment]] for Unix-like operating systems. It aims to be fast and lightweight, while still being visually appealing and easy to use.


Xfce consists of a number of components that together provide the full functionality of a desktop environment. They are packaged separately and you can pick and choose from the available packages to create the best personal working environment.

One of Xfce's priorities is adherence to standards, specifically those defined at freedesktop.org. This allows Xfce to seamlessly interoperate with programs written for other desktop environments, if those programs follow the specified standards.

Xfce is based on [[GTK]] 3 in 4.14 and newer. Xfce 4.12 and earlier (as found in [[DebianBuster|Debian 10]] and earlier) are based on GTK 2.

Line 5: Line 22:
== Introduction ==
'''Xfce''' is a lightweight desktop environment for Unix-like operating systems. It aims to be fast and lightweight, while still being visually appealing and easy to use.

Xfce is based on GTK+ version 2 (like [[Gnome|Gnome 2]]). One of Xfce priorities is adherence to standards, specifically those defined at freedesktop.org. This allows Xfce to seamlessly interoperate with programs written for other desktop environments, if those programs follow the specified standards.

Xfce consists of a number of components that together provide the full functionality of a desktop environment. They are packaged separately and you can pick and choose from the available packages to create the best personal working environment.

=== Versions ===

 * [[DebianSqueeze|Debian Squeeze]] contains Xfce 4.6.
 * [[DebianWheezy|Debian Wheezy]] contains Xfce 4.8.
 * [[DebianUnstable|Debian Sid]] contains Xfce 4.8.

== How to install Xfce ==

=== Install a fresh system with Xfce ===

If you install a new system, you can choose to install Xfce directly :
 1. At the [[DebianInstaller|Debian Installer]] boot prompt, press the {{{tab}}} key to edit the command line, then add
  * {{{desktop=xfce}}}
 2. When prompted to select the task to install, make sure you click "Desktop Environment"

See ''Selecting and Installing Software'' in the installation guide ([[http://www.debian.org/releases/stable/i386/ch06s03#pkgsel|i386]], [[http://www.debian.org/releases/stable/amd64/ch06s03#pkgsel|amd64]]).

----


== Installation ==

=== Install a new Debian system with Xfce ===

During [[DebianInstaller|Debian installation]], select `Xfce desktop environment` at the [[https://www.debian.org/releases/stable/i386/ch06s03#pkgsel|Selecting and Installing Software]] installation step.


Alternatively, at the [[DebianInstaller|Debian Installer]] boot prompt, press the `Tab` key to edit the command line, then add `desktop=xfce`.

For a complete rundown refer to the [[DebianDesktopHowTo|Debian Desktop Howto]].


=== Run Debian Live with Xfce ===

A [[DebianLive|Debian live system]] with Xfce is available at https://cdimage.debian.org/debian-cd/current-live/amd64/iso-hybrid/
Line 31: Line 45:
To get a bare minimum base install of X, do: {{{
aptitude install xorg
}}}

To install Xfce, do the following: {{{
aptitude install xfce4
}}}

This will install a meta package, which will install the core XFCE modules and scripts to get it to work.

There are many useful utilities that come with XFCE, to install these: {{{
aptitude install xfce4-goodies
}}}
You can install Xfce as the only desktop environment on your computer, or alongside another desktop environment. Your [[DisplayManager|display manager]] should allow you to select the appropriate desktop before logging in.

To install the full Xfce desktop environment and utilities, [[PackageManagement#Installing.2C_removing.2C_upgrading_software|install]] the [[DebianPkg:xfce4]] package.

DebianPkg:xfce4-goodies is a metapackage that will install many useful plugins and applications related to Xfce. It's a suggested package for standard users that want a complete Xfce desktop experience, however you may have a more "minimal" installation by only installing the specific packages that you want from the list below.

You can [[Software#Finding_Software|search]] for packages using the `xfce4` search term. The "main" Xfce packages are:

 * [[DebianPkg:thunar]] - File Manager for Xfce
 * [[DebianPkg:xfdesktop4]] - xfce desktop background, icons and root menu manager
 * [[DebianPkg:xfwm4]] - window manager of the Xfce project
 * [[DebianPkg:xfce4-panel]] - panel for Xfce4 desktop environment
 * [[DebianPkg:xfce4-settings]] - graphical application for managing Xfce settings
 * [[DebianPkg:xfce4-power-manager]] - power manager for Xfce desktop
 * [[DebianPkg:xfce4-session]] - Xfce4 Session Manager
 * [[DebianPkg:xfconf]] - utilities for managing settings in Xfce
 * [[DebianPkg:xfce4-notifyd]] - simple, visually-appealing notification daemon for Xfce


Xfce also provides utilities that are frequently used on a personal computer:

 * [[DebianPkg:mousepad]] - simple Xfce oriented text editor
 * [[DebianPkg:ristretto]] - lightweight picture-viewer for the Xfce desktop environment
 * [[DebianPkg:xfce4-taskmanager]] - process manager for the Xfce4 Desktop Environment
 * [[DebianPkg:xfce4-screenshooter]] - screenshots utility for Xfce
 * [[DebianPkg:xfce4-terminal]] - Xfce terminal emulator
 * [[DebianPkg:xfce4-notes]] - Notes application for the Xfce4 desktop
 * [[DebianPkg:xfce4-appfinder]] - Application finder for the Xfce4 Desktop Environment
 * [[DebianPkg:xfce4-clipman]] - clipboard history utility
 * [[DebianPkg:xfwm4-themes]] - Theme files for xfwm4
 * [[DebianPkg:xfburn]] - CD-burner application for Xfce Desktop Environment
 * [[DebianPkg:orage]] - Calendar for Xfce Desktop Environment

The Xfce panel provides a window list, application launchers/menus, a clock, and can be extended using many plugins/applets:

 * [[DebianPkg:xfce4-whiskermenu-plugin]] - Alternate menu plugin for the Xfce desktop environment
 * [[DebianPkg:xfce4-indicator-plugin]] - plugin to display information from applications in the Xfce4 panel
 * [[DebianPkg:xfce4-pulseaudio-plugin]] - Xfce4 panel plugin to control pulseaudio
 * [[DebianPkg:xfce4-battery-plugin]] - battery monitor plugin for the Xfce4 panel
 * [[DebianPkg:xfce4-power-manager-plugins]] - power manager plugins for Xfce panel
 * [[DebianPkg:xfce4-clipman-plugin]] - clipboard history plugin for Xfce panel
 * [[DebianPkg:xfce4-datetime-plugin]] - date and time plugin for the Xfce4 panel
 * And many more:
[[DebianPkg:xfce4-genmon-plugin]],
[[DebianPkg:xfce4-linelight-plugin]],
[[DebianPkg:xfce4-mailwatch-plugin]],
[[DebianPkg:xfce4-messenger-plugin]],
[[DebianPkg:xfce4-mount-plugin]],
[[DebianPkg:xfce4-mpc-plugin]],
[[DebianPkg:xfce4-netload-plugin]],
[[DebianPkg:xfce4-notes-plugin]],
[[DebianPkg:xfce4-places-plugin]],
[[DebianPkg:xfce4-quicklauncher-plugin]],
[[DebianPkg:xfce4-radio-plugin]],
[[DebianPkg:xfce4-screenshooter-plugin]],
[[DebianPkg:xfce4-sensors-plugin]],
[[DebianPkg:xfce4-smartbookmark-plugin]],
[[DebianPkg:xfce4-systemload-plugin]],
[[DebianPkg:xfce4-timer-plugin]],
[[DebianPkg:xfce4-verve-plugin]],
[[DebianPkg:xfce4-wavelan-plugin]],
[[DebianPkg:xfce4-weather-plugin]],
[[DebianPkg:xfce4-wmdock-plugin]],
[[DebianPkg:xfce4-xkb-plugin]],
[[DebianPkg:xfce4-cpufreq-plugin]],
[[DebianPkg:xfce4-cpugraph-plugin]],
[[DebianPkg:xfce4-dict]],
[[DebianPkg:xfce4-diskperf-plugin]],
[[DebianPkg:xfce4-equake-plugin]],
[[DebianPkg:xfce4-fsguard-plugin]],
[[DebianPkg:xfce4-hdaps]]
----
Line 47: Line 119:
For '''GDM/KDM''' choose xfce4-session.

For '''startx''' add in file ~/.xinitrc:
{{{
exec ck-launch-session startxfce4
}}}
For '''slim''' boot session in /etc/slim.conf:
{{{
login_cmd exec ck-launch-session /bin/bash -login /etc/X11/Xsession %session
}}}

You also can install DebianPkg:xdm to login in start Xfce.

== Other Packages ==

Other packages that can be found with: {{{
aptitude search xfce4
}}}
=== From a display manager ===

Select Xfce from your [[DisplayManager|display manager]] (desktop login screen).

Most display managers will detect Xfce automatically.

For the [[DebianPkg:slim]] display manager, edit `/etc/slim.conf` and set `login_cmd exec ck-launch-session /bin/bash -login /etc/X11/Xsession %session`

=== From the console ===

Xfce can be started from the console simply by running the {{{startxfce4}}} command. {{{startxfce4}}} is a script that sets the required environment variables and calls Xinit to start the X server with the Xfce session.
----
== Troubleshooting ==

=== Preventing screen-tearing ===

In the ''Window Manager Tweaks'' section of your settings application, under the ''Compositor'' tab, uncheck the ''Enable display compositing'' box. This will disable some graphical effects but also can help reduce screen-tearing.

Since Xfce 4.14, V-Sync can also be enabled through the use of commands. You might try running:
{{{
xfconf-query -c xfwm4 -p /general/vblank_mode -s MODE
}}}
where {{{MODE}}} can be either {{{vblank}}}, {{{glx}}}, or {{{xpresent}}}. You may experiment with different options to see which is the most effective at reducing screen-tearing for you.

Advanced users may look into replacing the default Xfwm4 window manager and compositor with DebianPkg:compton instead, which has been noted by some users to also reduce or eliminate screen-tearing.

=== Resetting to defaults ===

Try running:
{{{
mv ~/.config/xfce4-session/ ~/.config/xfce4-session-bak
mv ~/.config/xfce4/ ~/.config/xfce4-bak
}}}
These two commands will rename your configuration directories, forcing Xfce to regenerate them when you next start it. If you want to restore your old configuration, you may remove the {{{-bak}}} that's been appended to the old directories.

=== Suspend and backlight issues ===

As of 05/15/2020, there are 2 rules files missing from `/etc/polkit-1/` that are required to make xfce4-power-manager work properly ([[https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=773743|bug 773743]]):
 * One is for the backlight permission (`authentication is required to modify laptop display brightness`)
 * The other is for suspend permission (`authentication is required to suspend the system`)


In order to get suspend issue corrected perform the following:

{{{
# create the necessary directory
$ sudo mkdir /etc/polkit-1/rules.d
$ sudo chmod 755 /etc/polkit-1/rules.d
# create the new configuration file, with the following content
$ sudo nano /etc/polkit-1/rules.d/85-suspend.rules
}}}

{{{
polkit.addRule(function(action, subject) {
    if (action.id == "org.freedesktop.login1.suspend" &&
        subject.isInGroup("users")) {
        return polkit.Result.YES;
    }
});
}}}

{{{
# fix permissions on the configuration file
$ sudo chmod 644 /etc/polkit-1/rules.d/85-suspend.rules
# in the following file, change the "suspend" rules to <allow_any>yes</allow_any>
$ sudo nano /usr/share/polkit-1/actions/org.freedesktop.login1.policy
}}}



The process is similar to fix the backlight modification authentication errors:

{{{
# create the necessary directory
$ sudo mkdir /etc/polkit-1/rules.d
# fix permissions on the directory
$ sudo chmod 755 /etc/polkit-1/rules.d
# create the configuration file with the following content
$ sudo nano /etc/polkit-1/rules.d/89-backlight.rules
}}}

{{{
polkit.addRule(function(action, subject) {
    if (action.id == "org.xfce.power.backlight-helper" &&
        subject.isInGroup("users")) {
        return polkit.Result.YES;
    }
});
}}}


{{{
# fix permissions on the configuration file
$ sudo chmod 644 /etc/polkit-1/rules.d/89-backlight.rules
# in the following file change the "backlight" rules to <allow_any>yes</allow_any>
$ sudo nano /usr/share/polkit-1/actions/org.freedesktop.login1.policy
}}}


This will prevent authentication errors/credentials dialogs from appearing.

Line 68: Line 224:
 * http://www.xfce.org - The Xfce website;
 * [[irc://irc.freenode.net/%23xfce|#xfce]] - [[IRC]] channel
 * http://pkg-xfce.alioth.debian.org - The Debian Xfce packaging website

----
CategoryDesktopEnvironment
 * '''[[https://www.xfce.org|Xfce Desktop Environment - Official website]]'''
 * '''[[https://docs.xfce.org/|Xfce documentation]]'''
 * [[WikiPedia:Xfce|Xfce - Wikipedia]]
 * [[https://wiki.archlinux.org/index.php/Xfce|Xfce - ArchWiki]]
 * [[ircs://irc.freenode.net/xfce|#xfce]] - [[IRC]] channel
 * Bugs: [[DebianBug:xfce4|Debian BTS]], [[https://bugzilla.xfce.org/|Xfce bugzilla]]
 * [[Teams/DebianXfceGroup]] - The Debian Xfce packaging team


----

CategoryDesktopEnvironment | CategorySoftware

Translation(s): English - Español - Français - עברית - Italiano - 한국어 - Português (Brasil) - Русский - Svenska - Українська - 简体中文


Xfce Logo (GPLv2)

Xfce Logo (GPLv2)

  • Xfce is a lightweight desktop environment for Unix-like operating systems. It aims to be fast and lightweight, while still being visually appealing and easy to use.

Xfce consists of a number of components that together provide the full functionality of a desktop environment. They are packaged separately and you can pick and choose from the available packages to create the best personal working environment.

One of Xfce's priorities is adherence to standards, specifically those defined at freedesktop.org. This allows Xfce to seamlessly interoperate with programs written for other desktop environments, if those programs follow the specified standards.

Xfce is based on GTK 3 in 4.14 and newer. Xfce 4.12 and earlier (as found in Debian 10 and earlier) are based on GTK 2.


Installation

Install a new Debian system with Xfce

During Debian installation, select Xfce desktop environment at the Selecting and Installing Software installation step.

Alternatively, at the Debian Installer boot prompt, press the Tab key to edit the command line, then add desktop=xfce.

For a complete rundown refer to the Debian Desktop Howto.

Run Debian Live with Xfce

A Debian live system with Xfce is available at https://cdimage.debian.org/debian-cd/current-live/amd64/iso-hybrid/

Install Xfce in an already installed system

You can install Xfce as the only desktop environment on your computer, or alongside another desktop environment. Your display manager should allow you to select the appropriate desktop before logging in.

To install the full Xfce desktop environment and utilities, install the xfce4 package.

xfce4-goodies is a metapackage that will install many useful plugins and applications related to Xfce. It's a suggested package for standard users that want a complete Xfce desktop experience, however you may have a more "minimal" installation by only installing the specific packages that you want from the list below.

You can search for packages using the xfce4 search term. The "main" Xfce packages are:

Xfce also provides utilities that are frequently used on a personal computer:

The Xfce panel provides a window list, application launchers/menus, a clock, and can be extended using many plugins/applets:

xfce4-genmon-plugin, xfce4-linelight-plugin, xfce4-mailwatch-plugin, xfce4-messenger-plugin, xfce4-mount-plugin, xfce4-mpc-plugin, xfce4-netload-plugin, xfce4-notes-plugin, xfce4-places-plugin, xfce4-quicklauncher-plugin, xfce4-radio-plugin, xfce4-screenshooter-plugin, xfce4-sensors-plugin, xfce4-smartbookmark-plugin, xfce4-systemload-plugin, xfce4-timer-plugin, xfce4-verve-plugin, xfce4-wavelan-plugin, xfce4-weather-plugin, xfce4-wmdock-plugin, xfce4-xkb-plugin, xfce4-cpufreq-plugin, xfce4-cpugraph-plugin, xfce4-dict, xfce4-diskperf-plugin, xfce4-equake-plugin, xfce4-fsguard-plugin, xfce4-hdaps


Run Xfce

From a display manager

Select Xfce from your display manager (desktop login screen).

Most display managers will detect Xfce automatically.

For the slim display manager, edit /etc/slim.conf and set login_cmd exec ck-launch-session /bin/bash -login /etc/X11/Xsession %session

From the console

Xfce can be started from the console simply by running the startxfce4 command. startxfce4 is a script that sets the required environment variables and calls Xinit to start the X server with the Xfce session.


Troubleshooting

Preventing screen-tearing

In the Window Manager Tweaks section of your settings application, under the Compositor tab, uncheck the Enable display compositing box. This will disable some graphical effects but also can help reduce screen-tearing.

Since Xfce 4.14, V-Sync can also be enabled through the use of commands. You might try running:

xfconf-query -c xfwm4 -p /general/vblank_mode -s MODE

where MODE can be either vblank, glx, or xpresent. You may experiment with different options to see which is the most effective at reducing screen-tearing for you.

Advanced users may look into replacing the default Xfwm4 window manager and compositor with compton instead, which has been noted by some users to also reduce or eliminate screen-tearing.

Resetting to defaults

Try running:

mv ~/.config/xfce4-session/ ~/.config/xfce4-session-bak
mv ~/.config/xfce4/ ~/.config/xfce4-bak

These two commands will rename your configuration directories, forcing Xfce to regenerate them when you next start it. If you want to restore your old configuration, you may remove the -bak that's been appended to the old directories.

Suspend and backlight issues

As of 05/15/2020, there are 2 rules files missing from /etc/polkit-1/ that are required to make xfce4-power-manager work properly (bug 773743):

  • One is for the backlight permission (authentication is required to modify laptop display brightness)

  • The other is for suspend permission (authentication is required to suspend the system)

In order to get suspend issue corrected perform the following:

# create the necessary directory
$ sudo mkdir /etc/polkit-1/rules.d
$ sudo chmod 755 /etc/polkit-1/rules.d
# create the new configuration file, with the following content
$ sudo nano /etc/polkit-1/rules.d/85-suspend.rules

polkit.addRule(function(action, subject) {
    if (action.id == "org.freedesktop.login1.suspend" &&
        subject.isInGroup("users")) {
        return polkit.Result.YES;
    }
});

# fix permissions on the configuration file
$ sudo chmod 644 /etc/polkit-1/rules.d/85-suspend.rules
# in the following file, change the "suspend" rules to <allow_any>yes</allow_any>
$ sudo nano /usr/share/polkit-1/actions/org.freedesktop.login1.policy

The process is similar to fix the backlight modification authentication errors:

# create the necessary directory
$ sudo mkdir /etc/polkit-1/rules.d
# fix permissions on the directory
$ sudo chmod 755 /etc/polkit-1/rules.d
# create the configuration file with the following content
$ sudo nano /etc/polkit-1/rules.d/89-backlight.rules

polkit.addRule(function(action, subject) {
    if (action.id == "org.xfce.power.backlight-helper" &&
        subject.isInGroup("users")) {
        return polkit.Result.YES;
    }
});

# fix permissions on the configuration file
$ sudo chmod 644 /etc/polkit-1/rules.d/89-backlight.rules
# in the following file change the "backlight" rules to <allow_any>yes</allow_any>
$ sudo nano /usr/share/polkit-1/actions/org.freedesktop.login1.policy

This will prevent authentication errors/credentials dialogs from appearing.


CategoryDesktopEnvironment | CategorySoftware