← Back to DJ Tools
Load Root · Master Folder

Load Root

The first step on the MDJPRO Hub — point at your master music folder on Mac. One macOS grant, one persistent security bookmark, local access for Scan, Wizard, and Tag Master.

Load Root does not scan or move files: it authorizes the macOS sandbox on the folder you pick and registers it as a ScanStore source. All processing stays on your drive — no cloud upload.

Typical flow: Splash → Hub → Load Root → (Library Wizard / Tag Master) → Start Scan → Results. Requires Basic or Premium license (not Trial). If the bookmark goes stale, run Load Root again.

Six module pillars

Master folder pickermacOS NSOpenPanel — directories only, single selection. Localized copy in EN/ES and more languages via LanguageManager.
Security-Scoped BookmarkPersistent SSB permission — macOS remembers your folder without Full Disk Access. External USB is authorized when you add it.
ScanStore registrationNormalized path saved as Source with bookmarkData — foundation for Start Scan, Serato/Rekordbox/VDJ sync, and Tag Master writes.
Basic / Premium gatebasicScan entitlement — Basic or Premium plans. Trial shows lock and opens Settings; not Premium-only like Wizard.
Re-verification & troubleshootingStale bookmark or red permission icon → run Load Root again. Manual §14: renewing the SSB marker is the canonical fix.
Ecosystem dependencyWizard auto-sets target from first source; Start Scan with no sources opens Load Root with autoScan; Tag Master may add disabled sources for ID3 access.

Where Load Root sits in MDJPRO

Hub Load Root Wizard / Tag Master Start Scan Results

What Load Root does not do

  • It does not scan audio or video — that is Start Scan.
  • It does not deploy folder DNA — that is Library Wizard (Premium).
  • It does not edit ID3 — that is Tag Master (Premium).
  • It does not replace protected USB volume permission — use Grant Disk Access on Results when needed.

Today vs what comes next

  • Today: localized PERMISOS-007 panel, statusLine feedback, green badge with source count.
  • You: pick the real root of your library — Serato, Rekordbox, or VirtualDJ read from there.
  • Next: inline Hub hints (copy only, PERMISOS-007 Phase 2+) — Splash → Hub flow unchanged.
Layer
Status
Role
Load Root (Mac Hub)
In production
Authorize local master folder
Start Scan
Next step
Index enabled sources only
Wizard + Tag Master
Premium
Structure and metadata after root

Load Root is the front door to MDJPRO on your Mac — without it there is no scan, no Wizard DNA, and no Tag Master session with real context. One click, one permission, full local control.

Booth Assistant

Sales & Negotiation Expert
🤖