Skip to content

[app] Improve UI usability, tooltips, and keyboard access - #288

Draft
Breakthrough wants to merge 1 commit into
issue-289from
ui-usability-pass
Draft

Breakthrough wants to merge 1 commit into
issue-289from
ui-usability-pass

Conversation

@Breakthrough

@Breakthrough Breakthrough commented Nov 20, 2026 •

Copy link
Copy Markdown
Owner

Improve usability, tooltips, visual consistency, and keyboard access across the GUI (dvr-scan-app).

Stacked on #290 (Windows MenuBar fix for #289) so the two PRs have no merge conflicts.

Summary of Changes

Tooltips and Help Shortcuts (common.py)

  • Move Tooltip to dvr_scan/app/common.py and add tooltips across settings controls.
  • Show tooltips on both mouse hover and keyboard focus. Hide tooltips when a widget unmaps, and keep tooltips within the screen bounds.
  • Bind F1 to open the Help Guide. Use https:// for all help and website URLs.

Scan Wizard and Video List (wizard.py, video_list.py)

  • Increase drop-zone hint contrast to meet WCAG 2.1 AA (>= 4.5:1).
  • Draw a solid border on the input area in the DVR-Scan brand color (#59606d). Match the video list focus border to the same color.
  • Allow keyboard activation of the drop zone (Tab, Enter, Space) and keyboard selection in the video list (Up, Down, Shift+Up, Shift+Down, Home, End).
  • Scroll the video list automatically to keep the active row in view.
  • Keep sort radio checkmarks in sync between the toolbar menu and File -> Sort.
  • Add descriptions for each output mode in Step 3. Make the output folder path selectable (readonly).
  • Arrange Step 4 (Review & Scan) as a two-column summary table.
  • Add Alt+Left and Alt+Right step shortcuts. Move keyboard focus to the active step when changing steps.
  • Show next-step guidance in Step 5 when a scan finds zero motion events.

Advanced Mode and Settings Dialogs (application.py, widgets.py, __main__.py)

  • Span InputArea across all grid columns and stretch the Path column.
  • Reduce the initial input table height from 10 rows to 4 rows so the main window fits on smaller displays.
  • Show a clickable hint in the empty input table. Enable Remove, Move Up, and Move Down only when valid for the current selection.
  • Sort the Framerate column numerically instead of alphabetically.
  • Disable Open folder on completion when Scan Only is selected.
  • Show a warning or error dialog when starting a scan with no videos or with Start Time >= End Time.
  • Add Ctrl+O (Add Videos) and Ctrl+Enter (Start Scan) shortcuts.
  • Replace tk labels, entries, and buttons in settings dialogs with left-aligned ttk controls. Add 1px borders to ColorPicker swatches.
  • Bind Escape to close modal dialogs. Set parent on all file, color, and message dialogs.
  • Fix --debug in dvr-scan-app so it does not override debug = yes in dvr-scan.cfg.

Region Editor, Scan Window, and About Dialog (region_editor.py, scan_window.py, about_window.py)

  • Add + Add, Delete, Frame counter, Toggle Mask, and Controls... controls to the Region Editor bottom bar.
  • Change View -> Mask Mode and Antialiasing to checkbutton menu items. Add dark borders around polygon handles.
  • Fix a Ctrl+N crash when the pointer is outside the canvas. Show an error dialog when a region file cannot be read.
  • Fix the scan progress bar stopping below 100% when frame-skip > 0. Clamp remaining time at 00:00 on variable framerate inputs.
  • Add an Open Output Folder button and a zero-events message to ScanWindow.
  • Replace the website text label in the About dialog with Website and Report Issue buttons.
  • Clear the clipboard before copying text in the About dialog and Region Editor. Allow Tab and Shift+Tab to move focus out of read-only text boxes.

Verification

  • Passed ruff format --check and ruff check.
  • Passed pytest (388 passed, 4 skipped).
  • Verified all windows and dialogs on Windows 11 with zero widget overflows and zero Tcl bgerrors.

@Breakthrough Breakthrough changed the title [app] Design, usability, and accessibility pass across UI [app] Improve UI usability, keyboard access, and menu behavior Nov 21, 2026
@Breakthrough
Breakthrough force-pushed the ui-usability-pass branch 2 times, most recently from ecedae0 to 1dafb70 Compare November 21, 2026 01:15
@Breakthrough Breakthrough changed the title [app] Improve UI usability, keyboard access, and menu behavior [app] Improve UI usability, tooltips, and keyboard access Nov 21, 2026
@Breakthrough
Breakthrough changed the base branch from main to issue-289 November 21, 2026 01:15
@Breakthrough
Breakthrough added this pull request to stack #291 November 22, 2026 00:55
Update the Scan Wizard, Advanced Mode, Region Editor, Scan Window, and
About dialog:

- Move Tooltip to common.py. Show tooltips on both mouse hover and
  keyboard focus, hide tooltips on widget unmap, and keep tooltips
  within screen bounds. Add tooltips across settings controls.
- Use a solid DVR-Scan slate border (#59606d) on the Scan Wizard input
  area and video list focus ring. Increase drop-zone text contrast.
- Add keyboard navigation to the Scan Wizard drop zone (Tab, Enter,
  Space), video list (arrow keys, Shift+arrow, Home, End), and wizard
  steps (Alt+Left, Alt+Right). Bind F1 to open the Help Guide.
- Replace legacy tk controls with ttk controls. Left-align form labels,
  add 1px borders to color swatches, and bind Escape to close dialogs.
- Stretch the Path column and reduce the default input table height in
  Advanced Mode so the window fits smaller screens.
- Show message dialogs when starting a scan with no videos or an invalid
  start/end time range.
- Add Region Editor toolbar buttons to add and delete shapes, show the
  frame number, and add dark borders to polygon handles. Fix a Ctrl+N
  crash when the pointer is outside the canvas.
- Fix scan progress tracking when frame-skip is set, and clamp remaining
  time at 00:00. Show guidance when a scan finds zero motion events.
- Clear the clipboard before copying text, use https:// for help URLs,
  and set the parent window on all child dialogs.

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Windows menu bar does not switch open menus on hover

1 participant