~~NOTOC~~
{{ :xfce:thunar.png?nolink|}}
====== Thunar - thunar-archive-plugin ======


  * **[[#Required packages|Required packages]]**
  * **[[#Supported archive managers|Supported archive managers]]**
  * **[[#Latest Release|Latest Release]]**
  * **[[#Source Code Repository|Source Code Repository]]**
  * **[[#Reporting Bugs|Reporting Bugs]]**

----

===== Introduction =====

The Thunar Archive Plugin allows you to create and extract archive files using the file context menus in the Thunar file manager. For example, to create a new archive, select the files and folders you want to add to the archive, right-click on one of the selected files and select {gui>Create Archive...} from the context menu. This will open the dialog shown below which allows you to specify the filename and type, target location and Other Options (if supported by the selected file type).

<figure "Create Archive Compress Dialog">
{{:xfce:thunar:4.18:archive-compress.png|Create Archive Compress Dialog Window}}
</figure>

Likewise you can easily extract archive files using the context menu. Just select the archive file you want to extract, right-click to open the context menu and select **Extract Here**.

<figure "Extract Archive">
{{:xfce:thunar:4.18:archive-extract.png?600|Extract Archive Window}}
</figure>

The files from the selected archive will be extracted to the current folder. If you select **Extract To...** instead, you will be prompted to specify the target location.

The Thunar Archive Plugin - since version 0.2.0 - provides a generic scripting interface for archive managers, so basically every archive manager that supports the required command-line switches (or an equivalent D-Bus interface) can be used with Thunar. See  [[:xfce:thunar:archive#supported_archive_managers|supported archive managers]] section, below, for further details about the process of adding a new archive manager.

The standard MIME association mechanism is used to determine the preferred archive manager for the **Create Archive...**, **Extract Here** and **Extract To...** actions. However the plugin may not always be able to detect the appropriate archive manager for a certain task. In this case, the user will need to manually select the preferred archive manager from a list of possible applications.

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

===== Required packages =====

thunar-archive-plugin depends on the following packages:

 * Thunar 1.2.0 or above

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

===== Supported archive managers =====

The Thunar Archive Plugin currently includes support for [[http://git.xfce.org/archive/xarchiver/|Xarchiver]], [[http://fileroller.sourceforge.net|File Roller]] (GNOME archive manager), [[http://userbase.kde.org/Ark|Ark]] (KDE archive manager) and [[https://github.com/mate-desktop/engrampa|Engrampa]] (Mate archive manager). Support for other archive managers can easily added by installing a .tap wrapper script in addition to the .desktop file for that application (see the README file in the source tarball).

To add support for a new archive manager, all you need to do is to install
the ''.desktop'' file - with the list of supported mime types - for the archive
manager to the ''$(datadir)/applications/'' folder (as usual), and in addition,
install a ''.tap'' file to ''$(libexecdir)/thunar-archive-plugin/'', which provides
a wrapper script that invokes the archive manager with the appropriate
parameters for the actions "Create Archive", "Extract Here" and "Extract To".

The ''.tap'' and ''.desktop'' files should have the same basename, otherwise the
thunar-archive-plugin is not able to find the appropriate ''.tap'' file for an
archive manager. For example, if the name of the ''.desktop'' file is ''ark.desktop'',
the ''.tap'' file must be named ''ark.tap''.

See the ''scripts/'' directory for examples of how to create said ''.tap'' files. The
''template.tap'' file should provide a good starting point.

Note that the thunar-archive-plugin takes the applications from the desktop
database, so after installing new archive managers in $prefix (i.e. /usr or
/usr/local), make sure to run:

 ''update-desktop-database $prefix/share/applications''

Most modern package management systems will do this for you automatically, but if you are installing archive managers manually, you may need to run the above
command first, otherwise you will get an error message telling you that no
support archive managers were found on your system.

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

===== Latest Release =====
{{rss>hhttps://archive.xfce.org/feeds/project/thunar-archive-plugin 1 date 2h}}

[[https://gitlab.xfce.org/thunar-plugins/thunar-archive-plugin/-/blob/master/NEWS|Read the CHANGELOG]]

  * **[[https://archive.xfce.org/src/thunar-plugins/thunar-archive-plugin/|Download current release]]** (older versions of this component are also available here)

----
===== Source Code Repository =====
[[https://gitlab.xfce.org/thunar-plugins/thunar-archive-plugin|]]

----
===== Reporting Bugs =====
  * **[[:xfce:thunar:thunar-archive-plugin:bugs|Reporting Bugs]]** -- List of currently open bugs and instructions on how to submit new bug reports

[[|Back To Top]]
----
[[:xfce:thunar:4.18:start:|Return to Thunar 4.18 Main Documentation Page]]