Skip to content

Releases: CreativeLyons/SnapReview-OpenRV

Release list

SnapReview.rvpkg - v1.5.1

SnapReview.rvpkg - v1.5.1 Latest
Latest

Choose a tag to compare

View all tags
@CreativeLyons CreativeLyons released this 01 Feb 02:03
v1.5.1
b17eae2

SnapReview for OpenRV

A Python plugin for OpenRV that adds text annotation overlays to your review sessions.

Changelog: CHANGELOG.md

Features

notesOverlay_RV_02b

Quick Notes:

  • Add notes via SnapReview > Add Note menu or Shift+N hotkey
  • Multi-line text input with copy/paste support
  • White text with black outline for readability on any background
  • Notes persist in session files (survives save/autosave)

Add notes via SnapReview > Add Note menu or Shift+N hotkey

Menu_01

Multi-line text input with copy/paste support

notesOverlay_RV_01_notes

White text with black outline for readability on any background

notesOverlay_RV_04

Smart text wrapping and vertical stacking

notesOverlay_RV_03

Notes persist in session files (survives save/autosave)

Save Review (New in v1.4.0)

  • Export review package with Cmd+Shift+S (macOS) / Ctrl+Shift+S or SnapReview > Save Review
  • Creates timestamped folder next to source with:
    • RV session file (.rv)
    • Notes text file with paths to exported content (.txt)
    • Annotated frames as JPGs in frames/ subfolder
  • Automatically resets view zoom and color corrections before export
  • Works with image sequences (normalizes frame patterns to ### format)
    reviewPackage

Copy Notes

  • Export all notes with Cmd+Shift+C (macOS) / Ctrl+Shift+C
  • Markdown-friendly format with header, body, and file path
  • Captures both plugin notes AND RV's native paint text annotations
  • Drawing-only frames show placeholder "*see annotation"

Example Note result:

Notes on pexels-rodnae-productions-8474580.mp4
2026_01_28 08:20

---

Frame 1
- *see annotated frame

Frame 18
- some really long note about how i went ot the moon and we might want to check a bunch of stuff
- just to test, a new note as well

Frame 29
- note here

Frame 63
- note 1
- another note 2
- more note

Frame 133
- WOW look at this here

Frame 194
- *see annotated frame

Frame 257
- random note to do on this frame

---

/Users/somebody/Downloads/pexels-rodnae-productions-8474580.mp4

Keyboard Shortcuts

Action Shortcut
Add Note Shift+N
Copy Notes Cmd+Shift+C / Ctrl+Shift+C
Save Review Cmd+Shift+S / Ctrl+Shift+S
Submit Note Enter
New Line Shift+Enter
Cancel Escape

Usage

Adding Notes

  1. Navigate to the frame you want to annotate
  2. Press Shift+N or use SnapReview > Add Note
  3. Type your note in the dialog (multi-line supported, copy/paste works)
  4. Press Enter to save, Escape to cancel (Shift+Enter for new line)

Notes appear in the top-left of the image with a dash prefix. The dialog title shows the source frame number for reference.

Exporting Notes

Either Copy Notes to just copy the notes to clipboard:
Press Cmd+Shift+C (macOS) or Ctrl+Shift+C to copy all notes to clipboard:

or

Save Review (Press Cmd+Shift+S (macOS) or Ctrl+Shift+S) to export a review package with annotated frame jpgs, the rv session, and a notes text file.

The contents of the text file is also copied to your clipboard.

The review folder defaults to the same folder as the footage or image sequence.

Notes on shot_010_v002.mov
2026_01_28 14:30

---

Frame 1001
- First note on this frame
- Second note

Frame 1045
- Another observation

---

source file:
/path/to/shot_010_v002.mov

source folder:
/path/to/

When using Save Review, the footer also includes paths to the exported content:

annotations:
/path/to/2026_01_29_143022_shot_010_v002-review/frames

session:
/path/to/2026_01_29_143022_shot_010_v002-review/shot_010_v002-review_session.rv

The export includes both this plugin's notes and RV's native text annotations. Frames with only drawings show - *see annotated frame as a placeholder.

⚙️ Configuration

Text rendering can be customized by modifying constants in NotesOverlay.py:

TEXT_SIZE = 0.005           # Text size (% of image height)
MAX_CHARS_PER_LINE = 58     # Characters before wrapping
LINE_SPACING = 0.08         # Space between stacked notes

Fixed in 1.5.1

Save Review handles errors and feedback better; note export and frame handling are corrected. Includes internal code cleanup.

Installation

Quick Install (recommended)

  1. Download the .rvpkg from this release (Assets below)
  2. In RV: Preferences > Packages > Add Package...
  3. Select the downloaded .rvpkg file
  4. Restart RV

Development (symlink)

Development details: docs/DEVELOPMENT.md

# macOS
ln -s /path/to/NotesOverlay.py ~/Library/Application\ Support/RV/Python/
ln -s /path/to/notes_dialog.mu ~/Library/Application\ Support/RV/Mu/
ln -s /path/to/clipboard.mu ~/Library/Application\ Support/RV/Mu/

# Linux
ln -s /path/to/NotesOverlay.py ~/.rv/Python/
ln -s /path/to/notes_dialog.mu ~/.rv/Mu/
ln -s /path/to/clipboard.mu ~/.rv/Mu/

About OpenRV

Open RV is the open-source version of RV, the Sci-Tech award–winning media review and playback software from the Academy Software Foundation.

License

This project is licensed under the MIT License.

Video by RDNE Stock project: https://www.pexels.com/video/overhead-shot-of-astronauts-walking-in-an-outdoor-area-8474580/

Assets 3
Loading

SnapReview.rvpkg - v1.5.0

SnapReview.rvpkg - v1.5.0

Choose a tag to compare

View all tags
@CreativeLyons CreativeLyons released this 29 Jan 23:04
v1.5.0
d182e85

SnapReview for OpenRV

📝 A Python plugin for OpenRV that adds text annotation overlays to your review sessions.

Changelog: CHANGELOG.md

✨ Features

notesOverlay_RV_02b

Quick Notes:

  • Add notes via SnapReview > Add Note menu or Shift+N hotkey
  • Multi-line text input with copy/paste support
  • White text with black outline for readability on any background
  • Notes persist in session files (survives save/autosave)

Add notes via SnapReview > Add Note menu or Shift+N hotkey

Menu_01

Multi-line text input with copy/paste support

notesOverlay_RV_01_notes

White text with black outline for readability on any background

notesOverlay_RV_04

Smart text wrapping and vertical stacking

notesOverlay_RV_03

Notes persist in session files (survives save/autosave)

Save Review (New in v1.4.0)

  • Export review package with Cmd+Shift+S (macOS) / Ctrl+Shift+S or SnapReview > Save Review
  • Creates timestamped folder next to source with:
    • RV session file (.rv)
    • Notes text file with paths to exported content (.txt)
    • Annotated frames as JPGs in frames/ subfolder
  • Automatically resets view zoom and color corrections before export
  • Works with image sequences (normalizes frame patterns to ### format)
    reviewPackage

Copy Notes

  • Export all notes with Cmd+Shift+C (macOS) / Ctrl+Shift+C
  • Markdown-friendly format with header, body, and file path
  • Captures both plugin notes AND RV's native paint text annotations
  • Drawing-only frames show placeholder "*see annotation"

Example Note result:

Notes on pexels-rodnae-productions-8474580.mp4
2026_01_28 08:20

---

Frame 1
- *see annotated frame

Frame 18
- some really long note about how i went ot the moon and we might want to check a bunch of stuff
- just to test, a new note as well

Frame 29
- note here

Frame 63
- note 1
- another note 2
- more note

Frame 133
- WOW look at this here

Frame 194
- *see annotated frame

Frame 257
- random note to do on this frame

---

/Users/somebody/Downloads/pexels-rodnae-productions-8474580.mp4

Keyboard Shortcuts

Action Shortcut
Add Note Shift+N
Copy Notes Cmd+Shift+C / Ctrl+Shift+C
Save Review Cmd+Shift+S / Ctrl+Shift+S
Submit Note Enter
New Line Shift+Enter
Cancel Escape

🚀 Installation

Quick Install (recommended)

  1. Download the .rvpkg from this release (Assets below)
  2. In RV: Preferences > Packages > Add Package...
  3. Select the downloaded .rvpkg file
  4. Restart RV

Development (symlink)

Development details: docs/DEVELOPMENT.md

# macOS
ln -s /path/to/NotesOverlay.py ~/Library/Application\ Support/RV/Python/
ln -s /path/to/notes_dialog.mu ~/Library/Application\ Support/RV/Mu/
ln -s /path/to/clipboard.mu ~/Library/Application\ Support/RV/Mu/

# Linux
ln -s /path/to/NotesOverlay.py ~/.rv/Python/
ln -s /path/to/notes_dialog.mu ~/.rv/Mu/
ln -s /path/to/clipboard.mu ~/.rv/Mu/

📖 Usage

Adding Notes

  1. Navigate to the frame you want to annotate
  2. Press Shift+N or use SnapReview > Add Note
  3. Type your note in the dialog (multi-line supported, copy/paste works)
  4. Press Enter to save, Escape to cancel (Shift+Enter for new line)

Notes appear in the top-left of the image with a dash prefix. The dialog title shows the source frame number for reference.

Exporting Notes

Either Copy Notes to just copy the notes to clipboard:
Press Cmd+Shift+C (macOS) or Ctrl+Shift+C to copy all notes to clipboard:

or

Save Review to export a review package with annotated frame jpgs, the rv session, and a notes text file.

The contents of the text file is also copied to your clipboard.

The review folder defaults to the same folder as the footage or image sequence.

Notes on shot_010_v002.mov
2026_01_28 14:30

---

Frame 1001
- First note on this frame
- Second note

Frame 1045
- Another observation

---

source file:
/path/to/shot_010_v002.mov

source folder:
/path/to/

When using Save Review, the footer also includes paths to the exported content:

annotations:
/path/to/2026_01_29_143022_shot_010_v002-review/frames

session:
/path/to/2026_01_29_143022_shot_010_v002-review/shot_010_v002-review_session.rv

The export includes both this plugin's notes and RV's native text annotations. Frames with only drawings show - *see annotated frame as a placeholder.

⚙️ Configuration

Text rendering can be customized by modifying constants in NotesOverlay.py:

TEXT_SIZE = 0.005           # Text size (% of image height)
MAX_CHARS_PER_LINE = 58     # Characters before wrapping
LINE_SPACING = 0.08         # Space between stacked notes

📚 About OpenRV

Open RV is the open-source version of RV, the Sci-Tech award–winning media review and playback software from the Academy Software Foundation.

📄 License

This project is licensed under the MIT License.

Video by RDNE Stock project: https://www.pexels.com/video/overhead-shot-of-astronauts-walking-in-an-outdoor-area-8474580/

Loading

NotesOverlay.rvpkg - v1.3.0

NotesOverlay.rvpkg - v1.3.0

Choose a tag to compare

View all tags
@CreativeLyons CreativeLyons released this 28 Jan 07:40
v1.3.0
b9529d0
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

NotesOverlay for OpenRV

A Python plugin that adds text annotation overlays to your review sessions.

✨ Features

Quick Notes:

  • Add notes via Review > Add Note menu or Shift+N hotkey
  • Multi-line text input with copy/paste support
  • White text with black outline for readability on any background
  • Notes persist in session files (survives save/autosave)

Add notes via Review > Add Note menu or Shift+N hotkey

notesOverlay_RV_05

Multi-line text input with copy/paste support

notesOverlay_RV_01b

notesOverlay_RV_02b

White text with black outline for readability on any background

notesOverlay_RV_04

Smart text wrapping and vertical stacking

notesOverlay_RV_03

Notes persist in session files (survives save/autosave)

Copy to Clipboard (New in v1.3.0)

  • Export all notes with Cmd+Shift+C (macOS) / Ctrl+Shift+C
  • Markdown-friendly format with header, body, and file path
  • Captures both plugin notes AND RV's native paint text annotations
  • Drawing-only frames show placeholder "*see annotation"

Example Note result:

Notes on pexels-rodnae-productions-8474580.mp4
2026-01-28 08:20

---

Frame 1
- *see annotated frame

Frame 18
- some really long note about how i went ot the moon and we might want to check a bunch of stuff
- just to test, a new note as well

Frame 29
- note here

Frame 63
- note 1
- another note 2
- more note

Frame 133
- WOW look at this here

Frame 194
- *see annotated frame

Frame 257
- random note to do on this frame

---

/Users/somebody/Downloads/pexels-rodnae-productions-8474580.mp4

Keyboard Shortcuts

Action Shortcut
Add Note Shift+N
Copy Notes Cmd+Shift+C / Ctrl+Shift+C
Submit Note Enter
New Line Shift+Enter
Cancel Escape

Install

  1. Download NotesOverlay.rvpkg
  2. In RV: Preferences > Packages > Add Package...
  3. Select the downloaded rvpkg file
  4. Load package
  5. Restart RV

Video by RDNE Stock project: https://www.pexels.com/video/overhead-shot-of-astronauts-walking-in-an-outdoor-area-8474580/

Loading