How to Import a Folder and Append Clips to a Timeline

import os
import sys
from pathlib import Path


def import_resolve_module():
    try:
        import DaVinciResolveScript as dvr
        return dvr
    except ImportError:
        search_paths = [
            os.environ.get("RESOLVE_SCRIPT_API", ""),
            os.environ.get("RESOLVE_MODULES", ""),
            r"C:\\ProgramData\\Blackmagic Design\\DaVinci Resolve\\Support\\Developer\\Scripting\\Modules",
            "/opt/resolve/Developer/Scripting/Modules",
            "/Library/Application Support/Blackmagic Design/DaVinci Resolve/Developer/Scripting/Modules",
            str(Path.home() / "Library/Application Support/Blackmagic Design/DaVinci Resolve/Developer/Scripting/Modules"),
        ]
        for path in search_paths:
            if path and os.path.isdir(path) and path not in sys.path:
                sys.path.append(path)
        import DaVinciResolveScript as dvr
        return dvr


dvr = import_resolve_module()

media_dir = Path(r"D:\\Resolve\\source")
video_extensions = {".mp4", ".mov", ".mxf", ".avi", ".mkv"}

if not media_dir.is_dir():
    raise RuntimeError(f"Folder not found: {media_dir}")

files = sorted(
    str(path) for path in media_dir.iterdir()
    if path.is_file() and path.suffix.lower() in video_extensions
)

if not files:
    raise RuntimeError(f"No video files found in folder: {media_dir}")

resolve = dvr.scriptapp("Resolve")
if not resolve:
    raise RuntimeError("Resolve API is unavailable")

project = resolve.GetProjectManager().GetCurrentProject()
if not project:
    raise RuntimeError("No project is open")

media_pool = project.GetMediaPool()
clips = media_pool.ImportMedia(files)
if not clips:
    raise RuntimeError("Could not import clips")

timeline = project.GetCurrentTimeline()
if not timeline:
    timeline = media_pool.CreateEmptyTimeline("API_Timeline")
    if not timeline:
        raise RuntimeError("Could not create Timeline")

appended = media_pool.AppendToTimeline(clips)
if not appended:
    raise RuntimeError("AppendToTimeline did not append any clips")

print("Timeline:", timeline.GetName())
print("Clips appended:", len(clips))