Help

Installation guides and troubleshooting.

Troubleshooting

Common issues and their solutions.

The plugin doesn't appear in Resolve ▼

Make sure you ran the installer and it completed successfully. The plugin should appear at Workspace → Scripts → Eternal2x. If it's not there, restart Resolve. If it still doesn't appear, re-run the installer.

"Missing repo root" error ▼

This means the plugin can't find the folder where you extracted it. The most common cause is moving or renaming the plugin folder after installing. Re-run the installer from the new location.

"Could not import DaVinciResolveScript" ▼

This error means the script is not running inside DaVinci Resolve. Make sure you're opening it from Workspace → Scripts → Eternal2x inside Resolve, not by double-clicking the Lua file directly.

Detect is slow on long clips ▼

This is expected. Motion detection analyzes every frame of the clip using OpenCV. A 30-second clip at 60fps means 1,800 frames to process. The sensitivity slider does not affect speed — only which frames are marked as motion.

No markers appear after Detect ▼

Your clip may have very subtle motion that falls below the sensitivity threshold. Lower the sensitivity slider (closer to 0) and try again. Also make sure you have a clip selected on the timeline before clicking Detect.

The installer says "Python not found" ▼

On Windows, the installer automatically downloads and sets up a private Python for you — no action needed. If this fails, check your internet connection. On macOS, the installer does the same with a portable Python build. If all else fails, install Python manually from python.org and re-run the installer.

Windows Guide

One-click installation. No terminal required.

Download the plugin

Go to the Download page and grab the Windows zip.

Extract the zip

Right-click the downloaded file and select Extract All. Put it somewhere permanent — don't leave it in your Downloads folder.

Do not move this folder after installing. If you do, re-run the installer.

Run the installer

Double-click Eternal2xInstaller.exe inside the extracted folder.

Click the Install button and wait for it to finish. The installer will:

Set up Python automatically if you don't have it
Install required Python packages
Copy the plugin into DaVinci Resolve
Write the configuration file

Open in Resolve

Restart DaVinci Resolve, then go to:

Workspace → Scripts → Eternal2x

Manual install (alternative)

If the GUI installer doesn't work, you can install manually via the command line.

pip install numpy opencv-python

python Installer/install_eternal2x.py

Then restart Resolve.

macOS Guide

Same process — extract, install, done.

Download the plugin

Go to the Download page and grab the macOS zip.

Extract the zip

Double-click the zip file to extract it. Move the folder somewhere permanent, like your home directory or Applications.

Run the installer

Open Terminal and run:

cd ~/path/to/eternal2x-mac
python3 Installer/gui_installer.py

Or if you have a compiled .app installer, just double-click it.

The installer downloads a portable Python automatically if your system doesn't have one. Works on both Apple Silicon (M1/M2/M3) and Intel Macs.

Open in Resolve

Restart DaVinci Resolve, then go to:

Workspace → Scripts → Eternal2x

Manual install (alternative)

pip3 install numpy opencv-python

python3 Installer/install_eternal2x.py

Then restart Resolve.

How to Use

The full workflow in 4 steps.

Detect

Select a clip on your timeline. Adjust the sensitivity slider, then click Detect. Blue [DSU] markers will appear on your clip wherever motion was found. You can drag, delete, or add markers manually before continuing.

Sequence

Click Sequence to cut the clip at every marker position and convert each segment into a 1-frame clip for precise interpolation control.

Regroup

Click Regroup to close all the gaps left over from cutting. Your timeline becomes continuous again and markers shift to match.

Upscale + Interpolate

Click Upscale + Interpolate. Every clip gets 2x Super Scale. Motion segments get Optical Flow interpolation for smoothness. Static segments use Nearest for speed. Done.