D library for finding associations between MIME types and applications, e.g. for deciding which application should be used to open a file.
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.
List default application and other associated applications for MIME type(s):
dub examples/list.d text/plain image/png text/html
Also can be used for uri schemes:
dub examples/list.d x-scheme-handler/http
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 examples/test.d
Detect MIME type of file and open it with default application for found type.
dub examples/open.d LICENSE_1_0.txt
Add option --ask to list all associated applications before opening the file.
dub examples/open.d --ask LICENSE_1_0.txt
Pass http url to open in web browser:
dub examples/open.d --ask https://github.com/FreeSlave/mimeapps
Update mimeapps.list file. If you want to update file associations on your system using this example use --force flag, but I would recommend to make a copy first.
cp $HOME/.config/mimeapps.list /tmp/mimeapps.list
dub examples/update.d --file=/tmp/mimeapps.list --remove=text/plain:kde4-kwrite.desktop --add=image/jpeg:gthumb.desktop --default=application/pdf:kde4-okular.desktop