1
<?xml version="1.0" encoding="utf-8"?>
2
<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd" [
3
<!ENTITY date "November 2007">
4
<!ENTITY version "@PACKAGE_VERSION@">
5
<!ENTITY application "@PACKAGE_NAME@">
7
<article id="index" lang="am">
11
<title>ቱናር የፋይል ማስተዳደሪያ</title>
13
<pubdate>&date;</pubdate>
20
<holder>Benedikt Meurer</holder>
23
<legalnotice id="legalnotice">
25
Permission is granted to copy, distribute and/or modify this document
26
under the terms of the GNU Free Documentation License, Version 1.1 or
27
any later version published by the Free Software Foundation; with no
28
Invariant Sections, with no Front-Cover Texts, and with no Back-Cover
29
Texts. The complete license text is available from the <ulink type="http" url="http://www.gnu.org/">Free Software Foundation</ulink>.
35
<firstname>Benedikt</firstname>
36
<surname>Meurer</surname>
38
<address><email>benny@xfce.org</email></address>
39
<orgname>os-cillation</orgname>
40
<orgdiv>System development</orgdiv>
41
<jobtitle>Software developer</jobtitle>
47
This manual describes version @PACKAGE_VERSION@ of @PACKAGE_NAME@.
52
<title>Introduction to @PACKAGE_NAME@</title>
55
Thunar is a new modern file manager for the Xfce Desktop Environment. Thunar has been designed from the ground up to
56
be fast and easy-to-use. Its user interface is clean and intuitive, and does not include any confusing or useless
57
options by default. Thunar is fast and responsive with a good start up time and folder load time.
61
The Thunar file manager thereby provides an integrated access point to your files and applications. You can use the
62
file manager to do the following:
66
<listitem>Create folders and documents.</listitem>
67
<listitem>Display your files and folders.</listitem>
68
<listitem>Manage your files and folders.</listitem>
69
<listitem>Run and manage custom actions.</listitem>
70
<listitem>Access Removable Media.</listitem>
75
<sect1 id="the-file-manager-window">
76
<title>The File Manager Window</title>
79
By default the file manager window consists of a shortcut pane on the left side, the main area on the right
80
and a pathbar above the main area.
86
<imagedata fileref="images/file-manager-window.png" format="PNG"/>
90
<phrase>File Manager Window</phrase>
96
The <guilabel>Shortcut Pane</guilabel> provides shortcuts to different folders on your system. The first
97
shortcut will lead to your <emphasis>Home Folder</emphasis>, the folder you store all your personal data,
98
and will therefore have the name of the current user. The second shortcut will take you to the trash bin,
99
which stores deleted files that can be recovered later. The third shortcut takes you to the <emphasis>Desktop
100
Folder</emphasis>, which contains the files and folders that are displayed on the desktop. The fourth
101
shortcut will take you to the root of your file system - you may want to explore it a bit, even though
102
it may be confusing to you if you are new to Linux/Unix. Just click on the different folders and see what is
107
Below the <emphasis>File System</emphasis> shortcut, the removable drives and media will be displayed. In
108
the screenshot above, you can see a <guilabel>Floppy Drive</guilabel> shortcut. Click on these shortcuts
109
to access the data stored on the removable drives and media. See <xref linkend="using-removable-media"/>
114
The remaining shortcuts are user defined. Add your own shortcuts by simply dragging folders to the
115
<guilabel>Shortcuts Pane</guilabel>. This will allow you to access important folders instantly. To
116
remove a previously added shortcut, right-click on the shortcut and choose <guimenuitem>Remove Shortcut</guimenuitem>.
117
To rename a previously added shortcut, right-click on the shortcut and choose <guimenuitem>Rename Shortcut</guimenuitem>.
118
Note that these actions affect only the shortcut, not the folder referenced by the shortcuts.
122
The <emphasis>main area</emphasis> will always display the contents of the current folder. Double click on
123
folders to enter them, and right-click on files or folders to get a context-menu offering some choices of
124
what to do with it. Select multiple files by dragging a rectangle over them with the mouse. Alternatively,
125
select one file, hold down the <keycap>Shift</keycap> key, and increase or decrease the selection using
130
The <emphasis>pathbar</emphasis> will always show the path you took to get to the folder you are currently
131
at. You can click on any pathbar button to change to the folder it represents. Right-click on a pathbar
132
button to bring up a context-menu with some options.
136
<sect2 id="customizing-the-appearance">
137
<title>Customizing the Appearance</title>
140
There are many ways to customize the appearance of the file manager windows. In case you do not like the
141
way the icons are displayed, choose <menuchoice><guimenu>View</guimenu><guimenuitem>View as Detailed List</guimenuitem></menuchoice>
142
from the main menu to have the contents of the current folder displayed as a list.
146
You can have the file manager windows display a location bar instead of the pathbar by choosing
147
<menuchoice><guimenu>View</guimenu><guimenuitem>Location Selector</guimenuitem><guimenuitem>Toolbar Style</guimenuitem></menuchoice>
152
In case you prefer a treeview in the left pane, choose
153
<menuchoice><guimenu>View</guimenu><guimenuitem>Side Pane</guimenuitem><guimenuitem>Tree</guimenuitem></menuchoice>
157
<sect3 id="visible-columns-in-the-detailed-list-view">
158
<title>Visible Columns in the Detailed List View</title>
161
If you prefer to display the contents of the folder as a list, using the <guilabel>Detailed List View</guilabel>, you can
162
customize the columns displayed in the list view. To customize the visible columns, choose
163
<menuchoice><guimenu>View</guimenu><guimenuitem>Configure Columns...</guimenuitem></menuchoice> from the main menu.
169
<imagedata fileref="images/visible-columns.png" format="PNG"/>
173
<phrase>Visible Columns</phrase>
180
<term><guilabel>Visible Columns</guilabel></term>
183
Select the columns you want to be displayed from the list of available columns. Click <guibutton>Move Up</guibutton>
184
or <guibutton>Move Down</guibutton> to change the order of the columns. Click <guibutton>Use Default</guibutton> to
191
<term><guilabel>Column Sizing</guilabel></term>
194
Select the option <guibutton>Automatically expand columns as needed</guibutton> if you want the list view columns
195
to expand automatically if the needed to ensure the text is fully visible.
205
<sect1 id="working-with-files-and-folders">
206
<title>Working with Files and Folders</title>
209
<sect2 id="opening-files">
210
<title>Opening Files</title>
213
When you open a file, the file manager performs the default action for that file type. For example, opening a text file
214
will display it in the default text editor, while opening an image file will display the image in the default image
219
The file manager checks the extension of a file to determine the type of a file. If the file has no known extension, the
220
file manager examines the contents of the file.
223
<sect3 id="executing-the-default-action">
224
<title>Executing the Default Action</title>
227
To execute the default for a file, double-click on the file. For example, the default action for audio files is to
228
play the it with the default music playing application. In this case, you can double-click on the file to open the
229
file in the music player.
233
You can set <application>Thunar</application> preferences so that you click once on a file to execute the default
234
action. For information, see <xref linkend="preferences-behavior"/>.
238
<sect3 id="executing-non-default-actions">
239
<title>Executing Non-Default Actions</title>
242
To execute actions other than the default action for a file, select the file that you want to perform an action on.
243
Choose the desired action from the <emphasis>Open With</emphasis> choices available in <guimenu>File</guimenu> menu
244
or an <guimenu>Open With</guimenu> submenu.
248
<sect3 id="adding-actions">
249
<title>Adding Actions</title>
252
To add actions associated with a file type, perform the following steps:
258
In the main area, select a file of the type to which you want to add an action.
263
Choose <menuchoice><guimenu>File</guimenu><guimenuitem>Open With Other Application...</guimenuitem></menuchoice>
269
Either choose an application in the <guilabel>Open With</guilabel> dialog or select <guibutton>Use a custom command</guibutton>
270
and browse to the program with which you wish to open this type.
276
The action you have chosen is now added to the list of actions for that particular file type. If you enabled the
277
<guibutton>Use as default for this kind of file</guibutton> option or there was no prior action associated with the
278
type, the newly added action is the default.
282
You may also add actions using the <guibutton>Open With</guibutton> button under
283
<menuchoice><guimenu>File</guimenu><guimenuitem>Properties...</guimenuitem></menuchoice>.
287
<sect3 id="modifiying-actions">
288
<title>Modifying Actions</title>
291
To modify the actions associated with a file or file type, perform the following steps:
297
In the main area, select a file of the type for which you want to modify the action.
302
Choose <menuchoice><guimenu>File</guimenu><guimenuitem>Properties...</guimenuitem></menuchoice> from the main menu.
307
Select the new default action using the <guilabel>Open With</guilabel> button or add a new action by choosing
308
<guimenuitem>Open With Other Application...</guimenuitem> from the drop down menu.
314
To remove a previously added action for a file type, bring up the <guilabel>Open With</guilabel> dialog as described
315
above, right-click the action you want to remove and choose <guimenuitem>Remove Launcher</guimenuitem>.
321
<sect2 id="file-properties">
322
<title>File Properties</title>
325
The file properties window shows more information about any file or folder in the file manager. With this window, you can also
332
Change the icon for special files, such as application launchers and URL links.
337
Add or remove emblems for a file or folder.
342
Change the UNIX file permissions for a file or folder.
347
Choose which application is used to open a file and other files of the same type.
355
<imagedata fileref="images/file-properties.png" format="PNG"/>
359
<phrase>File Properties</phrase>
365
To open the file properties window, perform the following steps:
371
Select the file or folder whose properties you want to examine or change. You cannot
372
select multiple items at once and display the properties that are in common to all
378
Do one of the following:
381
<para>Choose <menuchoice><guimenu>File</guimenu><guimenuitem>Properties...</guimenuitem></menuchoice> from the main menu.</para>
384
<para>Right-click the selected item and choose <guimenuitem>Properties...</guimenuitem> from the context menu.</para>
387
<para>Press <keycombo><keycap>Alt</keycap><keycap>Return</keycap></keycombo>.</para>
397
<sect1 id="using-removable-media">
398
<title>Using Removable Media</title>
400
<sect2 id="accessing-removable-media">
401
<title>Accessing Removable Media</title>
404
Thunar supports removable media if it was built with support for <ulink type="http" url="http://freedesktop.org/wiki/Software_2fhal">HAL</ulink>,
405
or if you are using <ulink type="http" url="http://www.freebsd.org/">FreeBSD</ulink>. Note however that on FreeBSD 6.0 or newer, it is
406
suggested to use HAL rather than the native support provided by Thunar.
409
<sect3 id="to-mount-media">
410
<title>To Mount Media</title>
413
To <emphasis>mount</emphasis> media is to make the file system of the media available for access. When you mount media, the
414
file system of the media is attached as a subdirectory to your file system.
418
To access media, insert the media in the appropriate device, or connect the new device to your computer (i.e. connect an USB
419
stick to one of your USB ports). An object that represents the media is added to the side pane of the file manager. If
420
<application>xfdesktop</application> is running and configured to display <guilabel>File/launcher icons</guilabel> this
421
object will also be added to your desktop.
425
To actually mount the media, click on the object that represents the media. For example, to mount a floppy diskette,
426
click on the <guilabel>Floppy Drive</guilabel> object in the side pane. The file manager will now add the file system
427
of the media to your file system hierarchy and display the contents of the floppy diskette in the main area.
431
<sect3 id="to-eject-media">
432
<title>To Eject Media</title>
435
If the drive for the media is a motorized drive (i.e. a CD-ROM drive), right-click on the media object in the side pane
436
or on the desktop and choose <guilabel>Eject Volume</guilabel>. The media is ejected from the drive after a few seconds.
437
If the drive for the media is not motorized (i.e. a floppy drive or an USB stick), right-click on the media object and
438
choose <guilabel>Unmount Volume</guilabel>. After a short period of time, a notification will appear to inform you
439
that it is now safe to remove the media or disconnect the drive from the computer.
445
<imagedata fileref="images/removable-media-unmount.png" format="PNG"/>
449
<phrase>Unmount notification</phrase>
455
However this notification will only be displayed if support for <application>libnotify</application> is enabled,
456
and you have installed a notification daemon. A notification daemon for Xfce is available from the <ulink type="http" url="http://goodies.xfce.org/projects/applications/notification-daemon-xfce">Xfce Goodies Project</ulink>.
457
If notification support is not available, wait until the context menu disappears before you remove the media or disconnect
462
Be aware that you cannot eject or unmount media that is still in use by one or more applications. Therefore if the file
463
manager refuses to eject media, make sure you close all applications that were accessing the media, and be sure to also
464
check command line applications running in <application>Terminal</application> windows.
468
Make sure to unmount removable media before ejecting. Do not eject a diskette from the floppy drive before your unmount
469
the diskette. Do not remove an USB stick before you unmount the flash drive. If you do not unmount the media first you
470
might lose data or cause your system to crash.
475
<sect2 id="management-of-removable-drives-and-media">
476
<title>Management of Removable Drives and Media</title>
479
Thunar is also able to automatically manage removable drives and media if the <ulink type="http" url="http://www.foo-projects.org/~benny/projects/thunar-volman/index.html">thunar-volman</ulink> package is installed on
480
your system. Note however that this feature requires HAL support.
484
Now, if HAL support is available and <application>thunar-volman</application> is installed on your system, you
485
can choose to enable the <guilabel>Volume Management</guilabel> feature of Thunar. Therefore, open the file
486
manager preferences, go to the <guilabel>Advanced</guilabel> page and check the <guilabel>Enable Volume
487
Management</guilabel> button.
491
The next step is to customize the management of removable drives and media to your needs. Click on the
492
<guilabel>Configure</guilabel> link in the <guilabel>Volume Management</guilabel> section, right below
493
the button. The <guilabel>Removable Drives and Media</guilabel> configuration dialog will be displayed.
499
<imagedata fileref="images/removable-drives-and-media.png" format="PNG"/>
503
<phrase>Removable Drives and Media</phrase>
509
If you have used the <application>gnome-volume-manager</application> previously, you should feel right at
510
home, because it was designed to look and behave similar to <application>gnome-volume-manager</application>.
511
The preferences are divided by device categories to make it easy to locate the option for you specific
516
The <guilabel>Storage</guilabel> page contains the most important options. As the name suggests these
517
options apply only to storage devices like external harddisk drives, USB sticks and CD-ROMs. The
518
<guilabel>Removable Storage</guilabel> options are described in detail below.
523
<term><guilabel>Mount removable drives when hot-plugged</guilabel></term>
526
Enable this option to automatically mount file systems on removable drives (i.e. external harddisk drives
527
or USB sticks) when such drives are plugged into the computer.
530
This option must be enabled for certain other features to work with removable drives. For example,
531
if you disable this option, certain kinds of portable music players cannot be detected any more and
532
so, even if you enabled the <guilabel>Play music files when connected</guilabel> option on the
533
<guilabel>Multimedia</guilabel> page, the specified command will not be run when you hot-plug your
534
portable music player.
540
<term><guilabel>Mount removable media when inserted</guilabel></term>
543
Enable this option to automatically mount file systems on removable media (i.e. CD-ROMs or DVDs)
544
when you insert the media into the drive.
547
This option must be enabled for certain other features to work with removable media. For example,
548
if you disable this option, it is impossible to detect whether the removable media has auto-run
549
capabilities, and so the <guilabel>Auto-run programs on new drives and media</guilabel> option
550
has no effect for removable media.
556
<term><guilabel>Browse removable media when inserted</guilabel></term>
559
Enable this option to automatically display the content of newly inserted media in the file manager.
560
Note however, that the contents will only be displayed if no other action was possible or you
561
choose to ignore the other possible actions. For example, if you insert a CD-ROM with auto-run
562
capabilities and the <guilabel>Auto-run programs on new drives and media</guilabel> option is
563
enabled, you will be prompted whether you want to allow or ignore the auto-run. If you choose
564
to ignore the auto-run the contents will be displayed in the file manager.
570
<term><guilabel>Auto-run programs on new drives and media</guilabel></term>
573
Enable this option to make use of auto-run capabilities of certain removable drives and media. See
574
the <ulink type="http" url="http://standards.freedesktop.org/autostart-spec/autostart-spec-0.5.html">Desktop
575
Application Autostart Specification</ulink> for details about the auto-run mechanism. To enhance security,
576
you will always be prompted to confirm the auto-run.
579
If the Windows emulator <ulink type="http" url="http://www.winehq.org/">WINE</ulink> is installed on your
580
system, the auto-run mechanism will also try to run <filename>autorun.exe</filename> files using WINE.
586
<term><guilabel>Auto-open files on new drives and media</guilabel></term>
589
Enable this option to make of auto-open capabilities of certain removable drives and media. See
590
the <ulink type="http" url="http://standards.freedesktop.org/autostart-spec/autostart-spec-0.5.html">Desktop
591
Application Autostart Specification</ulink> for details about the auto-open mechanism. To enhance security,
592
you will always be prompted to confirm the auto-open.
599
The remaining options allow you to specify a command to run when a certain kind of media is inserted into a drive
600
or a certain kind of external device is connected. The command can use three special variables, that will be
601
substituted when the command is run:
606
<term><literal>%d</literal></term>
609
Each appearance of <literal>%d</literal> in the command will be substituted with the device file path of
610
the newly added device. For example, if you have plugged in an USB stick, the device file path will be
611
<filename>/dev/da0s1</filename> or <filename>/dev/sda1</filename>.
614
If no device file is associated with the device or the device file could not be found for some reason,
615
the variable <literal>%d</literal> will be substituted with the empty string.
621
<term><literal>%h</literal></term>
624
Each appearance of <literal>%h</literal> in the command will be substituted with the HAL UDI of the newly
631
<term><literal>%m</literal></term>
634
Each appearance of <literal>%m</literal> in the command will be substituted with the mount point where
635
the newly added device was mounted. If the device cannot be mounted (for example printers or keyboards)
636
or if the automatic mounting was disabled, <literal>%m</literal> will be substituted with the empty
643
<sect3 id="troubleshooting-the-volume-manager">
644
<title>Troubleshooting the Volume Manager</title>
647
Useful tips to trouble shoot the volume manager in case it does not work as expected.
653
Make sure <application>Thunar</application> is running as daemon. The volume manager depends
654
on this, as it is not a daemon by itself. By default, Xfce
655
automatically spawns <application>Thunar</application> as daemon on startup. If it got killed
656
for some reason, open the <guilabel>Run program</guilabel> (using the keyboard shortcut
657
<keycombo><keycap>Alt</keycap><keycap>F2</keycap></keycombo> or right-click on the desktop
658
and choose <guilabel>Run Program...</guilabel> from the desktop menu), enter <literal>Thunar
659
--daemon</literal> and click <guibutton>Run</guibutton>.
665
Try running <application>thunar-volman</application> from a <application>Terminal</application>
666
window after hot-plugging the drive or inserting the media. First, you need to figure out the
667
HAL UDI of the new device using <application>lshal</application> or <application>hal-device</application>.
668
Once you know the UDI, run <literal>thunar-volman --device-added <udi-of-your-device></literal> in
669
a <application>Terminal</application> window and watch the output for errors or warnings.
675
If it still refuses to work, ask on the <ulink type="http" url="http://forum.xfce.org/">Xfce Forum</ulink> or
676
the <ulink type="http" url="http://foo-projects.org/mailman/listinfo/thunar-dev">thunar-dev mailing list</ulink>
684
<sect1 id="preferences">
685
<title>File Management Preferences</title>
688
Use the <guilabel>File Manager Preferences</guilabel> dialog to set your <application>Thunar</application> file manager
689
preferences. To open the preferences dialog, choose <menuchoice><guimenu>Edit</guimenu><guimenuitem>Preferences...</guimenuitem></menuchoice>
690
from the menu bar, or click on the <guibutton>File Manager</guibutton> button in the Xfce Settings Manager.
694
The <guilabel>File Manager Preferences</guilabel> dialog is divided into four pages with different options, each described in
695
a separate section below. Basically you can set preferences in the following categories:
699
<listitem><para>The default settings for the views.</para></listitem>
700
<listitem><para>The default settings for the side pane.</para></listitem>
701
<listitem><para>The behavior of the file manager windows.</para></listitem>
702
<listitem><para>Advanced features of the file manager.</para></listitem>
706
Thunar also supports a bunch of so-called <emphasis>Hidden Options</emphasis>, which control several advanced features of the
707
file manager, but are not included in the preferences in order to keep the preferences dialog simple. The <ulink type="http" url="http://svn.xfce.org/svn/xfce/thunar/trunk/docs/README.thunarrc"><filename>README.thunarrc</filename></ulink> file that
708
is included with the Thunar distribution describes all available options in detail.
712
<sect2 id="preferences-views">
713
<title>Views Preferences</title>
716
You can specify a default view, select sort options and display options. You can
717
also specify whether thumbnails should be displayed for file types that support
724
<imagedata fileref="images/preferences-views.png" format="PNG"/>
728
<phrase>Views Preferences</phrase>
735
<term><guilabel>View new folder using</guilabel></term>
738
Select the default view for folders. When you open a new window, the is displayed
739
in the view that you select. This can be either the icon view, the compact list view
740
or the detailed list view. You can also select <guilabel>Last Active View</guilabel>
741
here to use the view you used for the last active window.
747
<term><guilabel>Sort folders before files</guilabel></term>
750
Select this option to list folders before files when you sort a folder.
756
<term><guilabel>Show thumbnails</guilabel></term>
759
Select this option to show thumbnails of image files and other supported files. The
760
file manager stores the thumbnail files for each folder in the hidden <filename role="directory">.thumbnails</filename> directory in the user's Home Folder.
763
See <xref linkend="thumbnailers"/> if you want to extend the basic
764
thumbnail functionality provided by <application>Thunar</application> with support
765
for additional file types.
771
<term><guilabel>Text beside icons</guilabel></term>
774
Select this options to place the icon captions for items in the icon view beside the
775
icon rather than under the icon.
783
<sect2 id="preferences-side-pane">
784
<title>Side Pane Preferences</title>
787
You can select display options for the shortcuts pane and the tree pane.
793
<imagedata fileref="images/preferences-side-pane.png" format="PNG"/>
797
<phrase>Side Pane Preferences</phrase>
803
The side pane can either display a list of shortcuts for folders in your file system, which
804
is the default, or a tree view of your file system. This page allows you to select the size
805
of the icons for the shortcuts and the tree pane. You can also specify whether emblems should
811
<term><guilabel>Icon Size</guilabel></term>
814
The size of the icons displayed in the side, ranging from <guilabel>Very Small</guilabel> (around
815
16x16 pixels) to <guilabel>Very Large</guilabel> (around 128x128 pixels).
821
<term><guilabel>Show Icon Emblems</guilabel></term>
824
Select this option to display emblems for folders in the side pane. You can assign emblems to
825
folders in the <guilabel>Properties</guilabel> dialog. Select a folder in the main area and
826
choose <menuchoice><guimenu>File</guimenu><guimenuitem>Properties...</guimenuitem></menuchoice>
827
from the main menu, or right-click the folder and select <menuchoice><guimenuitem>Properties...</guimenuitem></menuchoice>
828
from the context menu.
836
<sect2 id="preferences-behavior">
837
<title>Behavior Preferences</title>
840
You can select the preferred behavior to interact with the file manager.
846
<imagedata fileref="images/preferences-behavior.png" format="PNG"/>
850
<phrase>Behavior Preferences</phrase>
857
<term><guilabel>Single click to active items</guilabel></term>
860
Select this option to perform the default action for an item when you
861
click on the item. When this option is selected, and you point to an
862
item, the title of the item is underlined and the item will be
863
selected automatically after a short delay.
866
This delay can be configured below the option. You can also disable the
867
automatic selection of items by moving the selector to the left-most
874
<term><guilabel>Double click to activate items</guilabel></term>
877
Select this option to perform the default action for an item when you
878
double click on the item, and select the item with a single click.
886
<sect2 id="preferences-advanced">
887
<title>Advanced Preferences</title>
890
You can control advanced features of the file manager.
896
<imagedata fileref="images/preferences-advanced.png" format="PNG"/>
900
<phrase>Advanced Preferences</phrase>
907
<term><guilabel>Folder Permissions</guilabel></term>
910
Choose the action that should be performed when you change the permissions of a folder in
911
the <guilabel>Properties</guilabel> dialog. You can choose to let <application>Thunar</application>
912
ask everytime when you change folder permissions, tell it to default to applying the new permissions
913
to the folder only or to apply them recursively to the folder contents as well.
919
<term><guilabel>Volume Management</guilabel></term>
922
If <application>Thunar</application> was installed with support for HAL and the <application>thunar-volman</application>
923
package is also installed, you can enable the integrated volume manager. See <xref linkend="management-of-removable-drives-and-media"/>
924
for details about this feature.
933
<sect1 id="customizing-thunar">
934
<title>Customizing Thunar</title>
937
This chapter describes how to customize certain parts of the file manager to your own needs.
942
<title>The "Send To" Menu</title>
945
Thunar includes a <guilabel>Send To</guilabel> menu, which provides possible targets where files and folders can
946
be sent to. To access the <guilabel>Send To</guilabel> menu, choose
947
<menuchoice><guimenu>File</guimenu><guimenuitem>Send To</guimenuitem></menuchoice> from the main menu, or right-click
948
on a file or folder and choose <menuchoice><guimenuitem>Send To</guimenuitem></menuchoice>.
954
<imagedata fileref="images/sendto-menu.png" format="PNG"/>
958
<phrase>"Send To" Menu</phrase>
964
By default, the <guilabel>Send To</guilabel> menu includes an entry named <guilabel>Desktop (Create Link)</guilabel> for all
965
files and folders, which simply creates a link on the desktop for each selected file. In addition, if the <guilabel>Shortcuts
966
Pane</guilabel> is active, the menu also includes an entry called <guilabel>Side Pane (Create Shortcut)</guilabel> for folders,
967
which allows users to add new shortcuts to the side pane. Following these entries, <application>Thunar</application> lists
968
the removable drives currently plugged into the computer. In the screenshot above, the <guilabel>Floppy Drive</guilabel>
969
represents a possible target where files can be sent to. Note that the device is mounted automatically once selected from
970
the <guilabel>Send To</guilabel> menu, so you do not need to manually mount it.
974
In addition <application>Thunar</application> also ships the <application>thunar-sendto-email</application> plugin, which adds
975
the entry <guilabel>Mail Recipient</guilabel> to the menu, that opens the mail composer with the selected files attach to the
976
new email. If the selection contains atleast one folder, the selected items are added to a ZIP archive before attaching them
977
to the email. Otherwise, if the selection contains multiple files, or a single file, which is larger than 200Kib, the user will
978
be prompted whether to pack the files into a ZIP archive, and send the ZIP archive.
982
Like most other features of <application>Thunar</application>, the <guilabel>Send to</guilabel> menu can be easily extended
983
by users and application developers with new targets, using standard <ulink type="http" url="http://freedesktop.org/wiki/Standards_2fdesktop_2dentry_2dspec">desktop entry files</ulink>. These files must be
984
installed into one of the <filename role="directory">$XDG_DATA_DIRS/Thunar/sendto/</filename> folders (see the <ulink type="http" url="http://freedesktop.org/wiki/Standards_2fbasedir_2dspec">XDG Base Directory Specification</ulink> for details about the
985
<literal>$XDG_DATA_DIRS</literal> variable).
989
The <literal>MimeType</literal> of the target <filename>.desktop</filename> specifies the types of files for which this action
990
should be available in the <guilabel>Send To</guilabel> menu. For example, say you want to add entry for a <ulink type="http" url="http://flickr.com/">Flickr</ulink> uploader tool, then this entry should only show up if the selection contains JPEG
991
files (other file formats are not supported by Flickr) and so you should add a line <literal>MimeType=image/jpeg;</literal>.
992
If you do not specify any <literal>MimeType</literal> your entry will show up for all file types.
996
A complete example using the <application>postr</application> application is shown below:
1000
# postr.desktop - Integrate postr into
1001
# the "Send To" menu.
1010
MimeType=image/jpeg;</programlisting>
1013
If you install this file to <filename role="directory">~/.local/share/Thunar/sendto/</filename> (create the folder if
1014
it does not exist yet), the <guilabel>Send To</guilabel> menu for JPEG files will show the new entry <guilabel>Flickr</guilabel>,
1015
which can be used to upload JPEG images to Flickr.
1019
The <ulink type="http" url="http://thunar.xfce.org/pwiki/documentation/sendto_menu">Thunar Project Wiki</ulink> contains
1020
additional examples of useful targets for the <guilabel>Send To</guilabel> menu. Feel free to extend the Wiki page with
1026
<sect2 id="thumbnailers">
1027
<title>Thumbnailers</title>
1030
Thunar uses small utilities to create thumbnails of certain file types and displays the thumbnails as preview of the
1031
file content. These small tools are called thumbnailers. Thunar ships with thumbnailers for image and font files, and
1032
makes use of the installed thumbnailers from GNOME automatically if it was installed with support for <literal>gconf</literal>.
1033
Users may however dynamically extend this basic functionality with thumbnailers for additional file types.
1037
If you plan to write a custom thumbnailers, you need to start with a program that accepts atleast two command line parameters,
1038
the input file, which is of the file type you plan to support and the output file, which is a PNG file that complies with the
1039
format specified by the <ulink type="http" url="http://jens.triq.net/thumbnail-spec/creation.html#AEN139">Thumbnail Management
1040
Standard</ulink>. Additionally your program may also accept the desired size of the thumbnail, which is optional but highly
1041
recommended. If you write the output file at an arbitrary image size, Thunar will afterwards scale it to the desired size,
1042
which might produce a less optimal result than generating the thumbnail with the requested dimensions.
1046
Once your utility to generate the thumbnails is done, you will need to register your thumbnailer, so Thunar is able to locate
1047
and use it. Therefore all you need to do is to install a description file for the thumbnailer (a <filename>.desktop</filename> file)
1048
in one of the <filename role="directory">$XDG_DATA_DIRS/thumbnailers/</filename> paths. For example, if you want to register the
1049
thumbnailer for your user account only, you can install the file into the folder <filename role="directory">~/.local/share/thumbnailers/</filename>. The <filename>.desktop</filename> for thumbnailers has the following format.
1052
<sect3 id="thumbnailer-desktop-file-format">
1053
<title>Thumbnailer Description File Format</title>
1056
Thumbnailer description files utilize the <ulink type="http" url="http://standards.freedesktop.org/desktop-entry-spec/latest/">Desktop
1057
Entry Format</ulink> with a special <literal>Type</literal> of <literal>X-Thumbnailer</literal> and special field
1058
<literal>X-Thumbnailer-Exec</literal> with new field codes. Basically, a thumbnailer description file has the following format.
1066
Name=Your Thumbnailer
1067
MimeType=your-supported/mime-type;
1068
X-Thumbnailer-Exec=your-thumbnailer %i %o %s</programlisting>
1071
The <literal>Version</literal> and <literal>Encoding</literal> are mandated by the Desktop Entry Specification, just use the values shown
1072
in the example above. The <literal>Type</literal> field must have the special value <literal>X-Thumbnailer</literal>, otherwise your
1073
thumbnailer will not be recognized. The <literal>Name</literal> value describes your thumbnailer.
1077
The <literal>X-Thumbnailer-Exec</literal> field contains the command to run your thumbnailer, and supports certain field codes that will
1078
be substituted when the thumbnailer is run. Recognized field codes are as follows:
1083
<term><varname>%i</varname></term>
1085
The local path to the input file for which to create a thumbnail. May be either a path relative to the directory from which the
1086
thumbnailer was invoked or an absolute path.
1091
<term><varname>%o</varname></term>
1093
The local path to the output file where to store the generated thumbnail. The output file must be written as valid PNG file according
1094
to the thumbnail standard (see above). Note that the path may not end with <literal>.png</literal>, which matters if you invoke certain
1100
<term><varname>%s</varname></term>
1102
The desired size of the generated thumbnail in pixels. This parameter is optional.
1107
<term><varname>%u</varname></term>
1109
Similar to <literal>%i</literal>, but substituted with the URI of the file, rather than the path. This was added for compatibility with
1115
<term><varname>%%</varname></term>
1117
Will be substituted with a single <literal>%</literal>.
1123
You need to include atleast <literal>%o</literal> and <literal>%i</literal> or <literal>%u</literal>, otherwise your thumbnailer will
1128
The <literal>MimeType</literal> lists the MIME types - separated by semicolon - for which your thumbnailer is able to create previews.
1132
<sect3 id="eps-thumbnailer-example">
1133
<title>Example EPS Thumbnailer</title>
1136
This example demonstrates how to write and install a new thumbnailer for <filename>.eps</filename> files, which uses the
1137
<command>convert</command> utility that ships as part of ImageMagick. First, we start with a simple script that invokes
1138
<command>convert</command> to generate a thumbnail at the requested size.
1144
# eps-thumbnailer - Example thumbnailer script for EPS files.
1146
# Usage: esp-thumbnailer eps-file png-file size
1149
# command line parameters
1154
# invoke convert (ImageMagick)
1155
exec convert "eps:$ifile" -scale "$sizex$size" "png:$ofile"</programlisting>
1158
Save this script above to a file <filename>eps-thumbnailer</filename>, make sure the file is executable and install it
1159
to <filename role="directory">/usr/local/bin</filename>.
1163
$ chmod +x eps-thumbnailer
1164
$ sudo install eps-thumbnailer /usr/local/bin/eps-thumbnailer</screen>
1167
Next we need to create the thumbnail description file <filename>eps-thumbnailer.desktop</filename>, which looks like this:
1175
Name=EPS Thumbnailer
1177
MimeType=image/x-eps;
1178
X-Thumbnailer-Exec=/usr/local/bin/eps-thumbnailer %i %o %s</programlisting>
1181
This file must be installed to <filename role="directory">/usr/local/share/thumbnailers</filename> (create the folder if
1182
it does not exists).
1186
$ sudo install -d /usr/local/share/thumbnailers
1187
$ sudo install eps-thumbnailer.desktop /usr/local/share/thumbnailers/eps-thumbnailer.desktop</screen>
1190
The <filename>eps-thumbnailer.desktop</filename> file uses the special key <literal>TryExec</literal>, which, if specified,
1191
names a command that must be present on the system for the thumbnailer to be useful. In this case, our script is useless if
1192
the <command>convert</command> utility is not present.
1196
The last step is to regenerate the thumbnailer cache, so Thunar will pick up our thumbnailer. The thumbnailer cache is located
1197
at <filename>$XDG_CACHE_HOME/Thunar/thumbnailers.cache</filename> (unless overridden by your or your system administrator, the
1198
<varname>$XDG_CACHE_HOME</varname> points to the folder <filename role="directory">~/.cache/</filename>). The thumbnailers
1199
cache is regenerated periodically by Thunar, but you can force to regenerate it by invoking the
1200
<filename>thunar-vfs-update-thumbnailers-cache-1</filename> utility, that ships as part of Thunar. This utility is usually installed
1201
in the <filename role="directory">libexec</filename> subfolder of your installation prefix (<filename role="directory">sbin</filename>
1202
on Debian/Ubuntu). So for example, if Thunar is installed in <filename role="directory">/usr</filename>, invoke the utility as
1206
<screen>$ /usr/libexec/thunar-vfs-update-thumbnailers-cache-1</screen>
1209
But make sure you run the program from your user account, not the superuser account, since the thumbnailers cache is stored in
1210
your home folder, rather than a system wide location.
1214
Now, if Thunar is compiled with support for file alteration monitoring (using the FAM or Gamin services), it will automatically
1215
pick up the new thumbnailers cache within a few seconds and afterwards be able to generate thumbnails using your custom
1216
thumbnailers. Otherwise you might need to completely restart Thunar to apply the changes, using
1219
<screen>$ Thunar -q</screen>
1222
to terminate any running instance, and afterwards restart it from your launcher.
1226
<sect3 id="cleaning-up-thumbnails">
1227
<title>Cleaning up Thumbnails</title>
1230
The generated thumbnails are stored in the folder <filename role="directory">~/.thumbnails/</filename> complying with the <ulink type="http" url="http://jens.triq.net/thumbnail-spec/index.html">Thumbnail Management Standard</ulink>. While testing a new
1231
thumbnailer, it might help to clean up the thumbnail cache using
1234
<screen>$ rm -rf ~/.thumbnails/</screen>
1237
which will also give you some free space in your home folder. Since all the information stored within this folder was automatically
1238
generated from files in your file system, you will not loose any sensitive data.
1245
<sect1 id="advanced-topics">
1246
<title>Advanced Topics</title>
1249
<sect2 id="to-bulk-rename-files">
1250
<title>To Bulk Rename Files</title>
1253
To <emphasis>bulk rename</emphasis> files means to rename multiple files at once using some criterion, that applies to atleast
1254
one of the files. <application>Thunar</application> includes a bulk renamer, which can be run separately using the command
1255
<command>Thunar -B</command> or from within <application>Thunar</application> by selecting two or more files in the main area
1256
and pressing <keycombo><keycap>F2</keycap></keycombo> or choosing
1257
<menuchoice><guimenu>Edit</guimenu><guimenuitem>Rename...</guimenuitem></menuchoice> from the main menu.
1263
<imagedata fileref="images/bulk-rename.png" format="PNG"/>
1267
<phrase>Bulk Rename Files</phrase>
1273
The <emphasis>Bulk Renamers</emphasis> can be applied to the name of the files, the suffix of the files or both to the
1274
name and the suffix of the files. <application>Thunar</application> currently supports the following <emphasis>Bulk
1275
Renamers</emphasis>:
1279
<listitem><para>Remove characters.</para></listitem>
1280
<listitem><para>Numbering files.</para></listitem>
1281
<listitem><para>Insert Date or Time.</para></listitem>
1282
<listitem><para>Insert or overwrite characters.</para></listitem>
1283
<listitem><para>Search and replace characters.</para></listitem>
1284
<listitem><para>Convert to uppercase, lowercase or camlcase.</para></listitem>
1288
Additional <emphasis>Bulk Renamers</emphasis> may be installed as plugins for <application>Thunar</application>. Check
1289
the <ulink type="http" url="http://thunar.xfce.org/plugins.html">Thunar Plugins</ulink> website for currently available
1290
extensions. The <ulink type="http" url="http://thunar.xfce.org/pwiki/documentation/bulk_renamer">Thunar Project Wiki</ulink>
1291
contains further details about this feature. Feel free to add more information to the Wiki.
1296
<sect2 id="the-unix-file-system">
1297
<title>The UNIX File System</title>
1300
While the Thunar file manager does a good job at abstracting the details of the underlying file system, so the user
1301
does not need to care about them, it is sometimes useful to understand the basic concepts to get the whole picture.
1302
This section tries to give a brief introduction to the concepts of the UNIX file system, which is used today by all
1303
incarnations of UNIX, including Linux.
1306
<sect3 id="folders-and-paths">
1307
<title>Folders and Paths</title>
1310
In a UNIX file system all folders are arranged in a simple inverted tree structure descending and branching down
1311
from a single top level folder, which is called the <emphasis>root directory</emphasis> (the term
1312
<emphasis>directory</emphasis> is often used instead of <emphasis>folder</emphasis>) and displayed as
1313
<guilabel>File System</guilabel> in Thunar. This means that you can get from any folder to any other by going
1314
up the tree until you reach a common point, then down the tree through the appropriate subfolders until you reach
1319
The position of any file or folder in the tree can be described by its <emphasis>path</emphasis>. The path is the
1320
list of folders you would have to descend through to get to the target folder or file, starting from the top level
1321
folder. For example <filename role="directory">/home/luke</filename> is the subfolder <filename role="directory">luke</filename> of the subfolder <filename role="directory">home</filename> of the top level folder,
1322
and <filename>/home/luke/myfile.txt</filename> is the file <filename>myfile.txt</filename> in that subfolder. The
1323
leading <filename role="directory">/</filename> in these paths represents the top level folder.
1327
Every user has their own folder to hold their personal files and settings. This folder is called the <emphasis>home
1328
directory</emphasis> and is displayed in Thunar as special icon with the users login name. The folder is similar to
1329
the <guilabel>My Files</guilabel> folder known from Windows. The <emphasis>home directories</emphasis> of the various
1330
users in a system are usually located below the <filename role="directory">/home</filename> folder. For example
1331
<filename role="directory">/home/luke</filename> would be the home directory of the user with the login name
1332
<filename role="directory">luke</filename>, while <filename role="directory">/home/jane</filename> would be
1333
the home directory for the user with the login name <filename role="directory">jane</filename>.
1337
<sect3 id="file-types">
1338
<title>File Types</title>
1341
You may have already heard that everything is a file in UNIX. This is true for most objects present in UNIX systems
1342
today. In fact even devices are represented as a special files. While this may not make sense at first sight, it is
1343
one of the strengths of UNIX and its derivates, and has helped it to maintain a simple core over the years where other
1344
operating systems had to introduce new concepts for every new technology.
1348
These are the four most important types of files in the UNIX file system.
1351
<sect4 id="file-types-ordinary-files">
1352
<title>Ordinary Files</title>
1355
An ordinary file may contain text, a program or other data. This includes image files, audio files, office documents
1356
and video files. The term <emphasis>file</emphasis> is often used to refer to an ordinary file.
1360
<sect4 id="file-types-folder-files">
1361
<title>Folder Files</title>
1364
Folders are also files in the UNIX file system. To be exact a folder is a special file, which contains a
1365
mapping of file names to file references for every file contained within this folder.
1369
<sect4 id="file-types-symbolic-link-files">
1370
<title>Symbolic Link Files</title>
1373
A Symbolic link (often called a <emphasis>symlink</emphasis>) is a special file that contains a path to
1374
another file in the file system. Symbolic link files therefore do not contain any useful information
1375
themselves, but just refer to other files.
1379
<sect4 id="file-types-device-files">
1380
<title>Device Files</title>
1383
As mentioned earlier (most) devices are also accessed through the file system. These special device files are
1384
usually located in the <filename role="directory">/dev</filename> folder. For example the special file
1385
<filename>/dev/hda</filename> represents the first IDE disk on Linux.
1394
<title>Frequently Asked Questions</title>
1397
The intent of this section is to collect the quite numerous frequently asked
1398
questions that relate to working with Thunar. If you know of a question that
1399
is missing from this page, please <ulink type="http" url="http://bugzilla.xfce.org/enter_bug.cgi?product=Thunar&format=guided">file
1403
<sect3 id="faq-executables">
1404
<title>Why doesn't Thunar execute files marked as executable?</title>
1407
For security reasons Thunar only executes files of type <literal>application/x-desktop</literal>,
1408
<literal>application/x-executable</literal> and <literal>application/x-shellscript</literal>. For
1409
desktop files the execution feature will only be enabled if the desktop file is of type
1410
<literal>Application</literal> and a valid <literal>Exec</literal> line is given or of type
1411
<literal>Link</literal> and a valid <literal>URL</literal> is given. For the other types the feature
1412
is available if the file is marked executable for the current user.
1416
Also note that for <literal>application/x-executable</literal> and <literal>application/x-shellscript</literal>,
1417
the types of the file don't really need to match these types exactly, but it is suffice if the detected
1418
type has a parent that matches one of the two types listed above, or if the MIME-type is an alias for
1423
<sect3 id="faq-metadata">
1424
<title>Where does Thunar store the metadata associated with files?</title>
1427
Thunar associates various settings with files/folders, which we call metadata.
1428
This metadata for all files is stored in tdb database file, which is called
1429
the metafile. The database file is stored in
1430
<filename>$XDG_CACHE_HOME/Thunar/metafile.tdb</filename> and can be examined
1431
using the <command>tdbtool</command>, which is part of the Thunar distribution
1432
(located in the <filename role="directory">tdb/</filename> subdirectory).
1436
<sect3 id="faq-thunarrc">
1437
<title>Where does Thunar store its preferences?</title>
1440
Thunar stores the user configurable preferences (and hidden settings) in
1441
an <filename>.ini</filename> file, which is located at
1442
<filename>$XDG_CONFIG_HOME/Thunar/thunarrc</filename> and can be examined
1443
using a text editor. See <filename>docs/README.thunarrc</filename> for an
1444
overview of the various preferences.
1448
<sect3 id="faq-mouse-gestures">
1449
<title>How to use mouse gestures in Thunar?</title>
1452
Thunar currently features basic support for so called <emphasis>mouse gestures</emphasis>
1453
in its icon view. You can use these <emphasis>mouse gestures</emphasis> by holding down
1454
the middle mouse button (usually the mouse wheel) while the mouse pointer is on the
1455
background area of the icon view component (any area that is not covered by
1456
an icon or a text). Now you can move the cursor into four directions to
1457
perform certain actions, which are described below.
1461
<member><guilabel>Left</guilabel> - opens the previous visited folder</member>
1462
<member><guilabel>Up</guilabel> - opens the parent folder</member>
1463
<member><guilabel>Right</guilabel> - opens the next visited folder</member>
1464
<member><guilabel>Down</guilabel> - reloads the current folder</member>
1468
<sect3 id="faq-assign-keyboard-shortcuts">
1469
<title>How do I assign different keyboard shortcuts?</title>
1472
If you want to rebind a shortcut, Thunar supports the standard GTK+ way
1473
of changing shortcuts: simply hover over the menu option with the mouse
1474
pointer and press the keyboard shortcut you want to rebind it to.
1478
To delete a keyboard assignment, press the <keycap>Backspace</keycap> key
1479
while you are on the menu entry.
1483
If the shortcut doesn't change, then you need to enable the feature in
1484
GTK+. This can be achieved in 3 ways:
1490
If you are running Xfce 4.3 or above then you can enable <guilabel>Editable
1491
menu accelerators</guilabel> in the <guilabel>User Interface Preferences</guilabel>
1498
If you are running GNOME then you can enable <guilabel>Editable menu
1499
accelerators</guilabel> in the <guilabel>Menu and Toolbars</guilabel> control
1506
Otherwise put the following in your <filename>~/.gtkrc-2.0</filename> file
1507
(create the file if it doesn't exist):<screen>gtk-can-change-accels=1</screen>
1513
<sect3 id="faq-store-keyboard-shortcuts">
1514
<title>Where does Thunar store the keyboard shortcuts?</title>
1517
The custom keyboard shortcuts are stored in the standard GTK+ accel map format in a
1518
file located at <filename>$XDG_CONFIG_HOME/Thunar/accels.scm</filename>. Lines starting
1519
with <literal>;</literal> are comments. See the GTK+ documentation for details about the
1524
If you are a packager or a system administrator and want to provide a system wide default
1525
for the keyboard shortcuts, that is different from the default shortcuts in Thunar, you
1526
can create a file <filename>Thunar/accels.scm</filename> in one of the <envar>$XDG_CONFIG_DIRS</envar>.
1527
For example, if <filename role="directory">/etc/xdg</filename> is part of <envar>$XDG_CONFIG_DIRS</envar>
1528
(the default for most Linux distributions), you can install system wide defaults to
1529
<filename>/etc/xdg/Thunar/accels.scm</filename>. Thunar will then load shortcuts from this file on first startup.
1535
<sect1 id="support">
1536
<title>Support</title>
1539
To report a bug or to make a suggestion regarding this application or this manual, use the bug tracking system at <ulink url="http://bugzilla.xfce.org/enter_bug.cgi?product=Thunar&format=guided">http://bugzilla.xfce.org/</ulink>.
1540
Remember that useful bug reports are ones that get bugs fixed, so a useful bug report has two qualities:
1546
<emphasis role="bold">Reproducible.</emphasis> If the developer cannot see the bug himself
1547
to prove that it exists, he will most probably not be able to fix it at all. Every detail you
1553
<emphasis role="bold">Specific.</emphasis> The quicker the developer can isolate the problem
1554
to a specific area, the more likely he will expediently fix it.
1560
In case you want to request a new feature, please make clear why you consider it a worth
1561
addition for the application. It is more likely that a new feature gets added if you provide
1562
good arguments for the feature. It will increase the chance of addition even more if you
1563
provide a patch that implements the requested feature, but make sure that you read the file
1564
<ulink type="http" url="http://svn.xfce.org/svn/xfce/terminal/trunk/HACKING">HACKING</ulink>
1565
- especially the section labeled <emphasis>Coding Style</emphasis> - before you start hacking
1570
Else, if you have questions about the use or installation of this software, please ask on the
1571
<ulink type="http" url="http://foo-projects.org/mailman/listinfo/thunar-dev">thunar-dev mailing
1572
list</ulink> or point your IRC client to <emphasis role="bold">irc.freenode.net</emphasis>,
1573
join the channel <emphasis role="bold">#thunar</emphasis> and ask for help.
1577
<sect1 id="copyright">
1578
<title>About @PACKAGE_NAME@</title>
1581
@PACKAGE_NAME@ was written by Benedikt Meurer (<email>benny@xfce.org</email>). Visit the
1582
<ulink url="http://thunar.xfce.org/" type="http">Thunar website</ulink> for more information.
1586
This documentation was written by Benedikt Meurer (<email>benny@xfce.org</email>). The latest
1587
version of this document is always available from the <ulink type="http" url="http://thunar.xfce.org/">Thunar website</ulink>.
1591
This software is distributed under the terms of the GNU General Public License
1592
as published by the Free Software Foundation; either version 2 of the License, or
1593
(at your option) any later version.
1597
You should have received a copy of the GNU General Public License
1598
along with this program; if not, write to the Free Software
1599
Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307,
1606
vim:set ts=2 sw=2 et ai encoding=UTF-8: