Files.AudioCoverArt
-------------------

Loads audio file and returns cover art.

| Component | Version | macOS | Windows | Linux | Server | iOS SDK |
|---|---|---|---|---|---|---|
| [Files](component_Files.md) | [12.1](newinversion121.md) | ✅ Yes | ✅ Yes | ❌ No | ✅ Yes, on macOS and Windows | ❌ No |

MBS( "Files.AudioCoverArt"; FilePath { ; FileName } ) 

**MBS**( **"Files.AudioCoverArt";** /\* Loads audio file and returns cover art. \*/  
**$FilePath**; /\* The native file path to the audio file.e.g. "/Users/cs/Desktop/test.mp3" \*/   
**$FileName**) /\* Optional; The desired file name.e.g. test.jpg \*/ 

### Parameters

| Parameter | Description | Example | Flags |
|---|---|---|---|
| FilePath | The native file path to the audio file. | "/Users/cs/Desktop/test.mp3" |  |
| FileName | The desired file name. | test.jpg | Optional |

### Result

Returns container value or error.

### Description

Loads audio file and returns cover art.  
Should work for MP3, MP4 and FLAC files.  
May return JPEG, PNG, GIF or BMP depending on what the file contains.  
Result can be assigned to container. Result is empty, if there is no art found.  
  
This function requires a native path. Use [Path.FileMakerPathToNativePath](PathFileMakerPathToNativePath.md) to convert a FileMaker path to a native path if required. If you like to have the user choose the path, you can use [FileDialog](component_FileDialog.md) functions.  
For Server be aware that server has limited permissions and may not be able to access all files on a computer.  
### Examples

Query image of mp3 file:

 Set Variable \[ $path ; Value: "/Users/cs/Music/test.mp3" \]  
Set Field \[ Test::Image ; Value: MBS ("Files.AudioCoverArt"; $path ) \]  
### See also

- [Files.AudioTags](FilesAudioTags.md)
- [Path.FileMakerPathToNativePath](PathFileMakerPathToNativePath.md)

### Release notes

- **Version 15.4**
    - Added ASF support for [Files.AudioCoverArt](https://www.mbsplugins.eu/FilesAudioCoverArt.shtml) function.
- **Version 12.1**
    - Added [Files.AudioCoverArt](https://www.mbsplugins.eu/FilesAudioCoverArt.shtml) function

### Blog Entries

- [MBS FileMaker Plugin, version 15.4pr1](https://www.mbsplugins.de/archive/2025-08-01/MBS_FileMaker_Plugin_version_1/monkeybreadsoftware_blog_filemaker)
- [New in MBS FileMaker Plugin 12.1](https://www.mbsplugins.de/archive/2022-03-22/New_in_MBS_FileMaker_Plugin_12/monkeybreadsoftware_blog_filemaker)
- [Neues MBS FileMaker Plugin 12.1](https://www.mbsplugins.de/archive/2022-03-15/Neues_MBS_FileMaker_Plugin_121/monkeybreadsoftware_blog_filemaker)
- [MBS FileMaker Plugin 12.1 - More than 6700 Functions In One Plugin](https://www.mbsplugins.de/archive/2022-03-15/MBS_FileMaker_Plugin_121_-_Mor/monkeybreadsoftware_blog_filemaker)
- [MBS FileMaker Plugin, version 12.1pr4](https://www.mbsplugins.de/archive/2022-02-22/MBS_FileMaker_Plugin_version_1/monkeybreadsoftware_blog_filemaker)

This function checks for a license.

Created 21st February 2022 , last changed 24th February 2026

  
[Files.ApplicationPathWithBundleIdentifier](FilesApplicationPathWithBundleIdentifier.md) - [Files.AudioTags](FilesAudioTags.md)

[HTML Version](FilesAudioCoverArt.shtml)