davinci-resolve-setup
Skill19 starsChanged 6 months agoMITView on GitHub
Use when a user is installing DaVinci Resolve for the first time, switching machines, configuring a media drive for video editing, or asking about backup/proxy settings. Triggering symptoms include phrases like "just installed Resolve", "set up DaVinci Resolve", "drop frames during playback", "where should my media live", "how do I configure backups", or any DaVinci Resolve installation/preferences question.
1 other project uses a version of this.
Adopted by
Most recently taken up by
- kitloomlk-stack/davinci-resolve-video-kitword for word, first seen Oct 17, 2026
Other versions1 project uses a version of this.
Word for word · 1
- kitloomlk-stack/davinci-resolve-video-kit★ 0100% same
Edited · 0
None found.
Wrote their own version · 0
None found.
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository10 other files it gives its agents.
- davinci-resolve-audio-cleanup-podcastSkill
- davinci-resolve-color-grade-webcamSkill
- davinci-resolve-computer-use-trainingSkill
- davinci-resolve-cut-screen-recordingSkill
- davinci-resolve-devrel-project-templateSkill
- davinci-resolve-export-multi-platformSkill
- davinci-resolve-social-editorSkill
- davinci-resolve-titles-and-lower-thirdsSkill
- davinci-resolve-troubleshootingSkill
- social-video-folder-autocutterSkill
The file
We split this skill into the rules it gives an agent
7 rules. About 0 are common, 5 are distinctive, and 2 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈5
Distinctive · estimate
This author's own choices. Worth a look.
2
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 20
When NOT to use:
- Distinctive: line 41
Run the installer. Restart if prompted.
- Distinctive: line 46
Run it pointed at the drive you plan to use for media.
- Distinctive: line 47
Look at the "Will It Work?" table.
- Very specific: line 48
If the drive cannot sustain reads above ~500 MB/s for your codec at your resolution, you will get dropped-frame playback.
- Very specific: line 71
Check Timeline backups too (this backs up .drt files which are smaller and recoverable independently).
- Distinctive: line 124
If the user pushes back on a recommendation (install path, backup interval, drive speed, scripting toggle), read these PDF page ranges to …
≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
DaVinci Resolve — first-time setup for content creators
Overview
One-time configuration for DaVinci Resolve 20 so it does not bite you later. Three things matter: the install source, the media drive, and the backup settings. Everything else can be configured per-project.
When to use
Symptoms:
- Just downloaded DaVinci Resolve and want to know what to configure first
- Bought a new external drive and need to point Resolve at it
- Playback drops frames or shows a red GPU indicator
- Want to enable automatic project backups before doing real work
When NOT to use:
- Resolve is already running fine and you have an existing project — skip to
davinci-resolve-devrel-project-template. - You only need to enable Python scripting — that is a one-liner in Preferences > System > General (set External scripting to Local).
Quick reference
| Decision | Right answer | Why |
| Install source | blackmagicdesign.com, NOT Mac App Store | App Store version sandboxes the file system |
| Free vs Studio | Free is fine for 99% of DevRel | Studio adds noise reduction, AI Smart Reframe, neural engine features |
| Media drive | Fastest external SSD you have | Read >500 MB/s minimum for 4K |
| Backup interval | 10 minutes / 24 hours / 180 days | Survives editor crash, daily mistake, six-month regret |
| Render cache location | Internal SSD, not media drive | Reduces read/write contention |
Steps
1. Install from blackmagicdesign.com (not the App Store)
- Open a browser, go to
https://www.blackmagicdesign.com/products/davinciresolve. - Click Download.
- Choose your OS (macOS, Windows, Linux). On macOS, do not install via the Mac App Store — it sandboxes the filesystem and breaks several workflows like the Blackmagic Proxy Generator.
- Run the installer. Restart if prompted.
2. Test your media drive speed before you commit to it
- Download Blackmagic Disk Speed Test (free, separate app). On macOS it is on the App Store. On Windows it is included with the Desktop Video installer.
- Run it pointed at the drive you plan to use for media.
- Look at the "Will It Work?" table. Confirm green checkmarks for the codecs and resolutions you actually shoot (typically H.265 at 1080p/4K, or Blackmagic RAW if you shoot on a Blackmagic camera).
- If the drive cannot sustain reads above ~500 MB/s for your codec at your resolution, you will get dropped-frame playback. Buy a faster drive or generate proxies (covered in
davinci-resolve-devrel-project-template).
3. First launch — set the media folders
- Launch DaVinci Resolve. Skip the welcome screen.
- Click DaVinci Resolve > Preferences (macOS) or DaVinci Resolve > Preferences (Windows).
- Switch to the System tab at the top.
- Click Media Storage in the left sidebar.
- Click the + button and add your media drive. This tells Resolve where to look for media by default.
- Click Save.
4. Enable Live Save and project backups
This is the single most important step. Resolve does NOT save by default, and you will lose work.
- DaVinci Resolve > Preferences > User > Project Save and Load.
- Confirm Live Save is checked. This auto-saves on every change.
- Check Project backups.
- Set the intervals:
- Backups every 10 minutes (6 backups per hour)
- Hourly backups for the past 24 hours
- Daily backups for the past 180 days (six months)
- Click Browse for Backup location and pick a folder on your internal SSD (not the media drive — you want backups in a different place than your media in case the media drive dies).
- Check Timeline backups too (this backs up
.drtfiles which are smaller and recoverable independently). - Click Save.
These intervals are loosely based on the Colorist Guide's project backup recommendations.
5. Set the working folders for the project media cache
- DaVinci Resolve > Project Settings (or File > Project Settings, or press Shift-9).
- Master Settings > scroll to Working Folders.
- Set:
- Cache files location — internal SSD (fast)
- Proxy generation location — internal SSD or media drive (your call)
- Project media location — typically same as Cache files, on your internal SSD
- Save.
6. Enable external scripting (optional, but you will want it later)
- DaVinci Resolve > Preferences > System > General.
- Set External scripting using to Local.
- Save. Restart Resolve.
This lets you run Python scripts against Resolve from your terminal — used by davinci-resolve-cut-screen-recording and davinci-resolve-export-multi-platform.
Common mistakes
- Installed via Mac App Store -> uninstall and reinstall from blackmagicdesign.com. The App Store version cannot reach external drives reliably and the Blackmagic Proxy Generator is missing.
- Media drive is USB 2.0 -> you will not be able to play back even 1080p H.264 reliably. Move to USB 3 / Thunderbolt / NVMe.
- Backup location set to the media drive -> backups die with the media drive. Use the internal SSD.
- Live Save unchecked -> you will lose hours of work the first time Resolve crashes.
Verification
You succeeded if all of the following are true:
- Resolve launches without complaining about a missing license or installer signature.
- You can drag a video file from your media drive into the Media Pool without Resolve marking it offline.
- The frame-rate indicator at the top of the source viewer stays green during playback (not red).
- The path under DaVinci Resolve > Preferences > User > Project Save and Load > Backup location shows a folder on your internal SSD.
- You can find
.drpfiles (project backups) appearing in the backup folder after 10 minutes of editing.
Transfer
Now try this: import a clip from a different drive than the one you configured. Resolve should still find it (since the file lives at an absolute path). Then disconnect that drive and reopen the project — note how Resolve flags those clips as offline and offers Relink in the Media Pool. That is the workflow you will use the first time a colleague hands you a project file without media.
Working reference
docs/wiki/beginners-guide.md(install, system requirements, Quick Setup)docs/wiki/colorist-guide.md#front-matter--project-backups-pp-6-7(Live Save and project backups, primary)docs/wiki/editors-guide.md#lesson-6--ai-workflows-pp-323-387(Disk Speed Test, proxies)docs/wiki/master.md#reset-matrix--when-the-user-pushes-back-read-this(cross-cutting symptom map)
When the agent's work isn't matching expectations (context-rot reset)
If the user pushes back on a recommendation (install path, backup interval, drive speed, scripting toggle), read these PDF page ranges to reset:
DaVinci-Resolve-20_Beginners-Guide.pdfpp. xiv-xxiv (Getting Started, system requirements, download instructions)DaVinci-Resolve-20-Editors-Guide.pdfpp. xii-xxiv (Getting Started — Editor's perspective on initial setup)DaVinci-Resolve-20-Editors-Guide.pdfpp. 324-337 (Generating Proxy Files; Blackmagic Disk Speed Test; drive speed considerations)DaVinci-Resolve-20-Colorist-Guide.pdfpp. 6-7 (Setting Up Project Backups, Live Save settings)
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

