Xfce Wiki

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
~~NOTOC~~
{{ :xfce:thunar.png?nolink|}}
====== Thunar File Manager ======


  * **[[#Thunar Plugins|Thunar Plugins]]**
  * **[[#Other Thunar Related Packages|Other Thunar Related Packages]]**
  * **[[#Debugging Support|Debugging Support]]**
  * **[[#Standards compliance|Standards compliance]]**
  * **[[#Required Packages|Required Packages]]**
  * **[[#Latest Release|Latest Release]]**
  * **[[#Source Code Repository|Source Code Repository]]**
  * **[[https://developer.xfce.org/thunar/index.html|thunar API documentation (for developers)]]**
  * **[[#Reporting Bugs|Reporting Bugs]]**

----

===== Introduction =====
//Thunar// is a modern file manager for the Xfce Desktop Environment. //Thunar// has been designed from the ground up to be fast and easy to use. Its user interface is clean and intuitive and does not include any confusing or useless options by default. //Thunar// starts up quickly and navigating through files and folders is fast and responsive.


  * **[[the-file-manager-window|The File Manager Window]]** -- working with the Thunar window and modifying the layout
  * **[[working-with-files-and-folders|Working with Files and Folders]]** -- basic file handling
  * **[[using-removable-media|Using Removable Media]]** -- working with removable devices
  * **[[preferences|File Management Preferences]]** -- details of the different file manager preferences
  * **[[faq|Frequently Asked Questions]]** -- some random things you probably want to know
  * **[[hidden-settings|Advanced Settings]]** -- The xfce4-settings-editor, customize gtk3 css and more possible tweaks
  * **[[unix-filesystem| The UNIX filesystem]]** -- understanding the UNIX File System
  * **[[send-to|The "Send To" Menu]]** -- how to customize the send to menu

----

===== Thunar Plugins =====

Thunar plugins can be installed as separate, additional packages in order to extend the functionality of Thunar. Most Thunar plugins offer additional options on files in the context menu or via shortcut. The interface which is used by thunar plugins is the [[https://developer.xfce.org/thunarx/index.html|thunarx API]].

Since thunar version ''4.17.8'' it is possibly to define a list of plugin directories via the environment variable THUNARX_DIRS (separated by colon)

  * **[[:xfce:thunar:bulk-renamer:|Bulk Renamer]]** -- rename multiple files at once
  * **[[custom-actions|Custom Actions]]** -- custom commands associated with common mime-types or extensions
  * **[[archive|Archive Plugin (thunar-archive-plugin)]]** -- allows to create and extract archive files
  * **[[media-tags|Media Tags Plugin (thunar-media-tags-plugin)]]** -- improved support for ID3 tags
  * **[[thunar-shares-plugin|Shares Plugin (thunar-shares-plugin)]]** -- Quickly share folders using Samba without requiring root access
  * **[[thunar-volman|Volume Manager (thunar-volman)]]** -- Automatic management of removable devices in Thunar
  * **[[thunar-vcs-plugin|VCS Plugin (thunar-vcs-plugin)]]** -- adds Subversion and GIT actions to the context menu

Here as well some unofficial plugins, which are not maintained by Xfce:

  * **[[https://github.com/tristanheaven/gtkhash|thunar-gtkhash]]** -- desktop utility for computing message digests or checksums
  * **[[https://github.com/rabbitvcs/rabbitvcs|rabbitvcs-thunar]]** -- svn/git version control

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

===== Other Thunar Related Packages =====

  * **[[unix-filesystem#gnome_virtual_file_system|Gnome Virtual File System]]** --  required for trash support, mounting removable media, and [[unix-filesystem#remote_file_systems|remote filesystems]]
  * **[[:xfce:tumbler:start:|Tumbler]]** -- the remote thumbnail service for Thunar

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

===== Debugging Support =====
Thunar currently supports four different levels of debugging support, which can be setup using the configure flag ''--enable-debug'' (check the output of ''configure --help''):

^ Argument ^ Description ^ 
| full | Use this if you want to debug Thunar to locate a bug. The build will most probably be noticably slower. This is also recommended for people that want to develop Thunar stuff. |
| yes |Adds all kinds of checks to the code, and is therefore likely to run slower. Use this if you want to develop for Thunar (e.g. writing Thunar extensions and such). |
| minimum| This is the default for release builds, and presents the recommended behaviour. |
|no |Disables all sanity checks. Don't use this unless you know exactly what you do. |

For some additional build & debug hints, as well check the [[https://wiki.xfce.org/thunar/dev|Thunar Wiki pages]].

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

===== Standards compliance =====
Thunar supports the following standards/specifications:

  * [[https://freedesktop.org/wiki/Specifications/basedir-spec|XDG Base Directory Specification]]
  * [[https://freedesktop.org/wiki/Specifications/shared-mime-info-spec|Shared MIME Database Specification]]
  * [[https://freedesktop.org/wiki/Specifications/direct-save|X Direct Save (XDS) Protocol for the X Window System]]
  * [[https://freedesktop.org/wiki/Specifications/icon-theme-spec|Icon Theme Specification]]
  * [[https://freedesktop.org/wiki/Specifications/thumbnails|Thumbnail Managing Standard]]
  * [[https://freedesktop.org/wiki/Specifications/file-uri-spec|File URI Specification]]
  * [[https://freedesktop.org/wiki/Specifications/trash-spec|Desktop Trash Can Specification]]

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

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

Thunar depends on the following packages:

  * [[https://github.com/Perl/perl5|perl]]
  * [[https://www.gtk.org|GTK+]]
  * [[https://wiki.gnome.org/Projects/GLib|GLib]]
  * [[https://gitlab.xfce.org/xfce/exo|exo]]
  * [[https://gitlab.xfce.org/xfce/libxfce4util|libxfce4util]]
  * [[https://gitlab.xfce.org/xfce/libxfce4ui|libxfce4ui]]
  * [[https://gitlab.xfce.org/xfce/xfconf|xfconf]]
  * [[https://www.freedesktop.org/wiki/Software/intltool/|intltool]]

Thunar can optionally be build with the following packages:

  * [[https://www.freedesktop.org/wiki/Software/dbus|D-Bus]] (strongly suggested, required for inter process communication)
  * [[https://gitlab.xfce.org/xfce/xfce4-panel|xfce-panel]] (required to build the trash panel applet)
  * [[https://sourceforge.net/projects/gudev/|gudev]] (required for thunar-volman)
  * [[https://github.com/GNOME/libnotify|libnotify]] (required for mount notification support)

For concrete information on the minimum required versions, check [[https://gitlab.xfce.org/xfce/thunar/-/blob/master/configure.ac|configure.ac]]

----

===== Latest Release =====

{{rss>https://archive.xfce.org/feeds/project/thunar 1 date 2h}}

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

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


[[|Back to Top]]
----
===== Source Code Repository =====
[[https://gitlab.xfce.org/xfce/thunar|]]


For additional build, test and debugging tips, see [[https://wiki.xfce.org/thunar/dev/build_and_run|this page]] for more suggestions.

----

===== Reporting Bugs =====

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

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

Sub domains

Tools
