qtFM will try to detect your icon theme by first asking the system, which should work fine under fullGnome/KDE environments. For some reason Xfce always reports 'gnome' icon theme. (See below)

If this fails it will then try to read the '~/.gtkrc-2.0' file for 'gtk-icon-theme-name'.If this fails it will then try to read the '~/.config/gtk-3.0/settings.ini' file for 'gtk-fallback-icon-theme'.

If all else fails it will then look for either 'gnome' or 'oxygen' in '/usr/share/icons/*'.

You can override all of the above and force it to use your desired icon theme by adding a new keyto the [General] section of '~/.config/qtfm/qtfm.conf' called 'forceTheme'.

eg.forceTheme=Tango

nb. The name must match the theme folder exactly (ie. case sensitive)

#####################Single-Click Navigation#####################

Single-click navigation can be enabled by adding a key called 'singleClick' to the general section of the qtfm.conf configuration file located in '~/.config/qtfm'.

There are two modes you can enable:

singleClick=1 single click activation of directories only singleClick=2 everything is single click

#####################Real Mime Types#####################

In 'Detail' view the 'Type' column shows the file extension by default. Alternatively you can show the actualmime type for the files, like 'image/png', by adding the following key to the qtfm.conf configuration file.

realMimeTypes=1

Note this can potentially slow down browsing slightly in detail mode.

This also affects 'Custom actions', ie. with this enabled you use the mimetype instead of the suffix in the'Filetype' column when creating custom actions.

#####################Custom Actions#####################

Filetype:

Options for the filetype are:

$suffix- matches files of that type. Multiple suffix can be separated by commas. eg 'png,jpg'. $folder - $folder is a specific folder name. Matches only that folder. eg 'Trash' $parent- $parent is the full path to a folder. Matches everything below this, files and folders. eg. '/media' folder - matches all folders. * - matches everything, all files and folders.

Note: The 'Filetype' for file specific custom actions are always treated like wildcards.

This is the text that will appear in the menu for your custom action. It can be any descriptive text you like.

There is one special case:- if you set the text to 'Open' it will override the default xdg-open association for that filetype. This custom action will then be used as the default for 'double-click' and 'right-click->open' commands.

You can group custom actions together by using a ' / ' in the text. Items with the same prefix will be grouped in a submenu.

eg. for images;

jpg,png Open with / gqview jpg,png Open with / gimp

Icon:

The name of any icon from your current theme. Double-click the entry to bring up the icon chooser dialog.

Command:

This is the custom command you want to run. You can also call any external shell script from the custom action. Use an external shell script if you want to perform complicated actions that require more than a single line command.

%iVar - Input variable - used to input a run-time variable contained in the custom action.'Var' can be any text you like and is used as the hint for the input dialog.eg. '%iPassword'

[] - tick the checkbox to monitor the output of the command. qtFM will be notified and report stdout and stderr messages after the command has completed.

Examples of some useful custom actions:

Filetype

Text

Icon

Command

gz,bz2

Extract here

package-x-generic

tar xf %f

png,jpg

Edit in Gimp

applications-graphics

gimp %f

mp3,ogg

Open

audio-x-generic

xmms %f

mp3,ogg

Enqueue

audio-x-generic

xmms -e %f

folder

Term here

terminal

urxvt -cd %F

Trash

Empty trash

dialog-warning

emptyTrash.sh

/media

Unmount

drive-harddisk

sudo umount %f

*

Trash

user-trash-full

mv -b %f ~/Trash

*

Compress / gz

package-x-generic

tar czf %n.tar.gz %f

*

Compress / bz2

filesave

tar cjf %n.tar.bz2 %f

*

Compress / lrz

preferences-other

lrztar %f

#####################Translations#####################

Many thanks to the following for contributing translations:

Chinese (Simplified)

zh

A. Lee

Chinese (Tradistional)

zh_TW

Cheng-Hong Wu

Danish

da

Peter J

French

fr

Diablo150

German

de

quax

Italian

it

zereal

Polish

pl

Michał

Russian

ru

Alexey

Serbian

sr

Mladen

Spanish

es

AntumDeluge

Swedish

sv

Swanson

If you would like to contribute to the translations you can grab the 'qtfm_XX.ts' templatein the source, rename it to your country code (qtfm_fr.ts) and then edit it with Qt's 'linguist'is easiest. Send me the completed ts file and I'll add it to the package.

#####################Tips & Tricks#####################

- If you 'Edit filetype' on a folder and set the handler to qtfm you can then right-click->Open on a folder to open in a new instance.

- Middle-click folders or bookmarks to open in a new tab. Ctrl+middle-click to open in a new instance.

- Middle-click tabs to close.

- Ctrl+drag&drop will copy instead of move.

- Click anywhere in the address bar path to navigate from there. Ctrl+click or middle-click will go immediately to that folder.

- Right-click on the status bar will bring up the 'View' options. Useful if you have hidden the main menu.

- When you copy things in qtfm it places the paths in the selection buffer so you can then middle-click in a text editor for example to 'paste as text'.

- You can also use sequential shortcuts like vi or emacs instead of the combination shortcuts (ctrl+x). In the shortcuts editor just seperate them with commas. eg. 'a,b,c'

- If you want the fastest possible startup time, don't have any image files (png,jpg etc) in the startup folder, because it will have to load the thumb cache immediately. Or use daemon mode!