Skip to content

UI_MOCKUP.md

Latest commit

 

History

History
122 lines (104 loc) · 6.77 KB

UI_MOCKUP.md

File metadata and controls

122 lines (104 loc) · 6.77 KB

Binary Ninja Debugger UI Mockup - Bookmark Feature

Main Debugger Sidebar Layout

┌─────────────────────────────────────────────────────────────┐
│ Debugger                                              [×]    │
├─────────────────────────────────────────────────────────────┤
│                                                             │
│ ┌─ Debug Controls ─────────────────────────────────────────┐ │
│ │ [▶] [⏸] [⏹] [📄] [🔄]    [Launch] [Attach] [Connect]    │ │
│ │  Play Pause Stop Step  Restart                          │ │
│ └─────────────────────────────────────────────────────────┘ │
│                                                             │
│ ┌─ Tab Controls ──────────────────────────────────────────┐ │
│ │ [Registers] [Breakpoints] [Bookmarks]                   │ │
│ └─────────────────────────────────────────────────────────┘ │
│                                                             │
│ ┌─ Bookmarks Tab ─────────────────────────────────────────┐ │
│ │ Description        │ TTD Position │ Address    │ Time   │ │
│ │ ──────────────────────────────────────────────────────  │ │
│ │ Main entry point   │ 12A:B4       │ 0x401000   │ 14:30  │ │
│ │ Critical section   │ 15C:A2       │ 0x402500   │ 14:35  │ │
│ │ Before API call    │ 18F:DC       │ 0x403100   │ 14:42  │ │
│ │ Exception handler  │ 1A2:3F       │ 0x404800   │ 14:48  │ │
│ │ Loop iteration 5   │ 1C8:91       │ 0x402200   │ 14:52  │ │
│ │                    │              │            │        │ │
│ │ [Add Bookmark...]  [Remove]  [Jump To]                 │ │
│ └─────────────────────────────────────────────────────────┘ │
│                                                             │
└─────────────────────────────────────────────────────────────┘

Context Menu (Right-click on bookmark)

┌────────────────────────┐
│ ▶ Jump To Bookmark     │
│ ─────────────────────  │
│ ✎ Edit Description...  │
│ 🗑 Remove Bookmark     │
│ ─────────────────────  │
│ 📋 Copy Address        │
│ 📋 Copy TTD Position   │
└────────────────────────┘

Add Bookmark Dialog (Ctrl+M or menu action)

┌────────────────────────────────────────────┐
│ Add Bookmark                         [×]   │
├────────────────────────────────────────────┤
│                                            │
│ Current Position:                          │
│   Address: 0x401000                        │
│   TTD Position: 12A:B4                     │
│                                            │
│ Description:                               │
│ ┌────────────────────────────────────────┐ │
│ │ Main function entry point              │ │
│ └────────────────────────────────────────┘ │
│                                            │
│              [Cancel]    [Add Bookmark]    │
└────────────────────────────────────────────┘

Main Menu Integration

Debugger Menu:
├─ Debug Adapter Settings...
├─ ──────────────────────────
├─ Launch                    F6
├─ Attach To Process...
├─ Connect to Debug Server
├─ ──────────────────────────
├─ Pause                     F5
├─ Resume                    F9
├─ Go Backwards         Shift+F9
├─ ──────────────────────────
├─ Toggle Breakpoint         F2
├─ Add Bookmark         Ctrl+M  ← NEW!
├─ ──────────────────────────
└─ Settings...

Key Features Demonstrated:

  1. Integrated Tab Layout: Bookmarks appear as a natural third tab alongside Registers and Breakpoints

  2. Comprehensive Information: Each bookmark shows:

    • User-friendly description
    • TTD position for time-travel navigation
    • Memory address for fallback navigation
    • Timestamp for organization

  3. Multiple Access Methods:

    • Direct tab access for bookmark management
    • Global Ctrl+M shortcut for quick bookmark creation
    • Context menu for bookmark operations

  4. Visual Consistency: Follows existing Binary Ninja debugger UI patterns:

    • Same table layout as breakpoints
    • Consistent button styling and placement
    • Standard dialog patterns

  5. User-Friendly Workflow:

    • One-click bookmark creation
    • Double-click navigation
    • Clear visual feedback and organization

Navigation Behavior:

When double-clicking a bookmark or using "Jump To Bookmark":

  1. TTD Navigation: Attempts !tt 12A:B4 command to set TTD position
  2. Fallback Navigation: If TTD fails, navigates to memory address
  3. Visual Feedback: Updates main view to show bookmarked location
  4. Error Handling: Shows informative messages if navigation fails

This provides a complete time-travel bookmark system that integrates seamlessly with the existing Binary Ninja debugger interface.