Return a standardized JSON error response.

Retrieve a cached ``ShotManager`` for the given path.

Get information about a specific shot.

Return (and optionally create) the thumbnail for a video. Args: video_path: Path to the source video shot_name: Name

Resolve a naming pattern template into a filename base. Supported variables: {project}, {shot}, {date}. Falls back to shot_name if pattern is

Return a Path object from a potentially quoted string.

Strip any _v### suffix from a filename stem.

Save shared project data to .shotbuddy_project.json.

Get the expected thumbnail path for a reference image.

Return the thumbnail URL for a reference image, or None.

Create a JPEG thumbnail from an image file. Args: image_path: Path to the source image thumb_path: Path where the thumbnail shoul

Get user settings (global + project-specific + shared project data).

Return (and optionally create) the thumbnail for an image. Args: image_path: Path to the source image shot_name: Name

Load shared project data (artists, shot_artists) from .shotbuddy_project.json. Args: _project_settings: Already-loaded project se

Create thumbnail for reference image and save it to the central cache.

Return a POSIX-style absolute path string or ``None``.

Clear cached ``ShotManager`` instances.

Create folder structure for a shot.

Create a JPEG thumbnail from the first frame of a video file. Args: video_path: Path to the source video thumb_path: Path where t

Find the WIP file for a specific version of a reference image.

Get all shots in the project.

Load project-specific settings from the project directory.

Load a prompt for a specific asset version.

Ensure latest_images/ and latest_videos/ match the highest WIP versions. For each shot in wip/, finds the highest versioned image and video,

Build the merged settings response dict.

Return a new sub-shot name under ``base_shot``. ``base_shot`` should be a top-level shot name (no underscore). The new name will use

Return the key from metadata matching one of the names.

Get info for an image or video asset. Args: shot_name: Name of the shot shot_dir: Path to the shot directory

Helper for finding the latest final or highest versioned WIP asset. Searches for files containing ``shot_name`` to support custom naming

Return the path to the prompt file for a specific asset version.

Remove any file in latest/ that matches the given base stem.

Rename versioned asset files and their prompts in a directory. Args: directory: Path to the directory containing files

Check if a port is already in use.

Create thumbnail for image and save it to the central cache.

Create all required directories if they don't exist.

Get the next available version number for a shot asset. Searches for files matching ``{base_name}_v###.*`` in the directory.

Get path to project-specific settings file.

Get path to shared project data file (.shotbuddy_project.json).

Check if a PID belongs to a Shotbuddy process.

Open a folder in the system file browser.

Open the system file browser with the specified path selected.

Save project-specific settings to the project directory.

Save prompt for a specific asset version.