Revision [22126]

This is an old revision of AssociateFiles made by darkcity on 2012-07-09 15:13:15.


HomePage > Components and HowTos > Configure

How to make File Associations

There are a few ways to associate file-types to programs in Puppy. The following descriptions are based on the ROX Filer and may not work with other file managers.
Sometimes you won't be able to associate a file to a program because its MIME-type has not been defined. Looking in the file's Properties > Type will reveal only a general type (guessed by its content) - for example text/plain or application/x-executable. In this case you need to add a mime type.

Default Action
Default Action loads the file into the appropriate program when it is clicked (left-clicked) depending on its MIME-type. ROX will look for file named after the MIME type, firstly in-
~/.config/[MIME-type] then
For example, if the MIME-Type is application_x/audacity-project
then ROX will look for a file called application_x-audacity-project (notice the / is replaced by an _).
Typically this file is a script of a link to an executable. Often it is a link to a program's .Desktop stored in /usr/share/applications.
ROX provides a graphical way to set Default-Action

Right-click Association
Right-click Association loads the program when the user goes - Right-clicks menu > File 'document.doc' > Doc program

Open-with Association
Open-with Association loads the program when the user goes - Right-clicks menu > File 'document.doc' > Open With > Program

MIME-Types are used to standardised file-types. The 'Right-click' options are stored in

There is a directory for each mime-type in use, for example the MIME-Type directory for image/jpeg becomes .image_jpeg
A shortcut for making a 'right-click' association is in the example of a jpeg, 'right click' on a jpeg file and select
File 'filename.jpg' > Customise Menu ...
Open /usr/local/apps and copy an absolute link of the program you wish to associate

Typically the MIME-type directories are filled with links to ROX AppDirs stored at /usr/local/apps
If the application/action you want is already in this directory simply create a link in the MIME-type directory.

If not then create an AppDir. They consist of a directory containing three files-
Appinfo.xml - information about app in xml
AppRun - script to run program
.DirIcon - image file icon for directory (many apps have an icon stored in /usr/share/pixmaps which you can link)

These typically contain the following - using AbiWord as an example-
Appinfo.xml -
<?xml version="1.0"?>
  <Summary>Abiword text editor</Summary>

AppRun -
exec abiword  "$@"

The "S@" passes the file clicked on to the application.
To pass a file to a WINE program see the follow example using Irfanview

AppRun -
# Purpose: To convert Unix filename to DOS style to pass as an argument
# to wine when starting IrfanView from filer.
exec wine 'C:\\Program Files\\IrfanView\\i_view32.exe' $FileName

'Default Action' Association
To set the 'default action' of a file-type follow the following instructions (modified from this thread). Jump to Step 3 if you wish to associate with program already installed.

1. Check if your file-type has a MIME-type entry in Puppy Linux. They are stored in the text file /usr/share/mime/globs
If file-type is already associated to the correct MIME-type jump to step 2.
Add or edit your MIME-Type to file-type definition. For example, if you have a TextMaker file whose extension is .tmd and your making a non-standard MIME-type application/x-tmd append the code application/x-tmd:*.tmd to the globs file. ENSURE you end the line with a 'return' otherwise it won't work.
(The x- in the MIME-type name above is used to indicate that this type hasn't already been registered with the MIME-type authorities ( media-types). i.e. It is a non-standard/private/local type, not an IANA officially registered one.)

2. Create an executable shell script in /usr/local/bin , for starting up the TextMaker program and passing the 'clicked on' file to it. In our example, .tmd files will be associated to TextMaker. We'll make a script called textmaker (though it could be anything you like):
textmaker -
exec /usr/local/textmaker/tml "$@"

You don't need the path to the executable (in this case /usr/local/textmaker/) if the path directory your Linux PATH environment variable.
If textmaker was a WINE program then the script might be-
textmaker -
# Purpose: To convert Unix filename to DOS style to pass as an argument
# to wine when starting IrfanView from filer.
exec wine 'C:\\Program Files\\TextMaker\\TextMaker.exe' $FileName

3. Finally, tell the ROX filer to run that script when you click on your file-type. To do that you create another script in /root/Choices/MIME-types named after the MIME-type. In our example the MIME type was application/x-tmd, so the file becomes application_x-tmd-
exec textmaker "$1"

An easy way to associate a file-type with a program is (instead of step 3). is to use 'Set Run Action' i.e right click on a file of your type and enter the shell command/ or drag program on to box. In our example it would be exec textmaker "$1".
NOTE this alternative will save MIME-Type run action in /root/.config/ rather than /root/Choices/MIME-types. This method will take precedence over using /root/Choices/MIME-types (i.e. ROX looks to /root/.config/ first).

There are no comments on this page.
Valid XHTML :: Valid CSS: :: Powered by WikkaWiki