vmrv2 v1.4.0 vulkan

This beta release of v1.4.0 corresponds to: 2 of August of 2025 at 12:43:42 Buenos Aires, Argentina (-0300 UTC/GMT).

It does not support NDI® on any platform.

It works on Windows 8.1+ (without USD support), Ubuntu 22.04 LTS+, macOS 13 (amd64 also without USD support) and macOS M1/M2/M3 (arm64).

It may contain bugs, new untested features and more.

You can extract it to compile yourself with:

   git clone https://github.com/ggarra13/mrv2.git
   cd mrv2
   git checkout 12ab25e029be8b4c5e40ef0986c5fec855ab38ed
   ./runme.sh  -vk clean

Enjoy!

---

v1.4.0 Notes

• Added license_helper for easy licensing of mrv2.
• Added backend used to -version flag.
• Added tabulation to -version flag's output.
• Made Vulkan's mrv2 be installed as vmrv2 to distinguish it from the OpenGL version and allow having both installed easily.
• Fixed a useless icons directory on macOS and a missing one on Windows.
• Turned off screen saver/suspending as it was not friendly to some users.
• Added Alt + LMB when in scrubbing mode to scrub slower.
• Added a Preference to set a multiplier on how slow with Alt + LMB.
• Added a Preference to control how scrubbing looping behavior works. It can be set to Button (the UI timeline setting), Inactive or Active.
• Fixed Vulkan's DPI and scaling of images/videos within the viewport.
• Made audio stop playback when the window is minimized (due to a bug in FLTK only on Windows).

Notes on installation

• On macOS you install it by opening the .dmg file, and dragging the ${mrv2_NAME} icon to the Applications directory. If there's already an ${mrv2_NAME} version, we recommend you overwrite it. The macOS application is currently not notarized, so when you launch it you will not be able to run it as macOS will warn you that the file is not secure as it was downloaded from internet. To avoid that, you need to open the Apple Logo->Settings->Privacy and Security and go to Security and allow "Opening Anyway". Alternatively, you can do it from the Terminal, by:

  sudo xattr -rd com.apple.quarantine /Applications/${mrv2_NAME}.app/

• Windows and Chrome, like macOS, also protect you from installing files from the Internet. When you first download it with Chrome it may warn you that it is not an usual archive to be downloaded. Make sure to click on the right up arrow menu to Save it anyway. You cannot open the .exe from Chrome directly. You will need to open Windows Explorer and go to the Downloads directory. You should then run it from there. Then Windows will popup a Blue box telling you Windows SmartScreen prevented the start of an unknown application and that you can place your PC at risk. Click on the More Information text and a Button that says Run anyway or similar should appear. Click on it and follow the standard instructions to any Windows installer. One note about the Windows install. When asked if you want to add ${mrv2_NAME} to your PATH, it is recommended to answer No to it, as it avoids DLLs conflicts with other applications that use common libraries like FFmpeg or OpenUSD.

• On Linux, in order to install the .rpm or .deb packages requires your user to have sudo permissions.

On Debian (Ubuntu, etc) systems, you would install with:

  sudo dpkg -i ${mrv2_NAME}-${branch}-Linux-amd64.deb

On Fedora, you would install it with:

  sudo rpm -i ${mrv2_NAME}-${branch}-Linux-amd64.rpm

Once you install it, you can run mrv2 by just typing ${mrv2_NAME} in the shell, as a symlink to the executable is placed in /usr/bin. The installers will also associate file extensions and install an icon for easy starting up in the Desktop icon of the user that installed it. For running ${mrv2_NAME} with the icon, you need to select it and use the right mouse button to open the menu and choose Allow Launch.

If you lack sudo permissions in your organization, you should download the .tar.gz file and you can uncompress it with:

  tar -xf ${mrv2_NAME}-${branch}-Linux-amd64.tar.gz

That will create a folder in the directory you uncompress it from. You can then run ${mrv2_NAME} by using the mrv2.sh shell script in the bin/ subdirectory.

The Vulkan releases in the vulkan/ directory are demo versions for you to evaluate vmrv2 before a purchase and report bugs or performance issues. Currently, the demo versions don't have:

   - Annotations
   - A/B Comparisons
   - OpenEXR Layer switching
   - NDI support

Notes about Vulkan on Windows

In order to get HDR, you currently need to have Windows 10+ (11 is ideal) and an HDR monitor.

Notes about Vulkan on NVidia Linux

In order to get HDR, you currently need to have the KWin6 or GNOME48 compositors and an HDR monitor.

It will likely work with any NVidia RTX 3080+ or similar AMD board, but it will require you to choose and test your hardware carefully.

The preferred NVidia driver tested for best performance is nvidia-driver-570 (default on Ubuntu 25.04 with GNOME48).

For best performance with the NVidia driver, you can modify:

    sudo nano /etc/default/grub

Modify line 11 to from:

GRUB_CMDLINE_LINUX_DEFAULT="quiet splash nvidia_drm.modeset=1 nvidia_drm.fbdev=1"

To this content:

GRUB_CMDLINE_LINUX_DEFAULT="quiet splash nvidia_drm.modeset=1 nvidia_drm.fbdev=1 nvidia.NVreg_EnableGpuFirmware=0"

   sudo update-grub
   sudo reboot

Notes about Vulkan on macOS Intel

• Only up to Vulkan 1.3 is currently supported.
• HDR on macOS needs a MacBook Pro. MacBook Pro Intel will give you up to 1000 Nits of HDR depending on model.
• MacBook Pro Silicon should work with any M1 device up to HDR+.