Running UltraGrid from macOS bunde - CESNET/UltraGrid GitHub Wiki

Binary UltraGrid build on macOS is usually distributed in for of a application bundle packed in a DMG image. You may want to run the UltraGrid command-line executable directly for multiple reasons:

  1. it gives you more control over UltraGrid run (for advanced users)
  2. GUI does not work for you - eg. when using on an old macOS

Mounting the image

If you want to run the command-line UltraGrid from within the DMG, you need to mount it first. This can be done either by simply double clicking the DMG, or with a command:

$ hdiutil mount UltraGrid.dmg
expected   CRC32 $5F887258
/dev/disk4              FDisk_partition_scheme         
/dev/disk4s1            DOS_FAT_32                      /Volumes/ULTRAGRID

This indicates that UltraGrid image is mounted in /Volumes/ULTRAGRID. Then you can directly run UltraGrid:

/Volumes/ULTRAGRID/uv-qt.app/Contents/MacOS/uv -h

Notes

In case, that you have already mounted the image with double-clicking the DMG in Finder, you can check where it is mounted:

$ mount | grep UL
/dev/disk4s1 on /Volumes/ULTRAGRID (msdos, local, nodev, nosuid, read-only, noowners, mounted by toor

If you mounted multiple UltraGrid images, later mounted images may be labeled by a numeric index:

$ hdiutil mount UltraGrid.dmg
expected   CRC32 $5F887258
/dev/disk4              FDisk_partition_scheme         
/dev/disk4s1            DOS_FAT_32                      /Volumes/ULTRAGRID

or

hdm3:~ toor$ mount | grep ULTRAGRID
/dev/disk4s1 on /Volumes/ULTRAGRID (msdos, local, nodev, nosuid, read-only, noowners, mounted by toor)
/dev/disk5s1 on /Volumes/ULTRAGRID 1 (msdos, local, nodev, nosuid, read-only, noowners, mounted by toor)`

In this case just use an escape backslash ('') to escape the space when running UltraGrid:

/Volumes/ULTRAGRID\ 1/uv-qt.app/Contents/MacOS/uv -h