<p align="center"> <img src="Assets/icon.png" width="128" height="128" alt="logo" /> </p>

MediaInfo - macOS Finder Sync Extension

Extension to display information about multimedia (images, videos and audio), PDF, Office, compressed archives and folders in the Finder contextual menu. Require maxOS 10.15 or higher.

MediaInfo is distributed in the hope that it will be useful but WITHOUT ANY WARRANTY.

If you like this application and find it useful, buy me a coffee!

• Behavior
• Installation
  • Note for macOS Sequoia
• Settings
  • Monitored folders
  • General
  • Customize the menu items
  • Common information
  • Common actions
  • Images
  • Video files
  • Audio files
  • PDF documents
  • Office files
  • Compressed archive files
  • Folders
  • Other files
• Menu actions
  • Common actions
  • Inline actions
  • Trigger action
• Scripting support
  • Customize the menu items
    • Exposed data
    • Inline scripts
    • Global scripts
  • Triggers
    • Validate trigger
    • Before render trigger
    • Action trigger
  • Utility functions
  • Action functions
  • Common properties
  • Properties for images
  • Properties for video files
  • Properties for audio files
  • Properties for PDF files
  • Properties for Office files
  • Properties for compressed archives
  • Properties for folders
• Known bugs and limitations
• Build from source
  • Dependencies
  • Application processes
• Credits

Behavior

This application allows you to customize the context menu for supported files. When you right-click on a file within a monitored folder the extension extracts all available information for the file and generates the context menu.

| | | |:---------|:--------- | | Image menu example | Video menu example | | Audio menu example | PDF menu example | | Office menu example | Archive menu example | | Folder menu example | |

With the main application you can customize the menu. You can compose the file properties generating the menu items. It is also possible to use a script code to format the menu items.

Remember that all rendering operations must be completed before the menu can be displayed. MacOS does not allow you to populate on-demand the menu but only before viewing, so any information extraction and formatting operation must be as fast as possible in order not to slow down the opening of the menu.

Installation

Go to the releases page to download the latest version.

Move the downloaded app on your Applications folder and launch it to set the monitored folders and the other settings.

Then you need to enable the associated Finder Sync Extension on the System Preferences / Extensions.

Now right click (or control click) on a supported file within a monitored folder to see the contextual menu with the information.

The precompiled application is not notarized or signed. The application is compiled as universal binary (Intel and Apple Silicon processor).

When you manually download the precompiled app directly you must strip quarantine flag. The first time you can launch the app with right click (or ctrl click) on the app icon and choose the open action.

Alternatively, you can open System Preferences > Security & Privacy > General (tab) then clicking the Open Anyway button.

If the system warns that the application is damaged, use the following terminal command:

$ xattr -cr "FULL PATH OF THE MediaInfo .app (you can drag the file to get the pull path)"

This will resolve the error of an unsigned/damaged application when launching the app.

When the monitored folders are changed or when the Finder Sync extension is restarted, the System may display a confirmation warning to allow read access to the files of the monitored folders. Access must be granted for the Finder extension to work.

Note for macOS Sequoia

Since macOS 15 Sequoia de Finder Extension is not available in the System Settings and cannot be easily enabled or disabled.

There's currently no official update or solution from Apple.

You can use the FinderSyncer utility to visual handle all Finder Extensions, or manually with these Terminal.app commands:

pluginkit -m CFBundleIdentifier=org.sbarex.MediaInfo.Finder-Extension -vv 

Copy the value of UUID that has a format similar to XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX and then execute the following code using the UUID copied:

pluginkit -e "use" -u "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX"

Replace "use" with "ignore" if you want to disable the extension.

Settings

Monitored folders

With the Application you can customize the monitored folders and the properties to be shown inside the contextual menu.

You can also auto monitor external disk.

Information is shown only for files within the monitored folders (and their subfolders).

General

The General tab allow to set some common options.

|Option|Description| |:-----------|:-----------------| |Show menu icons|Show icons inside the contextual menu. You can customize the icon for each menu item. Some icons (image, video, pdf, page, ratio, media box, bleed box, art box, text document) respect the orientation (portrait or landscape) of the source. The color icon respects the color space (RGB, CMYK, gray scale, B/W, Lab). The flag icon will be changed to the country language flag when used within a media file.| |Skip items with no data for the placeholders|Do not insert menu item with all empty placeholders.| |Show info on a submenu|If enabled, on the contextual menu is added a submenu with the info items, otherwise all items are put on the main contextual menu.| |Show main info on the submenu title|If enabled, a submenu with file information is added to the context menu, otherwise all items are placed in the main context menu.| |Use first menu item as Main info|Use the first item as the main title for the submenu.| |Menu action|Action performed when a menu item is selected. Some menu items always perform a custom action by ignoring this setting. You can use a custom trigger to handle the menu action.| |Metadata value on a submenu|In the metadata menu, show the value as a submenu or with the attribute name.| |Allow rounded aspect ratio|For images and videos, allow to round the size for a better ratio. | |Format for bytes|Allows you to choose how to display the values in bytes: using the system settings, in decimal format (1KB = 1000 bytes) or binary format (1KB = 1024 bytes)| |Format for bits|Allows you to choose how to display the values in bits: in decimal format (1Kb = 1000 bits) or binary format (1Kb = 1024 bits)| |Media engine priority|Allows you to choose the order in which the media engines are used to recognize images, videos and sounds. Not all engines can recognize all file properties. If one engine fails to process a file, the next engine is tried. |

Media engines:

• Core Media: it uses the Apple CoreMedia APIs to parse media files. It is able to recognize many formats and most of their properties.
• FFMpeg: it uses the FFMpeg library to analyze multimedia files. It generally supports more files and provides more detailed information. However, it requires more resources.
• Metadata: Use Apple Core Service APIs to extract information from metadata. It requires fewer resources but handle less information.

Customize the menu items

For each managed format it is possible to customize the list of menu items. For each item you can combine plain text with the placeholder which will be filled with its file property.

When composing the menu title, all worthless placeholders are left b