~~NOTOC~~
{{ :apps:xfce4-panel-profiles.png?nolink|}}
====== Xfce Panel Profiles ======
  * **[[#Introduction|Introduction]]**
  * **[[#Usage|Usage]]**
  * **[[#Required Packages|Required Packages]]**
  * **[[#Latest Release|Latest Release]]**
  * **[[#Source Code Repository|Source Code Repository]]**
  * **[[#Reporting Bugs|Reporting Bugs]]**

----

===== Introduction =====

Xfce Panel Profiles (''xfce4-panel-profiles'', formerly known as ''xfpanel-switch'') is a simple application to manage Xfce panel layouts.

With the modular Xfce Panel, a multitude of panel layouts can be created. This tool makes it possible to backup, restore, import, and export these panel layouts.

----

===== Usage =====

Panel profiles main window shows a two columns table: on the left there is the configuration's name, at the right the last modification time. The first entry is always the current configuration, all other entries are custom user profiles or provided by the operating system by default.

<figure "Panel Profiles Window">
{{:apps:xfce4-panel-profiles:4.18:xfce4-panel-profiles-window.png?350|xfce4-panel-profile Window}}
</figure>

To perform any actions, you need to first select the configuration that you want to consider. Then you can select a button on the bottom bar. The available tasks, from the left to right are:

? Apply a configuration
! You can apply the selected configuration, if you click {gui>Apply} button. It will be instantly applied to the panel. <note warning>The old current configuration will be lost if you apply a different configuration. Make a backup before doing this!</note>
? Save a configuration
! You can make a backup of the selected configuration, if you click {gui>Save} button. It will open a dialog, you can insert a name for the copied configuration. <note tip>Custom saved configurations are usually stored in ''~/.local/share/xfce4-panel-profiles''.</note>
? Remove a configuration
! You can remove the selected configuration, if is possible, if you click {gui>Remove} button. <note warning>Removed configurations cannot be restored!</note>
? Export a configuration
! You can export the selected configuration if you click {gui>Export} button. It will open a file chooser dialog to allow you to insert the file name and position.
? Import a configuration
! You can import a previously exported configuration if you click {gui>Import} button. It will open a file chooser dialog to allow you to select the configuration you want to import.

[[|Back To Top]]
----

==== Command line usage ====

Panel profiles provides two command line options that allow you to load and activate a panel profile or save the current configuration.

  xfce4-panel-profiles <load|save> <file>
  
If you launch ''xfce4-panel-profiles'' without any available options, it launches the graphical user interface.

=== Examples ===

Save current configuration to ''current-config.tar.bz2'':

  xfce4-panel-profiles save current-config.tar.bz2
  
Load and apply previously saved configuration:

  xfce4-panel-profiles load current-config.tar.bz2
  
<note important>Panel profiles saves the current configuration in the current working directory, so it may overwrite an existent file!</note>

[[|Back To Top]]
----

===== Required Packages =====

  * xfce4-panel
  * python3
  * python3-gi (>= 3.0)

----

===== Latest Release =====
{{rss>https://archive.xfce.org/feeds/project/xfce4-panel-profiles 1 date 2h}}

[[https://gitlab.xfce.org/apps/xfce4-panel-profiles/-/blob/master/NEWS|Read the CHANGELOG]]

  * **[[https://archive.xfce.org/src/apps/xfce4-panel-profiles/|Download current release]]** (older versions of this component are also available here)

[[|Back to Top]]
----

===== Source code repository =====
[[https://gitlab.xfce.org/apps/xfce4-panel-profiles]]

----

===== Reporting Bugs =====
  * **[[:apps:xfce4-panel-profiles:bugs|Reporting Bugs]]** -- List of currently open bugs and instructions on how to submit new bug reports

[[|Back To Top]]
----
[[:4.18:start|Return to Xfce 4.18 Main Documentation Page]]