mimeapps 0.3.4

MIME Applications Associations specification implementation

To use this package, put the following dependency into your project's dependencies section:


This package provides sub packages which can be used individually:

mimeapps:list - A minimal D application.

mimeapps:test - A minimal D application.

mimeapps:open - A minimal D application.

mimeapps:update - A minimal D application.


D library for finding associations between MIME types and applications, e.g. for deciding which application should be used to open a file.

Build Status Coverage Status

Online documentation

Modern desktop environments on GNU/Linux and BSD flavors implement MIME Applications Associations to control file associations. The goal of mimeapps library is to provide implementation of this specification in D programming language. Please feel free to propose enchancements or report any related bugs to Issues page.

Note: detection of file MIME type is out of the scope of mimeapps. You may consider using mime library for this purpose.



  • Reading mimeapps.list and mimeinfo.cache files.
  • Detecting default application for MIME type.
  • Getting associated applications for MIME type with respect to explicitly removed ones.
  • Adding, removing association or setting default application for MIME type.


  • Support for desktop-specific mimeapps.list files.


Mimeapps list

List default application and other associated applications for MIME type(s):

dub run :list -- text/plain image/png text/html

Also can be used for uri schemes:

dub run :list -- x-scheme-handler/http

Mimeapps test

Parse all mimeapps.list and mimeinfo.cache found on the system. Reports errors to stderr. Use this example to check if the mimeapps library can parse all related files on your system.

dub run :test

Mimeapps open

Detect MIME type of file and open it with default application for found type.

dub run :open -- LICENSE_1_0.txt

Add option --ask to list all associated applications before opening the file.

dub run :open -- --ask LICENSE_1_0.txt

Pass http url to open in web browser:

dub run :open -- --ask https://github.com/FreeSlave/mimeapps

Mimeapps update

Update mimeapps.list file. Since this library is in development, don't use this example to update file associations on your system. Better make copy first.

cp $HOME/.config/mimeapps.list /tmp/mimeapps.list
dub run :update -- --file=/tmp/mimeapps.list --remove=text/plain:kde4-kwrite.desktop --add=image/jpeg:gthumb.desktop --default=application/pdf:kde4-okular.desktop

Authors:Roman Chistokhodov

Sub packages:mimeapps:list, mimeapps:test, mimeapps:open, mimeapps:update


0.3.4 2017-Jun-29
0.3.3 2016-Sep-27
0.3.2 2016-Sep-16
0.3.1 2016-Jul-02
0.3.0 2016-Jun-14
Show all 10 versions

statistics are temporarily disabled.