Skip to content
DUO

DUO Official Docs

🛡️ Diablo 2: Resurrected Utility Overlay (DUO)

Section titled “🛡️ Diablo 2: Resurrected Utility Overlay (DUO)”
Platform VirusTotal License Language Game

A multi-purpose utility overlay (DUO) designed to comprehensively enhance your Diablo 2: Resurrected gameplay. In addition to real-time tracking for the upcoming Terror Zone and Diablo Clone progression across servers, it provides various quality-of-life utilities, such as a highly customizable Buff Skill Timer, a Terror Zone Herald Counter, and an In-game Item Search Dictionary, directly on your game screen.

⚠️ Disclaimer:

DUO does not read or modify the game client’s memory (RAM) or game files, and is designed to operate based on screen capture and OCR—using similar principles as standard streaming and screen-sharing software (such as OBS Studio or Discord). In addition, it does not perform in-game character movement, attacks, skill usage, or any automated actions.

However, DUO is not officially endorsed or provided by Blizzard, and the final judgment regarding Blizzard’s Terms of Use and third-party software policies rests with Blizzard. Therefore, DUO does not guarantee account safety or immunity from sanctions.

Users must use this software at their own risk and responsibility.

📑 Table of Contents

Section titled “📑 Table of Contents”

📸 Screenshots

Section titled “📸 Screenshots”

1. Next Terror Zone & DClone Progress Terror Zone Screen Diablo Clone Screen


2. Buff Overlay & Profile Management Buff Overlay Screen Buff Profile Settings Screen

Select from built-in HD skill icons and 1-click recommended presets across all 8 classes, or capture any custom skill icon directly from the game screen (🎯 Custom Capture). Group your skills by profile for different characters or builds using the intuitive settings UI.


3. Real-time Item Search Dictionary Item Search Screen

Instantly search for Unique/Runeword items, base materials, aliases, and check their market value on Traderie without tabbing out of the game.


4. Speedrun Timer Speedrun Timer Screen

Intuitively compare and record how much your clear time has improved after changing your equipment or builds.


5. Gear & Skill Build Snapshot Manager Gear & Skill Build Snapshot Manager Screen

Capture your character’s entire build setup slot-by-slot (Gear, Mercenary, Charms, Stats, and Skill Trees) and merge them into a single, sleek 3-column vertical infographic card image ready for 1-click clipboard pasting (Ctrl + V) into Discord and gaming communities.


6. Daily Farming Report Daily Farming Report Screen

Automatically aggregates pure hunting time, run counts, average clear times, Top 7 farming spots, and evaluates looted items by stat rolls (Perfect/Top) and value tiers ([S+], [S], [A]) into a high-resolution, Diablo-themed daily infographic report card.

🚀 Getting Started

Section titled “🚀 Getting Started”

1. Download & Preparation

Section titled “1. Download & Preparation”
  1. Go to the 👉 Latest Release Page (Click), download the installer (DUO_Setup.exe), and run it.
    • Default Installation Path: %LocalAppData%\Programs\D2R Utility Overlay (You can copy & paste this into your file explorer address bar)
    • 🛡️ Security & Malware Verification: Every release installer is scanned and verified clean on VirusTotal. (View VirusTotal Scan Report)
  2. Sign up/Login to d2tz.info and copy your API Key (Token) from the User Profile page.

💡 How to keep your settings when updating:

  • Auto-Update (Recommended): Simply click the ⚡ Auto-Update button on the overlay when a new version is detected. It will safely download and install the update in the background while preserving all your custom settings and profiles.
  • Manual Update: If you download the new .exe installer manually, simply run it. It will safely overwrite the files while preserving your old d2r_overlay_config.json and profiles.

Auto-Update button display screen

💡 When a new version is detected, the ⚡ Auto-Update button appears at the top of the screen.

2. Run & Configure

Section titled “2. Run & Configure”
  1. Run Diablo 2: Resurrected. (Fullscreen Mode recommended).
  2. Run the D2R Utility Overlay shortcut created on your Desktop or Start Menu. (Run as administrator if your D2R client is also running as admin).
  3. Press Ctrl + Shift + S or right-click the system tray icon to open the ⚙️ Settings window.
  4. Paste your API Key (Token) into the settings and customize layouts, fonts, and overlay positions.

💻 System Requirements & Compatibility

Section titled “💻 System Requirements & Compatibility”

DUO is built and optimized for Windows 11 (64-bit). On-screen text recognition (OCR) features utilize the Windows 11 built-in Snipping Tool OneOCR engine, resulting in different feature support across OS versions:

FeatureWindows 11 (22H2+ Recommended)Windows 10Notes
Terror Zone & DClone Tracker✅ Supported✅ SupportedLive API data feed
Custom Buff Timer✅ Supported✅ SupportedMulti-client target / Mutual exclusion
Speedrun Timer✅ Supported✅ SupportedGame enter/exit auto-sync
Item Dictionary (Text Search)✅ Supported✅ SupportedUnique/Runeword/Alias database search
Auto Item Tooltip / Drag OCR✅ Full Support⚠️ Not SupportedRequires Windows 11 Snipping Tool OCR engine
Relay Game Name OCR (Shift+C)✅ Full Support⚠️ Not SupportedRequires Windows 11 Snipping Tool OCR engine
Monster Attribute & Herald Counter✅ Full Support⚠️ Not SupportedRequires Windows 11 Snipping Tool OCR engine
Gear & Build Snapshot Manager✅ Supported✅ SupportedSlot capture & image compositing (OCR search Win11 only)
OBS Studio Dedicated Stream Canvas✅ Supported✅ SupportedWindow Capture supported

💡 Note for Windows 10 Users: Terror Zone and DClone overlays, Buff Timers, Speedrun Timer, and manual Item Search function normally on Windows 10. However, Windows 11 is required for automatic on-screen OCR features (Item OCR, Game Name Capture, and Herald Counter).

⌨️ Hotkeys

Section titled “⌨️ Hotkeys”

[!TIP] 🎮 Top 5 Most Used Hotkeys

  • Ctrl + Shift + S : Open Settings instantly (in-game)
  • Ctrl + F : Open Item Search Dictionary
  • Ctrl + T : Superfast Item Tooltip Auto-OCR (Traderie price check / DB log)
  • Shift + C : Auto-capture Relay Game Name and copy to clipboard
  • Ctrl + B : Open / Close Gear & Skill Build Snapshot Manager

Convenient hotkeys for controlling overlays and features. (Item OCR hotkeys can be changed at the bottom-right of the Item Search window; Buff hotkeys in skill settings)

CategoryHotkeyFunction
GlobalCtrl + Shift + SOpen Settings Instantly
Item SearchCtrl + FOpen Item Search Window
Tab(In Search) Cycle Tabs (Unique/Runeword/Set/Rune/Other/Fav)
↑ / ↓(In Search) Navigate Search Results
Ctrl + Enter(In Search) Instant DB record for rune/item & close window
ESCClose Search Window
Item RecognitionCtrl + RDrag scan item area manually
Ctrl + T⚡ Auto-detect item tooltip box (Note: Multi-loader title bar toggle conflict: see FAQ #5)
Build SnapshotCtrl + B📷 Open / Close Gear & Skill Build Snapshot Manager
Farming Report / HUDUser Defined Keys📊 Open Daily Farming Report / ⏱️ Toggle Live Farming Mini HUD
QoL FeaturesShift + CAuto-capture relay game name & copy to clipboard
Buff OverlayPageUp / PageDownSwitch Buff Profiles
User Defined KeysTrigger Specific Buff Timer
Speedrun TimerHomeStart / Pause Timer
EndRecord Complete (Save Lap Time)
Shift + DelReset All Records & Stats

✨ Key Features

Section titled “✨ Key Features”

1. 😈 Real-time TZ & DClone Tracker

Section titled “1. 😈 Real-time TZ & DClone Tracker”
  • 🎯 Custom Favorite Alerts: Get text blinks and sound notifications when your favorite zones are discovered and 5 mins before they start.
  • 🔔 Uber Alerts & Spawn Detection: Choose your expansion (LoD/RotW) and get notified when DClone stages increase. Also provides warning chimes and voice alerts if DClone progress drops unexpectedly (spawned and reset between polling cycles).
  • ⚡ Smart Polling: Highly optimized API calls to prevent traffic waste, automatically switching to high-speed boost mode upon detecting stage changes.

2. 📖 In-game Item Search Dictionary

Section titled “2. 📖 In-game Item Search Dictionary”
  • 🔍 Powerful & Flexible Search Engine: Search quickly by English/Korean names, base items, required runes, or well-known aliases. Use spaces to combine these keywords effortlessly.
  • 🤖 Auto Recognition (OCR) & Custom Settings (Win 11 Only): Quickly scan items by dragging (Ctrl + R) or using the auto-detect box (Ctrl + T).
    • Precision Variable Stat Auto-Fill: Offers versatile modes to automatically calculate and populate stat ranges for Traderie searches:
      • Value ± %, Value ± Val: Automatically calculates ranges centered around the actual scanned numbers (by percentage or fixed values).
      • Min + Val, Max - Val: Fixed integer additions/subtractions from min/max stats.
      • Min + %, Max - %: Percentage-based adjustments from min/max stats.
      • Min + Max, Min Only, Max Only: Fixed bounds.
      • Intuitive +/- stepper buttons for effortless tweaking, with item roll tiers (Perfect/High) accurately evaluated against the actual recognized values.

    (Easy Explanation: You no longer need to manually type item stats. Just press the hotkey, and the program will read the screen to automatically fill in the values for your Traderie search.)

  • 📈 Seamless Traderie Integration (Price Check & Quick Listing):
    • 🛒 Live Market Search: Instantly opens the Traderie market page with your configured variable stats pre-applied.
    • 📝 Quick Listing (Price Check): Opens the Traderie listing page with all scanned variable stats pre-filled. Simply click ‘Create Listing’ and enter your price to list items for sale in seconds!
    • 📦 Category Item Base Auto-Detection & Selector: When scanning broad categories like ‘All Boots’ or ‘All Gloves’, DUO automatically detects the specific base item (e.g., Sharkskin Boots) from OCR text. Live search browses all boots broadly, while the listing button targets the exact base for immediate sale.
    • ⚡ Instant Tooltips: Hovering over search/listing buttons or base dropdown displays descriptive tooltips with 0ms delay.
  • 💾 Item Drop History (Auto DB Logging & Drop History):
    • ⚡ Auto DB Logging on OCR: Scanning an item (Ctrl + T / Ctrl + R) while farming automatically logs its full stats, current area, and difficulty directly into the local SQLite database (d2r_stats.db).
    • ⚡ Quick Drop Entry Chips (Runes & Misc):
      • Rune Tab: 1-click quick chips for High Runes (Vex–Zod) and Mid Runes (Ral, Hel, Lem–Gul). Logs drop to DB instantly with toast notification.
      • Misc Tab: 1-click quick chips for Torch Keys (Terror/Hate/Destruction), Uber Ancient Statues (5 types), and Token/Essences. Smartly resolves destination area (Keys map to Tower 5/Arcane/Vaught; Essences/Statues map to their respective boss rooms).
    • 🏘️ Smart Logging While in Town (Use Last Field & Town Selection):
      • Use Last Field Option (Default ON): When scanning items (Ctrl + T) or clicking [💾 Save DB] in town after batch Cain identification, drops are automatically logged under your last visited hunting area with a toast alert without interrupting modal dialogs.
      • Town Selection for Crafted Items (Runewords/Charms): For items crafted in town (Runewords, Horadric Cube recipes), the manual DB dialog provides a [🏰 Current Town] 1-click quick chip, and town hubs are pinned at the top of each act list in the area dropdown for effortless selection.
    • ⌨️ Instant Save via Ctrl + Enter: Enter a rune number (e.g. 30) or item name in the search bar and press Ctrl + Enter to log the drop to DB instantly and return to game.
    • 🖱️ Smart [💾 Save DB] Button: Regular click instantly records based on current area or last field in town; Shift + Click opens the detailed entry dialog (Area/Difficulty/Monster).
    • Clean 2x2 Bottom Controls & Tooltips: Checkboxes are neatly aligned in a 2x2 grid (Auto-Chronicle & Auto-Popup Drawer / Auto-DB Record & Use Last Field) to prevent clutter while keeping perfect horizontal balance.
    • 📜 History Drawer & Region Stats Integration: Compare previously found rolls of the same item in the [History] side drawer, and explore drop breakdowns and top farming spots in the [Region Stats] settings tab.

3. 🛡️ Powerful Buff Overlay

Section titled “3. 🛡️ Powerful Buff Overlay”
  • ⚡ Built-in 8-Class Skill Icons & 1-Click Recommended Buff Presets (⚡ Add Skill Preset):
    • 61 Curated HD Skill Icons Pre-Bundled: Extracted directly from Diablo II: Resurrected data files across all 8 classes (Amazon, Sorceress, Necromancer, Paladin, Barbarian, Druid, Assassin, and Warlock), allowing you to select and register duration buffs, timed summons, traps/sentries, and charge-up skills without manual screen capturing. (Manual region capture via 🎯 Custom Capture is also supported.)
    • ⭐ Recommended Presets & Common Buffs: Choosing a class automatically selects its core recommended buffs along with universal buffs ([CTA] Battle Command, [CTA] Battle Orders, and [Common] Enchant). Permanent summons and single-cast direct attacks are excluded so only duration-tracked skills appear in the list.
    • Inline Hotkey, Duration & Exclusive Group Setup with Duplicate Prevention: Assign hotkeys, durations (sec), and mutual exclusion groups (G1–G3 pre-assigned for Sorceress armors, Warlock masteries, Burst/Fade, etc.) right inside the preset dialog before batch-adding. Skills already present in the current profile are marked with an [Added] badge and unchecked automatically to prevent duplicate entries.
  • 📑 Multi-Profile Management: Create unlimited profiles for different characters or builds and switch between them on the fly in-game using PageUp / PageDown.
  • 🎯 Multi-Client Specific D2R Window Target:
    • When running 2+ Diablo II: Resurrected clients simultaneously via multi-loader (e.g., Main Character + Shout Barbarian / Enchant Sorceress), you can assign a [Target Window] for each buff skill in the skill settings dialog.
    • All Diablo Windows (Default): The hotkey activates the timer regardless of which D2R window is active.
    • Target Specific D2R Window: Choose a specific client from the list of running windows ([D2R #1], [D2R #2], or custom window titles). The buff timer will only trigger when that specific window is currently in the foreground (focused), completely preventing accidental buff triggers while controlling other game windows. In the skill list table, target window names are cleanly abbreviated (e.g. F1 (#1), F1 (#2:Sorc…)) to prevent text clipping while retaining full details in tooltips.
    • Smart Detection & Safe Fallback: Recently active clients are highlighted with a ⭐ (Recently Active) tag, and a refresh (🔄) button is provided. If the designated target client is closed or not found, DUO automatically falls back to all-window mode with an on-screen toast alert, ensuring you never miss a recast.
  • 🔀 Exclusive Buff Groups (Mutual Exclusion):
    • Group mutually exclusive skills that cannot be active simultaneously into dedicated groups (G1–G5), such as Sorceress Armors (Frozen / Shiver / Chilling Armor), Paladin Auras (Fanaticism / Holy Freeze / Conviction), Assassin Burst of Speed / Fade, or Necromancer Golems.
    • Activating any buff in a group will automatically and instantly cancel other running buff timers within the same group.
    • The Buff Manager table features a dedicated [Group] column with distinct colored badges ([G1], [G2], etc.) for viewing and reconfiguring grouped skills at a glance.
  • 🚨 Center Screen Countdown: Check important skills to trigger a flashing countdown right in the center of your screen when the buff is about to expire, ensuring you never miss a recast during intense fights.
  • 🔄 Smart Reset & Ignore System:
    • Auto-Reset: Automatically resets your buff timers upon entering or leaving a game.
    • Ignore Keys: Prevent accidental buff resets by registering keys like your inventory hotkey as ‘Ignore if Prev Key’.
  • 🎨 Highly Customizable: Adjust icon sizes, text sizes/positions, and formats. Assign custom audio files (.wav, .mp3) to individual skills using the sounds folder.

4. 🗺️ Region & Monster Tracking

Section titled “4. 🗺️ Region & Monster Tracking”
  • ⏱️ Region Entry & Statistics: Tracks the exact time spent in each area and compiles statistics. Provides a popup for the previous area’s time and links with the ‘Item Drop DB’ to analyze your most profitable farming spots.
  • 🎯 Multi-Client Specific D2R Window Target (Game State & Region Tracking):
    • When running multiple D2R clients simultaneously via multi-loader, you can designate a [Target Window] in Settings -> [📍 Area Settings].
    • All Diablo Windows (Default): Game enter/exit detection, area transitions, stay-time popups, and TTS announcements operate across all D2R windows.
    • Target Specific D2R Window: Select a specific client ([D2R #1], [D2R #2], or custom title) so that game enter/exit detection, area transitions, and stay-time tracking only run when that specific window is active (focused).
    • Preserves Buff Timers & Farming Stats: Completely prevents secondary account actions (e.g., buff barbs or chant sorceresses idling in the lobby or town) from accidentally triggering a lobby exit that would reset your main character’s buff timers, disrupt the speedrun timer, or contaminate farming statistics.
    • Smart Detection & Intuitive Calibration: Includes descriptive tooltips, recently active client tagging (⭐ (Recently Active)), a refresh (🔄) button, offline setting preservation ([Offline]), and automatically aligns mouse-drag calibration and coordinate preview with the selected target window.
  • 🗣️ Previous Area Stay Time Voice Alert (TTS): When moving between areas, DUO announces your previous area’s stay time via natural TTS audio (e.g., “The Chaos Sanctuary 2 minutes 35 seconds”) alongside the visual popup. Keep your eyes focused on gameplay while hearing your run times in real time. (Toggle and adjust volume in Settings -> Area Settings).
  • 🧭 Mini Guide Map: For areas with fixed exit generation rules, a mini-map pointing to the exit direction appears in the bottom right corner (Toggleable and display time configurable).
  • 👁️ Monster Attribute Alert (Warlock specific / Win 11 OCR): When hunting for specific attributes (e.g., for Bind Demon), DUO scans monster attributes on screen in real time and triggers visual popups and sound cues. (Operates using the Windows 11 Snipping Tool OCR engine, identical to Auto Item Recognition.)
  • 👑 Terror Zone Herald Spawn Alert & Counter (All Classes):
    • Real-time Automatic Herald Detection: Automatically detects Stages 1 to 5 Heralds (Fright, Dread, Fear, Horror, Terror) in real-time when hovering over monsters in Terror Zones, displaying an unobtrusive 1-line banner (e.g. [Herald Stage 5] (Total 5 | Stg5 2)) with a chime. (Multi-language support)
    • Available for All Character Classes: Unlike Warlock-only attribute alerts, Herald spawn alerts operate seamlessly across all character class profiles without restrictions.
    • Smart Duplicate Prevention: Prevents repeated chimes or duplicate counts during extended combat, kiting, or re-targeting the same herald.
    • Session Cumulative Statistics & Room Auto-Sync: Automatically resets room states on game enter/exit, and tracks total herald encounters and Stage 5 spawns across your session. Settings -> [👾 Monster OCR] tab provides dedicated toggle controls, display options, and a manual reset (↺) button.
  • 💎 Worldstone Terror Zone Tracking & Mini HUD:
    • Automatic Worldstone Act Detection: When using Worldstone items in town, DUO automatically scans active Terror Zone Acts (e.g. Act 2, Act 4) from the minimap text via OCR and tracks them in real time. (Full multi-language support: Korean, English, Traditional/Simplified Chinese)
    • Freely Draggable Mini HUD: Displays currently active Worldstone Acts and visit progress via a clean, compact HUD badge ([ 💎 Worldstone | Act 2 ✔ | Act 4 ❌ ]). Unlock overlay positions in Settings to drag it anywhere on screen. Supports an option to display exclusively in town so it never obscures combat fields.
    • Target Area Completion & Remaining Acts TTS Voice Alerts: Reaching an Act’s criteria hunting area (Catacombs L4, Tal Rasha’s Tomb/Chamber, Durance of Hate L3, Chaos Sanctuary, Throne of Destruction/Worldstone Chamber) triggers an instant clear announcement and lists remaining targets (e.g., “Act 4 cleared. Remaining: Act 2”) via natural TTS and on-screen popups, or celebrates when all target acts are complete.
    • Unvisited Act Reminder on Town Return / Area Transition / Game Exit: Leaving an act’s final hunting ground, returning to town from combat, or exiting the game with unvisited target Acts triggers a voice reminder (e.g., “Act 2 has not been visited yet.”), ensuring you never leave games with unused Worldstone acts. (Individually configurable)

5. ⏱️ Speedrun Timer

Section titled “5. ⏱️ Speedrun Timer”
  • 🔄 Game Enter/Exit Auto-Sync:
    • Auto Start & Lap Recording: When enabled in the Settings -> Timer tab, the timer automatically starts upon entering a game and stops/records your lap time upon exit. Seamlessly tracks consecutive runs without touching manual hotkeys.
    • Pause while in Town: Automatically pauses the timer while in town, starting when entering hunting grounds and pausing upon town return. Accurately benchmark pure field and boss combat clear times.
  • 📊 Record Comparison: Optimized for measuring clear time variations due to equipment swaps or build changes. It intuitively displays the time difference (+/-) from the previous run using color coding.
  • 📌 Real-time Statistics: Provides a clean, fixed-size UI that displays your current elapsed time alongside runs, average clear time, and your best record.

6. 📷 Gear & Skill Build Snapshot Manager

Section titled “6. 📷 Gear & Skill Build Snapshot Manager”
  • 🛡️ Comprehensive Slot-by-Slot Capture: Manage and capture your entire build setup by individual slots — Character Gear (12 slots: Helm, Armor, Main/Swap Weapons & Shields, Gloves, Belt, Boots, Amulet, Rings 1 & 2), Mercenary Gear (3 slots: Helm, Armor, Weapon), Charms, and Character Stats & Skill Trees (Tabs 1–4).
  • ⚡ Smart Auto & Drag Capture Modes:
    • ⚡ Auto Capture: Click ‘Auto’ on any slot, hover over the item in-game, and press Space to automatically detect and cleanly crop the item tooltip. (Cancel: ESC)
    • ⌨ Drag Capture: Click ‘Drag’ on any slot and press Space to open the drag selection window to manually capture any screen region. (Cancel: ESC)
  • 📜 Dynamic Custom Charms: Add, name, and manage unlimited custom charm slots (e.g., Sunder Charms, Hellfire Torch, Annihilus, Small Charms).
  • 🔍 OCR Item Dictionary & Traderie Sync: Click the 🔍 button on any captured gear/charm card to instantly recognize item stats via OCR, search in the DUO Item Dictionary, and check live market prices on Traderie with a single click.
  • 🖼️ Clean Batch Image Compositing & 1-Click Clipboard Copy:
    • 🛡️ Merge Gear & Charms: Automatically combines character gear, mercenary setup, and charms into a single clean 3-column vertical image.
    • 🌟 Merge Full Build: Merges your entire setup — gear, mercenary, charms, stats, and skill trees — into one comprehensive build snapshot image.
    • 📋 Copy to Clipboard: In addition to the final merged image, individual slot images (via the zoom preview dialog) can also be copied directly to your clipboard with one click for effortless sharing (Ctrl + V) in Discord and gaming communities.
  • 📂 Individual File Saving & Multi-Build Management:
    • Direct Folder Access: Click the 📂 Open Folder button to view and manage individual captured image files (.png) saved cleanly for each slot.
    • Multi-Build Management & Zoom Viewer: Create, clone, rename, and search multiple build setups. Click any card thumbnail to open a high-resolution viewer with smooth mouse drag panning.

7. 📋 Relay Game Name OCR Capture & Copy

Section titled “7. 📋 Relay Game Name OCR Capture & Copy”
  • ⚡ 1-Click High-Speed Game Name OCR & Copy:
    • During sequential relay runs (e.g., Baal-01, Chaos-02, Cow-03), press the hotkey (Shift + C) to instantly scan the top-right game name area via OCR and copy the room name directly to your clipboard.
    • An on-screen toast alert confirms the copied name (e.g., Game Name Copied : Cow-02) so you can visually verify the exact room name captured.
    • Simply paste (Ctrl + V) into the join lobby and increment the trailing number (+1) for seamless and rapid consecutive runs.
  • 🎯 Interactive Mouse Drag Area Selection:
    • In Settings -> [📍 Area Settings] -> [Game Name OCR Region], click 🎯 Select New Area with Mouse to easily calibrate the OCR detection box to match your display resolution and custom UI scaling by dragging directly on the game screen.
    • One-click reset restores the default recommended region (top-right 25% width, 8% height) at any time.
  • 🎛️ Pixel-Level Coordinate Tuning & Live Preview:
    • Fine-tune the detection box using X, Y, W, and H spinboxes, and visualize the scanning boundary via the real-time semi-transparent preview overlay.
  • ⌨️ Full Hotkey Customization:
    • Customize the hotkey to any key combination (default: Shift + C), or quickly reset (↺) or disable (✖) it via the dedicated UI controls.

8. 📊 Daily Farming Report & Live Farming Mini HUD

Section titled “8. 📊 Daily Farming Report & Live Farming Mini HUD”
  • ⏱️ Live Session Farming Mini HUD (⏱️ Farming HUD):
    • Real-Time In-Game Farming Dashboard: A compact, draggable overlay that displays your current session’s hunting pace, Terror Zone Herald encounters, and top drops right on the game screen without opening separate windows.
    • Row 1 — Top 2 Hunting Areas, Live Field Timer & Herald Counter:
      • Tracks your Top 2 most-farmed areas in the current session with completed run counts (12), average clear times (01:38), and a live elapsed timer (⏱00:45) while actively farming in a field (displays 🏰 Waiting in Town before your first run, and stacks 2+ areas vertically to keep horizontal width compact).
      • Displays a live session Terror Zone Herald counter (👾 Total (Stage 5)) on the right.
    • Row 2 — High-Value Drop Highlights (Equipment & Runes Separated):
      • Highlights your Top 2 high-tier session drops ([S+], [S], [A]), visually separated into Equipment (🏆 Shako (S)) and Runes (🔶 Jah x1) with tier-colored chips. Automatically collapses into a slim 1-row bar when no major drops have been logged yet.
    • 1-Click Toggle & Customization: Toggle anytime via the [⏱️ Farming HUD] button in Settings ([General], [📍 Area Settings], or [📈 Region Stats] tabs) or via a custom hotkey. Supports font size scaling (12px–36px), drag positioning, auto-hide in lobby, and OBS Stream Overlay capture.
  • 📈 Comprehensive Farming Infographic Card (Daily Farming Report):
    • Automatically aggregates your farming data over Today, Yesterday, Last 3 Days, or Last 7 Days into a sleek, Diablo-themed high-resolution infographic card image.
    • Accessible anytime via the system tray right-click menu [📊 Daily Farming Report], the buttons in Settings ([General] / [📈 Region Stats] tabs), or your custom hotkey.
  • ⏱️ Accurate Hunting & Lap Analytics:
    • Accurately isolates town downtime to measure pure field combat time, total runs, and average clear times.
    • Visualizes your most visited zones and clear times via clean horizontal ratio bars highlighting your Top 7 farming spots.
  • 🎁 Loot Value Tiers & Terror Zone Herald Summary:
    • Automatically evaluates scanned (Ctrl + T) items and assigns [S+], [S], [A], [B], [C] Tier Badges based on base rarity (High Runes, top Uniques, Sets, elite Bases) and roll perfection.
    • Toggle between [🏆 By Value] and [⏱️ By Time] sorting to highlight your most valuable drops (Jah/Ber runes, Shako, Griffon’s Eye, perfect rolls) right at the top of the report card.
    • Displays roll quality badges such as 👑 Perfect (100%) and 🟢 Top with key variable stats, and supports 1-click drop deletion (🗑️) to clean up duplicate/test scans.
    • Displays Terror Zone Herald encounters across all stages (1–5), highlighting Stage 5 Terror Herald spawns.
  • 📋 1-Click Clipboard Copy & Image Export:
    • Click [📋 Copy Image to Clipboard] to immediately copy the full report image to your clipboard for effortless pasting (Ctrl + V) into Discord, forums, and gaming communities.
    • Export clean PNG files anytime with [💾 Save Image to File] for archiving.

9. 📺 OBS Studio Streaming Support & UI Convenience

Section titled “9. 📺 OBS Studio Streaming Support & UI Convenience”
  • 🎥 Dedicated OBS Stream Overlay (Window Capture):
    • Enable OBS Stream Overlay in Settings to register a dedicated DUO - Stream Overlay window for OBS Studio [Window Capture].
    • All active overlays (Terror Zone, Uber Diablo, Buff Timers, etc.) are rendered 1:1 onto a single transparent canvas, providing a smooth, flicker-free stream overlay.
    • Maintains stable output on stream even when alt-tabbing or switching active applications.
  • 🖱️ Click-through: Mouse clicks pass right through the overlay, ensuring uninterrupted gameplay.
  • 🛡️ Administrator Privilege Detection & 1-Click Relaunch Helper: When Diablo II is running with administrator privileges (e.g., multi-loader), DUO automatically detects it and displays a prompt dialog. Click the [Restart as Administrator] button to elevate and restart DUO in one click without manually hunting down shortcuts.
  • 💬 Smart Chat Hotkey Block: Opening the chat window with Enter safely disables overlay hotkeys (buffs, item search) to prevent misclicks and accidental triggers.
  • 🔔 Smart Item Display Reminder: If you use the ‘Toggle Item Display’ option in-game and forget to turn it on after joining a room (especially with loot filters), a helpful reminder message will appear at the top of the screen.
  • 🔄 Free Layout & Auto-Update: Drag and drop panels anywhere. Enjoy seamless background updates with a simple 1-click update button.

💡 Custom Tips

Section titled “💡 Custom Tips”
  • Open Install Folder: Right-click the DUO icon in the system tray (bottom right) and select 📂 Open Install Folder to instantly access the directory. Use this convenient feature for the customizations below!
  • Custom Fonts: Place your font files inside the fonts folder located in the install folder, and they will be available for selection in the settings.
  • Custom Alert Sounds: Place your desired audio files (.wav, .mp3) inside the sounds folder to use them as custom alerts.
  • Profile Sharing & Backup: Copy the profiles folder within the install directory to easily back up your custom buff profiles or share them with others.
  • Build Snapshot Backup & Sharing: You can back up or share individual build folders inside the builds directory to keep or transfer your captured gear setups and composite images.

📂 File & Folder Descriptions

Section titled “📂 File & Folder Descriptions”

Structure inside your installation directory (C:\Users\<YourUsername>\AppData\Local\Programs\D2R Utility Overlay):

File / FolderDescription
DUO.exeMain executable file.
d2r_stats.dbSQLite database storing your region statistics and item drop history.
act_map.json⚠️ Essential TZ area level and Act data (Do not delete).
area.json⚠️ Essential TZ translation data (Do not delete).
d2r_overlay_config.jsonAuto-saved user preferences.
profiles/Folder containing your captured buff icons and skills.json.
builds/Folder containing gear/skill screenshots and build configuration data (build_info.json) per build.
sounds/Place your custom .mp3 or .wav files here for buff alerts.
item/data/Database files used for the item search dictionary.
fonts/Default built-in fonts. You can add your own font files here.
models/Folder where OCR modules required for all recognition features (items, monster attributes, areas, etc.) are stored.
assets\skill_icons\Built-in HD skill icons across all 8 classes and preset metadata (buff_presets.json) for the Buff Overlay.
assets\guides\Images used for displaying the mini guide map.
log/Folder where operational logs (.log) and debug/capture images are stored.

📝 Log Files (.log) Log files and debug/capture images are organized inside the log/ folder. You can easily open this folder anytime by right-clicking the system tray icon and selecting ”📁 Open Log Folder”. These files record the operational status of the program. When a file’s size grows, it is automatically backed up with a _backup suffix (e.g., app_debug_backup.log), while the latest information is continuously written to the .log file. If you encounter any issues, providing the log files and debug images inside the log/ folder when submitting an issue will enable much faster and more accurate analysis.

  • app_debug.log : Default overarching log file.
  • api_usage.log : d2tzinfo data request logs (Terror Zone, DClone).
  • ocr_debug.log : Text recognition (OCR) operation logs.
  • area_debug.log : Region name recognition operation logs.
  • monster_debug.log : Monster recognition operation logs.

⚖️ Third-Party Notices & Licenses:

  • This program dynamically links PySide6, which is licensed under LGPLv3.
  • On-screen text recognition (OCR) features interface with the Windows 11 built-in Snipping Tool OneOCR engine module.

💻 Tested Environment & Troubleshooting / FAQ

Section titled “💻 Tested Environment & Troubleshooting / FAQ”
  • OS: Windows 11 Pro 26H2 (64-bit)
  • Display: 2560x1440 (QHD)
  • Game: Diablo 2: Resurrected (Recommended: Fullscreen Mode)
  • Build: Python 3.12 (PySide6)

1. 🌐 Microsoft Edge “is not commonly downloaded” Warning

Section titled “1. 🌐 Microsoft Edge “is not commonly downloaded” Warning”

If Microsoft Edge or Windows SmartScreen blocks the download, it is simply because the file is newly released and has not yet built up a download reputation history with Microsoft. It is safe to bypass.

  1. Open the Edge download list (Ctrl + J).
  2. Click the three dots (…) next to the blocked file and select [Keep].
  3. In the pop-up warning, click [Show more] and then select [Keep anyway] to complete the download. (Easy Explanation: This is a preventative warning triggered because the software is from an independent developer. The file is safe, so you can confidently click ‘Keep anyway’ to proceed.)

2. 🖥️ For OLED / HDR Users (Tooltip Auto-Detection Issues)

Section titled “2. 🖥️ For OLED / HDR Users (Tooltip Auto-Detection Issues)”

If you are playing on a high-resolution OLED/HDR monitor and the automatic item detection consistently fails, it might be due to Windows HDR screen capture distortion making the item tooltip background too transparent for the OCR to read.

As a potential workaround, try going to your D2R In-game Settings -> Game Play -> Accessibility -> and enable “Large Font Mode”. This setting may increase the tooltip’s background opacity, which could significantly improve the text recognition contrast. While this has proven helpful for some users, please note that results may vary depending on your specific display configuration. (Easy Explanation: Due to how HDR rendering works, captured screenshots can sometimes make the item description background too see-through, blending the text into the game world. Enabling Large Font Mode thickens and darkens the background, making it much easier for the program to scan the text clearly.)

3. ✂️ OCR (Text Recognition: Items, Monster Attributes, etc.) Not Working (Snipping Tool Troubleshooting)

Section titled “3. ✂️ OCR (Text Recognition: Items, Monster Attributes, etc.) Not Working (Snipping Tool Troubleshooting)”

All on-screen text recognition (OCR) features in DUO—including Auto Item Recognition (Ctrl+R, Ctrl+T), Relay Game Name Capture (Shift+C), Monster Attribute Detection (Warlock utility), Area Entrance Detection, and Build Snapshot Gear OCR—share and rely on the modern Windows 11 Snipping Tool OCR engine.

💡 App Name Note: Depending on your Microsoft Store region and system environment, this app may be named ‘Snipping Tool’ or ‘Snip & Sketch’ (Korean: 캡처 도구 / 캡처 및 스케치). Both refer to the exact same application, so keep this in mind when searching or uninstalling.

❓ Why Text Recognition Fails Even on a Fresh/Clean Windows 11 Install

Section titled “❓ Why Text Recognition Fails Even on a Fresh/Clean Windows 11 Install”
  • Early Bundled Version Lacks OCR: Even after a fresh clean install of Windows 11, or when PowerShell reports version 11, the pre-installed version bundled with Windows is often an early build from before Microsoft introduced the OCR (text actions/extraction) engine. (A specific modern build of Snipping Tool is required for the OCR engine to function.)
  • No “Update” Option in Microsoft Store: When an older pre-installed version is already registered in the system, the Microsoft Store page often only displays an [Open] button instead of an [Update] button, preventing it from updating automatically.
  • The Solution: You must completely uninstall the existing app first, and then reinstall it from the Microsoft Store. This forces the Store to deliver the newest build containing the full OCR engine.

💡 Quickest & Recommended Solution: Uninstall and Reinstall from Microsoft Store

Section titled “💡 Quickest & Recommended Solution: Uninstall and Reinstall from Microsoft Store”

When recognition errors occur, uninstalling the existing app and reinstalling it from the Store will immediately resolve the issue in nearly all cases without needing complex configuration.

  1. Uninstall Existing App (Most Critical):
    • Right-click the Windows [Start] button -> open [Installed apps] (or Control Panel / Settings -> Apps -> Installed apps).
    • Search for ‘Snipping Tool’ or ‘Snip & Sketch’ in the list.
    • Click the three dots (…) button and select [Uninstall] to completely remove it from your system.
  2. Reinstall Latest Version from Store:
  3. Restart DUO & Verify:
    • Once reinstalled, relaunch DUO and test if Item Recognition and Monster Attribute Detection work properly.

🔍 Reference: Check Snipping Tool Version via PowerShell

Section titled “🔍 Reference: Check Snipping Tool Version via PowerShell”

If recognition still fails or you want to technically verify your installed Snipping Tool package, you can run the following check:

  1. Search for PowerShell in Windows search and open it.
  2. Enter the command:
    Terminal window
    (Get-AppxPackage -Name Microsoft.ScreenSketch).InstallLocation
  3. Review Output:
    • If the output path displays version 10 (e.g., 10.xxx...) instead of 11, an outdated Windows 10 package is still present.
    • Even if the path displays version 11, if recognition fails, it is an early build lacking OCR support or corrupted package files. Follow the [Uninstall and Reinstall] steps above.

(Easy Explanation: Even if you just cleanly installed Windows 11, the default Snipping Tool bundled with it may be an outdated version that cannot read text. Because the Microsoft Store won’t show an “Update” button while the old version is installed, you must first uninstall ‘Snipping Tool’ (or ‘Snip & Sketch’) from [Installed apps] and then reinstall it from the Store to receive the latest OCR engine. The PowerShell command is only for secondary version reference.)

4. 👾 Auto Monster Attribute OCR / Detection Troubleshooting (FAQ)

Section titled “4. 👾 Auto Monster Attribute OCR / Detection Troubleshooting (FAQ)”

If the automatic monster attribute detection or popup/audio alert is not working properly, please review the following checklist:

  1. Windows 11 OS & Snipping Tool Updates (Most Critical):
    • All screen text recognition (OCR) features in DUO—both Item Recognition and Monster Attribute Detection—share the Windows 11 Snipping Tool OCR engine. If monster attributes are not being detected at all, please refer to the [✂️ 3. OCR Not Working (Snipping Tool Troubleshooting)] section right above to uninstall and reinstall your Snipping Tool.
  2. OCR Detection Area Settings:
    • Open Settings (Ctrl + Shift + S) -> [👾 Monster OCR] tab and verify that the detection region coordinates match your current display resolution and game layout.
    • If necessary, click 🎯 Select New Area with Mouse and drag across the top-center area of the screen where monster names and attributes appear to recalibrate coordinates.
  3. Overlapping Text / Overlay Interference (Screen Capture Method):
    • If other text or overlay UI elements (such as Terror Zone info banners) overlap within the capture box, OCR accuracy may degrade.
    • 💡 Recommended Tip: Set the Screen Capture Method to Capture Diablo Window Only in Settings. This captures only the clean game client window without any interference from external overlay layers.
  4. Required Attributes (*) & Min. Optional Attributes Setting:
    • In the attribute list, any attribute prefixed with an asterisk (*) (e.g. *Demon, *Cursed) is a strictly required condition that must match completely.
    • If the Min. Optional Attributes count is set higher than what the monster actually has, the alert will not trigger. (Set it to 0 if you only want alerts triggered by required attributes).
  5. Character Class in Active Buff Profile (Warlock Only):
    • Monster Attribute OCR is designed specifically for the Warlock class (‘Bind Demon’ skill utility). To eliminate unnecessary CPU overhead, detection only runs when the currently active Buff Profile is configured as Warlock (악마술사).
    • If a profile for another character class (e.g., Sorceress, Paladin) is active, monster detection automatically pauses. Please ensure your active buff profile’s class is set to Warlock.
    • 💡 Note (Herald Alerts Work for All Classes): Terror Zone Herald spawn alerts work universally across all character classes regardless of the active profile. If Herald alerts do not appear, please verify that the [Terror Zone Herald Spawn Alert] option is checked in Settings -> [👾 Monster OCR] tab.

(Easy Explanation: Make sure you are on Windows 11 with the capture region set to your screen, and try switching the capture method to ‘Capture Diablo Window Only’ to avoid overlay interference. Also check your required attributes (), optional count, and make sure your active buff profile belongs to a Warlock! Note that Terror Zone Herald alerts work for all classes at all times, so you only need to ensure the Herald alert option is enabled.)*

5. 👥 Overlay Not Working When Using Multi-Loader (Run as Administrator & Multi-Client Target Windows)

Section titled “5. 👥 Overlay Not Working When Using Multi-Loader (Run as Administrator & Multi-Client Target Windows)”

When using a multi-loader, the game is usually run with administrator privileges. In this case, you must also run this overlay program (DUO) as an administrator for it to work properly.

  • 💡 1-Click Relaunch Helper: DUO automatically detects when D2R runs with administrator privileges and displays a helpful prompt. Simply click [Restart as Administrator] in the dialog to elevate and restart immediately via UAC.
  • To run manually, right-click the DUO desktop shortcut and select ‘Run as administrator’. (⚠️ Note: Avoid checking ‘Run this program as an administrator’ permanently under Properties ➔ Compatibility, as Windows UAC policy will block ‘Run on Windows Startup’ at boot. Use DUO’s 1-click elevation button instead.)
  • 💡 Tailored Multi-Client Buff & Game State/Area Tracking Targets: When running multiple game clients (e.g., main char + buff barb), use the [Target Window] option in each skill’s settings dialog as well as the [Target Window] selector in the [📍 Area Settings] tab. Designating specific clients ensures that buff hotkeys, game enter/exit triggers, and area stay-time tracking only operate on your intended character, eliminating cross-window conflicts and premature buff resets.
  • 💡 Game Title Bar Disappears When Using Multi-Loader (Ctrl + T Hotkey Conflict):
    • Cause: Certain Diablo 2 multi-loader programs have a built-in hotkey assigned to Ctrl + T to toggle/hide the window title bar in windowed mode.
    • Notice: DUO does not contain any feature or code to remove or alter the game window’s title bar. When you press DUO’s default Item Tooltip Recognition hotkey (Ctrl + T), the multi-loader intercepts the same hotkey combination and toggles off the title bar.
    • Solution:
      1. Press Ctrl + T again to toggle the title bar back on via the multi-loader.
      2. To prevent hotkey interference, open the Item Search Dictionary (Ctrl + F) and rebind the Item Tooltip Recognition hotkey at the bottom-right from Ctrl + T to another key combination (e.g., Ctrl + G or Ctrl + E). (Easy Explanation: If the game is running with higher (administrator) privileges, the overlay app also needs the exact same privileges to display things on top of the game window and detect your hotkeys. DUO now detects this automatically and lets you relaunch with one click! Also, if your window title bar disappears, it is not caused by DUO, but by the multi-loader’s own title bar toggle shortcut (Ctrl + T). Pressing Ctrl + T again will restore it, or you can change DUO’s hotkey at the bottom of the Item Search window (Ctrl + F).)

6. 🛡️ Security & False Positives (Antivirus Blocks/Deletions)

Section titled “6. 🛡️ Security & False Positives (Antivirus Blocks/Deletions)”

This program uses the keyboard module to detect your in-game hotkeys. Although switching to a standard installer (.exe) distribution significantly reduces false positives, some antivirus software may still incorrectly flag and block its execution. (Easy Explanation: Intercepting keyboard input is a method frequently used by malicious programs, so it is a natural phenomenon for antivirus software to be suspicious and block it by default.)

🛡️ VirusTotal Pre-scan Verification: The distributed DUO_Setup.exe installer is thoroughly scanned against major antivirus engines to ensure clean execution and complete transparency. You can inspect the live results at VirusTotal Scan Report (Click).

If the program won’t run or the shortcut does not work, please try the following steps:

  1. Add to Exclusions (Recommended): Add the installation folder (C:\Users\<YourUsername>\AppData\Local\Programs\D2R Utility Overlay) to your antivirus exclusion/exception list.
  2. Keep the Default Path: Installing the program in the default AppData\Local directory helps reduce false positives, as it is a standard system directory for application data. It is recommended not to change this path.
  3. Disable Smart App Control: If you are using Windows 11, you may need to turn off Smart App Control if it blocks execution.
  4. Star the GitHub Repo: Leaving a Star ⭐ on this GitHub repository helps build the software’s reputation metric over time, which may help reduce false positives from reputation-based filters.

7. 🚀 “Run on Windows Startup” Not Working (Administrator Privileges & Task Manager FAQ)

Section titled “7. 🚀 “Run on Windows Startup” Not Working (Administrator Privileges & Task Manager FAQ)”

If DUO does not launch automatically when Windows boots even though [Run on Windows Startup] is enabled, please check the following causes and solutions:

❓ 1. Executable is Configured with “Run this program as an administrator” (Most Common)

Section titled “❓ 1. Executable is Configured with “Run this program as an administrator” (Most Common)”
  • Cause: Due to Windows UAC security architecture, Windows logon cannot display UAC prompts during startup. If an application is configured with “Run this program as an administrator” in its file Properties, Windows silently drops/blocks it from launching at boot without any warning.
  • 💡 Recommended Solution (Easiest & Best):
    1. Right-click DUO.exe in %LocalAppData%\Programs\D2R Utility Overlay\ (or its desktop shortcut) ➔ [Properties] ➔ [Compatibility] tab.
    2. Uncheck [Run this program as an administrator], then click Apply and OK.
    3. Re-enable [Run on Windows Startup] in DUO Settings.

    Q. D2R (or multi-loader) runs as admin. Will DUO still work if started with normal privileges?
    A. Yes, absolutely! DUO starts quietly in the system tray with normal privileges upon boot. When D2R is running with admin privileges, DUO automatically detects the permission mismatch and displays a 1-click [Restart as Administrator] prompt. Simply click the button to elevate smoothly on-demand, giving you both boot automation and effortless admin integration.

❓ 2. Always Running as Admin on Boot via Windows Task Scheduler

Section titled “❓ 2. Always Running as Admin on Boot via Windows Task Scheduler”
  • If you want DUO to start as Administrator immediately upon boot without any prompts, use Windows Task Scheduler (the only official method supported by Windows to bypass UAC at startup):
    1. Search for Task Scheduler in the Windows Start menu.
    2. Click Create Task in the Actions panel on the right.
    3. General tab: Name it DUO and check Run with highest privileges.
    4. Triggers tab: Click New ➔ Begin the task: At log on ➔ Click OK.
    5. Actions tab: Click New ➔ Action: Start a program, browse to DUO.exe (Default path: C:\Users\<YourUsername>\AppData\Local\Programs\D2R Utility Overlay\DUO.exe).
    6. Conditions tab: Uncheck Start the task only if the computer is on AC power (recommended for laptops) ➔ Click OK to save.

❓ 3. Disabled in Windows Task Manager Startup Tab

Section titled “❓ 3. Disabled in Windows Task Manager Startup Tab”
  • Cause: If DUO was disabled in the Windows Task Manager Startup tab, Windows stores a disabled flag in the registry (StartupApproved) and skips it during boot.
  • Solution: Press Ctrl + Shift + Esc (Task Manager) ➔ [Startup apps] tab ➔ Locate DUO (or D2R Utility Overlay) ➔ If the status is ‘Disabled’, right-click and select Enable.

☕ Contact & Support

Section titled “☕ Contact & Support”

💡 Bug Reports & Feature Requests (Feedback)

Section titled “💡 Bug Reports & Feature Requests (Feedback)”

If you encounter any bugs or have ideas for new features, please feel free to let me know using the methods below!

  • GitHub Issues (Recommended): Please leave a post on the GitHub Issues page (Click).
  • Email: You can always send an email to miabohoja1@gmail.com.

☕ Support (Donation)

Section titled “☕ Support (Donation)”

This program is 100% free to use for everyone! However, if you found this tool helpful for your gameplay and wish to support its ongoing development, you can optionally buy the developer a coffee. Your support is always greatly appreciated!

Buy Me a Coffee at ko-fi.com
D2RUO © 2026 by Vellen is licensed under CC BY-NC-ND 4.0

Credits: Data provided by D2TZ.info