Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

11 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Bookmark Navigator for Nuke

A floating hotbox-style panel that lists all bookmarked nodes in your Nuke script and navigates to them instantly.

Nuke has a native bookmark system — any node can be flagged as a bookmark via its properties panel. The built-in J shortcut cycles through them one by one. Bookmark Navigator gives you a visual panel with all bookmarks at once, filterable and searchable, with starred favorites pinned to the top.


Features

  • Floating panel — appears at your cursor position, just like Nuke's hotbox
  • All bookmark types — reads the native bookmark knob, works with any node class (Backdrop, Read, Write, Merge, custom gizmos, etc.)
  • Search / filter — type to filter the list in real time
  • Starred favorites — pin important bookmarks to the top of the list; stars are saved per-project inside the .nk file and travel with your script
  • Right-click context menu — navigate, select node, or toggle star without opening the panel fully
  • Toggle shortcut — a configurable shortcut to enable/disable the bookmark knob on any selected node directly from the keyboard
  • Per-user settings — panel width, sort order, zoom level, filter bar toggle, all saved to ~/.nuke/bookmark_navigator_prefs.json
  • Settings dialog — configure everything from inside Nuke via Edit > Bookmark Navigator > Settings
screem_video.mp4

Usage

Opening the panel

Press Alt+B while the Node Graph is active. The panel appears at your cursor.

Navigating

Click any bookmark in the list to center the Node Graph on that node. Press Enter to jump to the first result in the current filtered view.

Filtering

Type in the search bar to filter bookmarks by name or node class. The list updates instantly.

Starring favorites

Click the icon on any row to star it. Starred bookmarks move to the top of the list, separated by a divider from the rest. Stars are stored in a hidden knob on the script root, so they are saved with your .nk file.

Right-click menu

Right-click any bookmark row for quick actions: navigate to it, select the node in the graph without navigating, or toggle its starred state.

Keyboard shortcuts

Key Action
Alt+B Open the panel
ESC Close the panel
Enter Navigate to the first result
Click outside Close the panel

Toggling bookmarks from the keyboard

Go to Edit > Bookmark Navigator > Settings and set a shortcut in the Toggle bookmark on selected node field (e.g. ctrl+alt+b). With one or more nodes selected, pressing that shortcut will enable or disable their bookmark knob instantly.


How to bookmark a node

Any node in Nuke has a bookmark knob. To enable it:

  1. Select the node and open its properties panel (Enter)
  2. Look for the bookmark flag icon at the top of the panel (same area as the node color and tile controls)
  3. Enable it — the node is now visible in Bookmark Navigator

This is the same flag that Nuke's native J shortcut uses to cycle through bookmarks.

Requirements

Nuke version Python Qt binding
12 and above Python 3 PySide2

Installation

1. Copy bookmark_navigator.py to your .nuke folder or to any folder already on your Nuke Python path.

~/.nuke/bookmark_navigator.py

2. Add the following lines to your existing ~/.nuke/menu.py:

import bookmark_navigator

nuke.menu('Nuke').addCommand(
    'Edit/Bookmark Navigator/Show',
    bookmark_navigator.show,
    'alt+b'
)
nuke.menu('Nuke').addCommand(
    'Edit/Bookmark Navigator/Settings',
    bookmark_navigator.show_settings
)

3. Restart Nuke (or source your menu.py).


Settings

Open Edit > Bookmark Navigator > Settings to configure: Panel

Setting Description Default
Panel width Width of the floating panel in pixels 320
Max visible rows Rows shown before the list scrolls 14
Sort bookmarks by Name (A–Z), Node type, or Position in script Name
Zoom level on navigate Zoom factor applied when centering on a node 1.0
Show filter bar Toggle the search input at the top of the panel On
Toggle bookmark shortcut Keyboard shortcut to toggle bookmark on selected nodes ctrl+alt+b

Settings are saved per user to ~/.nuke/bookmark_navigator_prefs.json.


File structure

bookmark_navigator.py     # main script — copy this to your .nuke folder
menu.py                   # snippet to add to your existing menu.py

Author

Eduardo Brandao
eduardo@bosonpost.com.br

Did this tool help you? You can buy me a coffee via PayPal at eduardo@bosonpost.com.br or by purchasing my book. https://vfxebook-9dqwsk8s.manus.space/


License

MIT License. Free to use, modify, and distribute. Attribution appreciated.

About

Floating bookmark navigator panel for Nuke, nuke, vfx, python, pipeline, compositing

Resources

Stars

3 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages