https://github.com/przxmus/better-markers
obs markers are made so poorly that this plugin fixes them all with support for major editing softwares, templates and hotkeys
https://github.com/przxmus/better-markers
davinci davinci-resolve finalcutpro obs plugin premiere
Last synced: 4 months ago
JSON representation
obs markers are made so poorly that this plugin fixes them all with support for major editing softwares, templates and hotkeys
- Host: GitHub
- URL: https://github.com/przxmus/better-markers
- Owner: przxmus
- License: gpl-2.0
- Created: 2026-02-26T10:39:50.000Z (4 months ago)
- Default Branch: master
- Last Pushed: 2026-02-26T20:47:46.000Z (4 months ago)
- Last Synced: 2026-02-26T21:57:24.894Z (4 months ago)
- Topics: davinci, davinci-resolve, finalcutpro, obs, plugin, premiere
- Language: C++
- Homepage:
- Size: 361 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Agents: AGENTS.md
Awesome Lists containing this project
README
# Better Markers for OBS
Better Markers lets you drop edit markers while recording in OBS and export them for Premiere Pro, DaVinci Resolve, and Final Cut Pro.
## What You Get
- `Add Marker` in OBS while recording
- Marker templates (title, description, color)
- Optional template fields editable at marker time
- Hotkeys for quick markers
- Global/Profile/Scene Collection template scopes
- Multi-output export targets:
- Premiere Pro (XMP sidecar + embed for MP4/MOV)
- DaVinci Resolve (FCPXML timeline markers)
- Final Cut Pro on macOS (FCPXML clip markers)
## Install (Windows ZIP)
1. Close OBS.
2. Open the release `.zip`.
3. Drag `obs-plugins` and `data` from the ZIP directly into your `obs-studio` folder:
- usually `C:\Program Files\obs-studio`
4. Reopen OBS.
This places files in:
- `C:\Program Files\obs-studio\obs-plugins\64bit\better-markers.dll`
- `C:\Program Files\obs-studio\obs-plugins\64bit\better-markers.pdb` (if included in the build)
- `C:\Program Files\obs-studio\data\obs-plugins\better-markers\locale\*.ini`
## Install (macOS)
Available release assets: `.pkg`, `-macos-universal.tar.xz`
1. Close OBS.
2. Open the release `.pkg` and finish the installer.
3. Reopen OBS.
Manual (`-macos-universal.tar.xz`):
1. Close OBS.
2. Extract the archive.
3. Copy `better-markers.plugin` to:
- `~/Library/Application Support/obs-studio/plugins/`
4. Reopen OBS.
Use the platform archive (`-macos-universal.tar.xz`), not `-source.tar.xz`.
## Install (Linux)
Available release assets: `.deb`, `-x86_64-ubuntu-gnu.tar.xz`
1. Close OBS.
2. Install the downloaded package:
- `sudo apt install ./better-markers--x86_64.deb`
3. Reopen OBS.
Manual (`-x86_64-ubuntu-gnu.tar.xz`):
1. Close OBS.
2. Extract the archive.
3. Copy the extracted `lib` and `share` folders into `/` (root), preserving paths.
4. Reopen OBS.
Use the platform archive (`-x86_64-ubuntu-gnu.tar.xz`), not `-source.tar.xz`.
## Quick Start
1. Open OBS and go to `Tools -> Better Markers Settings`.
2. In `Export Targets`, enable the hosts you use.
3. Create marker templates.
4. Optionally set hotkeys in `Settings -> Hotkeys`.
5. In `Marker Dialog`, leave `Pause recording while marker dialog is open` enabled (default) if you want typing time excluded from footage.
6. Optional: enable `Send synthetic keypress before/after marker dialog focus flow` for hotkey dialogs.
7. Optional: set `Key to press before dialog focus` and `Key to press after dialog unfocus` (defaults are `Esc` / `Esc` when the feature is turned on).
8. Start recording and add markers from the dock or hotkeys.
## Generated Files
For recording file `.mp4` or `.mov`, Better Markers creates:
- Premiere:
- `.xmp`
- Marker embed is applied automatically to MP4/MOV when recording closes
- Final Cut Pro (macOS):
- `.better-markers.fcp.fcpxml`
- DaVinci Resolve:
- `.better-markers.resolve.fcpxml`
All files are written in the same folder as the recording.
## Import In Your Editor
- Premiere Pro:
- Import/open the recording normally. Markers are already embedded (MP4/MOV) or available from the `.xmp` sidecar.
- DaVinci Resolve:
- Import the recording.
- Import `.better-markers.resolve.fcpxml` to bring in timeline markers.
- Final Cut Pro (macOS):
- Import the recording.
- Import `.better-markers.fcp.fcpxml` to bring in clip markers.
## Important Notes
- Markers can be added only while recording is active (not paused).
- If enabled in settings (default), recording is paused while a marker dialog is open and resumes when the dialog flow ends.
- Synthetic pre/post keypresses are disabled by default and apply only to hotkey dialogs.
- If synthetic pre/post keypresses are enabled, the sequence is: pause recording -> pre keypress -> dialog -> restore focus -> post keypress -> resume recording.
- On Wayland and on systems without required input permissions, synthetic keypresses may be unavailable. Better Markers shows one warning per OBS session in that case.
- Export writes happen immediately after each new marker.
- Multi-output runs in parallel: one target failing does not block the others.
- Final Cut export is available only on macOS.
- Resolve export uses timeline markers in v1.
- Only MP4/MOV recordings are supported for marker export artifacts.