View source for Development/Howto/Mimetypes

__TOC__
= What is MIME ? =

Multipurpose Internet Mail Extensions (MIME) is an Internet Standard that extends the format of e-mail to support:
* text in character sets other than US-ASCII;
* non-text attachments;
* multi-part message bodies; and
* header information in non-ASCII character sets.
More informations in [http://en.wikipedia.org/wiki/Multipurpose_Internet_Mail_Extensions wikipedia/MIME].

The use of MIME type has been generalized in Unix and other free OS. When the header of the file giving the MIME type is missing, the system can guess the type of file with the (unreliable) suffix of its name.

MIME type is a subject often view as a complex subject. But in fact, it is not. It is often used to designate a lot of different things under the same umbrella.

On Linux systems, MIME type covers two different problems:

* associating a file to an identifier describing it type; this is called a MIME type.
* associating a MIME type to a application which will handle files from this type.

= Associating file to MIME type =

This part is taking of detecting which mimetype should be assigned to a particular file on disk (it is not relevant for network stream, see below for this).

KDE 4 and GNOME (2 and 3) are using Freedesktop.org [http://www.freedesktop.org/wiki/Specifications/shared-mime-info-spec specification]. File used for this specification are packaged in shared-mime-info package. If a file type is not recognized, a small XML file can be written like the following example:
<pre>
<?xml version="1.0"?>
<mime-info xmlns="http://www.freedesktop.org/standards/shared-mime-info">
  <mime-type type="application/x-foobar">
    <comment>foobar file</comment>
    <glob pattern="*.foobar"/>
     <magic priority="60">
       <match value="foobar-file" type="string" offset="20:140"/>
     </magic>
  </mime-type>
</mime-info>
</pre>

This file must be installed in {{file|/usr/share/mime/packages/}} and {{macro|%update_mime_database}} / {{macro|%clean_mime_database}} macro should be called in package {{macro|%post}} / {{macro|%postun}}.

This file will detect all files with .foobar as extension as all as file containing string "foobar-file" as offset 20 to 140 (this is often called magic).

It is highly recommended to submit bugs on [http://bugs.freedesktop.org/ Freedesktop.org bugzilla] for file type not recognized.

= Associating MIME type to applications =

This part is specified at [http://standards.freedesktop.org/desktop-entry-spec/latest/ freedesktop.org].

This part is also relevant for files downloaded through network (for instance a web browser). When a file is requested through a web browser, a mimetype is sent by web server, before the real file and web browser can then decide which application will be used to handle this file. It can happen that incorrect mimetype is sent but this particular case is a web server problem and can't be fixed on the client side.

To associate an application to mimetypes, .desktop file for the particular application should have the following line (list must always end with a semicolon):
<pre>
MimeType=application/x-foobar;application/x-foobar2;
</pre>

To add or remove mimetypes to .desktop file when doing packaging, it is best to use {{cmd|desktop-file-install}} utility. For instance :
<pre>
desktop-file-install --add-mime-type="foo/bar" --remove-mime-type="broken/mime" --vendor="" --dir %{buildroot}%{_datadir}/applications foobar.desktop
</pre>

A common question is handle how applications are prioritized when several applications claim to support the same mimetype.

According to freedesktop.org specification, every mimetype specified at {{file|/usr/share/applications/defaults.list}} file (packaged in {{pkg|share-mime-info}}) should list, in order or preference, the .desktops file corresponding to application to use.

For KDE, a key named '''InitialPreference''' is added in application .desktop file and application order is based on this key value : higher '''InitialPreference''' value will determine default application.

'''Exec''' line of .desktop file can be modified when command-line need to be tuned for specific applications (see [http://standards.freedesktop.org/desktop-entry-spec/desktop-entry-spec-latest.html#exec-variables here] for complete list),
* if only one file can be added as argument : <tt>%f</tt>
* if several files can be added as argument : <tt>%F</tt>
* if one url can be added as argument : <tt>%u</tt>
* if several urls can be added as argument : <tt>%U</tt>

<hr>

{{message|This page is based on the [http://wiki.mandriva.com/en/Development/Howto/Mimetypes Mandriva Mimetypes Howto].}}