Skip to content

Repository files navigation

MarkShot — DaVinci Resolve Marker Exporter

MarkShot reads timeline markers in DaVinci Resolve and batch-exports the marked frames as still images.

  • Version: 1.4.0
  • Current distribution: macOS
  • Live-tested: DaVinci Resolve Studio 20.3.3 on macOS 15.7.7

🇯🇵 日本語

Features

  • Batch-export every timeline marker in one run
  • Filter by marker color in Resolve Studio
  • Choose JPEG, PNG, or TIFF in Resolve Studio
  • Include or exclude Resolve's Data Burn-In overlay
  • Add the timeline timecode to every filename
  • Preserve existing files by adding -2, -3, and so on
  • Preserve existing Gallery stills
  • Support fractional and drop-frame timecode

MarkShot reads timeline markers. Clip markers are not supported.

Free vs Studio

Feature Studio Free
Export timeline-marker frames Yes Yes
Data Burn-In On/off On
Output format JPEG / PNG / TIFF JPEG
Marker-color filter Yes All markers
Settings dialog Yes No

The Free-version path uses the default settings: JPEG, all timeline markers, Data Burn-In on. The v1.4.0 live test was performed on Resolve Studio; Free compatibility is maintained through Resolve's Gallery fallback.

Requirements

  • DaVinci Resolve 17.4 or later, Free or Studio
  • macOS 10.15 or later

Windows distribution is paused from v1.4.0 because there is no maintained Windows test environment. Legacy Windows source files remain in the repository, but no v1.4.0 Windows installer is supplied or supported.

Install on macOS

  1. Download MarkShot-v1.4.0-macOS.dmg.
  2. Open the DMG.
  3. Right-click Install MarkShot.app, then choose Open.
  4. Select Install.
  5. Restart DaVinci Resolve.

The installer places MarkShot.py here:

~/Library/Application Support/Blackmagic Design/DaVinci Resolve/Fusion/Scripts/Utility/

If an older copy exists, the installer keeps one backup as MarkShot.py.previous.

Manual install

Copy MarkShot.py into the folder above, then restart Resolve.

Use

  1. Open a project and timeline in DaVinci Resolve.
  2. Add timeline markers with M.
  3. Choose Workspace > Scripts > Utility > MarkShot.
  4. In Studio, select:
    • File Format: JPEG / PNG / TIFF
    • Marker Color: All or one of the colors present on the timeline
    • Include Data Burn-in: on or off
  5. Choose an existing output folder.

MarkShot opens the output folder after a successful export.

Data Burn-In

MarkShot uses the overlay configured in Resolve:

  1. Choose Workspace > Data Burn-In.
  2. Enable the information to show, such as Record Timecode or Clip Name.
  3. Run MarkShot with Include Data Burn-in enabled.

The timecode in the output filename is independent of the visible Data Burn-In overlay.

Output

[ProjectName]_[HH_MM_SS_FF].jpg

Example:

MyMovie_01_00_12_08.jpg
MyMovie_01_00_12_08-2.jpg

For drop-frame timelines, MarkShot calculates the semicolon timecode correctly and replaces the separator with an underscore in the filename.

Safety changes in v1.4.0

  • No longer clears the current Gallery album
  • No longer deletes .drx files from the output folder
  • Verifies playhead navigation and each exported file
  • Uses an isolated temporary folder for Gallery fallback
  • Removes only the temporary still captured by MarkShot
  • Restores the Resolve page that was open before export
  • Sanitizes project names before using them as filenames

See CHANGELOG.md for the complete release notes.

Uninstall

Run Uninstall MarkShot.app from the DMG, or manually delete:

~/Library/Application Support/Blackmagic Design/DaVinci Resolve/Fusion/Scripts/Utility/MarkShot.py

The uninstaller intentionally keeps MarkShot.py.previous, if present.

Troubleshooting

MarkShot is not in the Scripts menu

  • Restart DaVinci Resolve.
  • Confirm MarkShot.py is in the Utility folder shown above.

MarkShot cannot connect to Resolve

  • Open a project and timeline.
  • In Resolve Studio, choose Preferences > System > General and set External scripting using to Local.
  • Run MarkShot from Resolve's Scripts menu.

macOS blocks the installer

Right-click the app and choose Open. If needed, allow it under System Settings > Privacy & Security.

The v1.4.0 apps are ad-hoc signed, not Apple-notarized, so Gatekeeper may still show the standard warning for an independent unsigned distribution.

Also from GIRAFFRAME

S2S (Slice2Storyboard) automatically detects cuts in a video and creates a visual storyboard.

License

MIT License

Author

Hiro / GIRAFFRAME

About

DavinciResolve ツール

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages