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

  * **[[#Usage|Usage]]**
  * **[[#Required Packages|Required Packages]]**
  * **[[#Latest Release|Latest Release]]**
  * **[[#Source Code Repository|Source Code Repository]]**
  * **[[#Reporting Bugs|Reporting Bugs]]**

----

===== Introduction =====
The Thunar Media Tags Plugin (thunar-media-tags-plugin) adds special features for media files to the Thunar File Manager.

Currently, these are:

    * A bulk renamer option, which allows users to rename multiple audio files at once, based on their tags (e.g. ID3 or OGG/Vorbis),
    * An audio tag editor which is reachable from the file properties page,
    * A special media file page for the file information dialog, which displays detailed information about quality, length, etc.


----
   
===== Usage =====

The renamer, which you can see in the screenshot below, is reachable through the {gui>Rename…} option of the context menu after selecting more than one file and right-clicking on the selection. By selecting **Audio Tags** from the picklist, you are offered several pre-defined **Format:** options for renaming, or you can select //Custom// from the picklist. If //Custom// is selected, clicking on the //Information// icon to the right of the **Custom format:** field will display a list valid parameters. The screenshot shows how a custom selection displays a preview of your proposed changes under the //New Name// column.

<figure "Rename Audio Files">
{{:xfce:thunar:thunar_media-tags-renamer.png?600|Rename Audio Files}}
</figure>

The tag editor can be found under the **Audio** tab of the file properties dialog.

<figure "File Properties Audio Tab">
{{:xfce:thunar:thunar_media-tags-file-properties.png|File Properties Audio Tab}}
</figure>

Clicking on the Information button in the dialog shown above will display additional audio properties of the selected file.

<figure "File Properties - Audio Tab -> Information">
{{:xfce:thunar:thunar_media-tags-audio-properties.png|File Properties - Audio Tab -> Properties}}
</figure>

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

==== Required packages =====

thunar-media-tags-plugin depends on the following packages:

  * exo >= 0.3.1.3
  * thunarx >= 0.2.3svn-r20526
  * thunar-vfs >= 0.2.3svn-r20526
  * taglib >= 1.4

----

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

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

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

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

----

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

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