Revision [20525]

This is an old revision of AssociateFiles made by darkcity on 2012-02-06 14:31:58.


HomePage > Components and HowTos > Configure

How to make File Associations

There are two ways to associate file-types in Puppy. The first is the by setting the 'default action' when clicking a certain file type. The second is creating an option in the File 'filename' menu when file is 'right-clicked'.

'Right-click' Association

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 getting to this directory is to right-click on a jpeg and select
File 'filename.jpg' > Customise Menu ...

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 with 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)

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 alternative to step 3. is to use 'Set Run Action' i.e right click on a file of your type and enter the shell command. 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