QtIviMedia MediaPlayer Simulation Backend


  • QtMultimedia
  • taglib

Supported interfaces

The backend uses QtMultimedia to offer real media playback on various platforms. The indexer will automatically start to index all mp3 files in the media folder.

For the SearchAndBrowseModel the following contenTypes are supported:

  • artist A list of all artists.
  • album A list of all albums.
  • track A list of all tracks.

The model supports filtering and sorting, as well as navigating through the media library using the following navigation paths:

  • Artist -> Album -> Track
  • Album -> Track

Note: On systems where taglib is disabled, indexing of files doesn't work and because of that the media database can't be created.


This backend uses environment variables for its configuration. By default it will write its database to the application's cache location. There is also a non persistent mode, where the indexed media database is not saved, but recreated on every start of the app.

QTIVIMEDIA_TEMPORARY_DATABASEThe database is written to a temporary location and deleted when the application is stopped.
QTIVIMEDIA_SIMULATOR_DATABASEA path to the media database which should be used.
QTIVIMEDIA_SIMULATOR_LOCALMEDIAFOLDERThe local media directory (default: all media locations of the user - see also QStandardPaths)
QTIVIMEDIA_SIMULATOR_DEVICEFOLDERThe path which will be used by the DiscoveryModel for discovering media devices. (default: /home/<user>/usb-simulation)

© 2020 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.