Keyboard Shortcuts

EMULE_KEYBOARD_SHORTCUT: this document records deliberate app-level keyboard ownership for the native MFC shell. Update it with code changes that add, remove, or repurpose shortcuts.

Reserved App Shortcuts

Shortcut	Owner	Behavior
Alt+X	main shell	Cleanly exits through CemuleDlg::OnClose() and respects Prompt on exit.
Alt+U	main shell	Opens the existing floating hotmenu.
Alt+T	main shell	Opens the Tools popup.
Alt+O	main shell	Opens Options.
Ctrl+Tab / Ctrl+Shift+Tab	main shell	Cycles primary toolbar panes.

Searchable List Shortcuts

These shortcuts are inherited by searchable list controls such as client, queue, upload, download, server, search-results, and shared-files lists.

Shortcut	Behavior
Ctrl+F	Starts list find.
F3	Finds the next match after list find is active.
Shift+F3	Finds the previous match after list find is active.
Ctrl+A	Selects all rows in the focused list.

File-Like List Sort Shortcuts

Downloads, Search Results, and Shared Files support Total Commander-style sort shortcuts when the relevant list has focus.

Shortcut	Behavior
Ctrl+F3	Sorts by name.
Ctrl+F4	Sorts by type where the list has a type column.
Ctrl+F5	Sorts by date/time where the list has a date/time column.
Ctrl+F6	Sorts by size.

Repeating the same shortcut toggles ascending and descending order through the same path as clicking the column header. If a list does not have the requested semantic column, the shortcut is consumed with a native beep and no fallback sort is guessed. If the matching column is currently hidden, the shortcut is also consumed with a native beep instead of changing the visible list order through a hidden sort key. Downloads currently has no type column, and Search Results currently has no date/time column.

Downloads List Shortcuts

These shortcuts are local to the Downloads file list. They operate on the selected downloads and do not become global app accelerators.

Shortcut	Behavior
Ctrl+P	Pauses selected downloads that can be paused.
Ctrl+S	Resumes selected downloads that can be resumed.
Ctrl+T	Stops selected downloads that can be stopped.
Ctrl+Shift+P	Pauses all pausable downloads in the current category.
Ctrl+Shift+S	Resumes all resumable downloads in the current category.
Ctrl+Shift+T	Stops all stoppable downloads in the current category.
Ctrl++ / Ctrl+-	Raises or lowers selected download priority one manual step.
Ctrl+Shift++ / Ctrl+Shift+-	Sets selected download priority to High or Low.
Ctrl+O	Opens the selected completed download when it can be opened.
Ctrl+Shift+O	Opens the selected download's folder.
Ctrl+I	Opens details for the selected download rows.
Ctrl+L	Copies selected download ED2K links.
Ctrl+Shift+C	Copies selected download file summaries.
Delete / Canc	Cancels selected active downloads after confirmation; removes completed downloads from the visible list.
Shift+Delete / Shift+Canc	Cancels selected downloads without confirmation, using the same completed-file path as the Cancel command.
F2	Renames one selected incomplete download; Ctrl+F2 runs filename cleanup.
Enter	Opens the selected completed download when it can be opened.
Alt+Enter	Opens details for the selected download rows.
Ctrl+C	Copies selected download ED2K links.
Ctrl+V	Pastes a direct ED2K download link when available.

Search Results List Shortcuts

These shortcuts are local to Search Results.

Shortcut	Behavior
Ctrl+D	Downloads selected search results.
Ctrl+Shift+D	Downloads selected search results paused.
Ctrl+I	Opens details for selected results.
Ctrl+L	Copies selected result ED2K links.
Ctrl+Shift+C	Copies selected result summaries.
Ctrl+F	Starts list find.

Shared Files Shortcuts

These shortcuts are local to the Shared Files list.

Shortcut	Behavior
Ctrl+O	Opens the selected shared file.
Ctrl+Shift+O	Opens the selected shared file's folder.
Ctrl+I	Opens details for selected shared files.
Ctrl+L	Copies selected shared-file ED2K links.
Ctrl+Shift+C	Copies selected shared-file summaries.
Ctrl+F	Starts list find.
F5	Reloads the shared-files list.
F2	Renames the selected shared file through the existing rename action.
Delete	Runs the existing Delete action for selected shared files.

Shared Directories Shortcuts

These shortcuts are local to the Shared Directories tree.

Shortcut	Behavior
Ctrl+Shift+O	Opens the selected directory.

Shared Directories intentionally keeps keyboard ownership tree-native. File details and ED2K copy shortcuts are handled by the Shared Files list, where the file selection is visible.

File Copy Menus

The Downloads, Search Results, and Shared Files context menus expose a Copy submenu for power users. Direct shortcuts remain conservative: Ctrl+L copies plain ED2K links and Ctrl+Shift+C copies the summary line where summaries are supported.

Menu-only Copy actions include:

Context	Additional Copy Fields
Downloads	size, status, progress, file path, folder path, plain ED2K, HTML ED2K, file summary
Search Results	size, type, plain ED2K, HTML ED2K, result summary
Shared Files	size, file path, folder path, plain ED2K, HTML ED2K, file summary

Reserved Main-Shell Mnemonics

These native Alt mnemonics are treated as main-shell toolbar or hotmenu ownership and should not be reused by modeless child panes:

Alt+C, Alt+K, Alt+V, Alt+T, Alt+S, Alt+F, Alt+M, Alt+I, Alt+A, Alt+O, Alt+H, Alt+U, Alt+X.

Search Pane Mnemonics

When Search is the active main pane, the Search parameter bar owns:

Shortcut	Behavior
Alt+N	Focuses the Name textbox.
Alt+Y	Focuses Type.
Alt+D	Focuses Method.
Alt+G	Activates Search Go.
Alt+E	Activates More.
Alt+R	Activates Reset.
Alt+L	Activates Cancel.

Search Pane Navigation

Shortcut	Behavior
F6	Toggles focus between the Search Name textbox and the search results list.

Mnemonic Policy

• EMULE_KEYBOARD_SHORTCUT: do not reassign Alt+X; it is the direct app-exit mnemonic.
• The old hidden hotmenu Alt+X button was retired; floating hotmenu ownership is now Alt+U, and Tools ownership is Alt+T.
• Search-local mnemonics deliberately avoid the reserved main-shell letters.
• Shortcut reference stays in this document; do not duplicate it in a Tools menu dialog.
• Modal dialogs keep local keyboard behavior. The app-level shortcuts are for the main shell and its primary modeless UI.
• Localized .rc files are not normalized in this pass; default English resources define the reviewed policy.

Manual Verification

• With Prompt on exit disabled, Alt+X should enter the normal shutdown progress path.
• With Prompt on exit enabled, Alt+X should show the existing confirmation before shutdown.
• Alt+U should open the floating hotmenu.
• Alt+T should open the Tools popup.
• Alt+O should open Options.
• In Downloads, Ctrl+Shift+P, Ctrl+Shift+S, and Ctrl+Shift+T should act on the current transfer category, even when no row is selected.
• In Downloads, Ctrl++, Ctrl+-, Ctrl+Shift++, and Ctrl+Shift+- should update selected download priorities without changing unrelated rows.
• In Search, Alt+N should focus the Name textbox without selecting existing text.
• In Search, Alt+Y, Alt+D, Alt+G, Alt+E, Alt+R, and Alt+L should drive Type, Method, Search Go, More, Reset, and Cancel through local native mnemonic behavior.
• In Search, F6 should move focus between the Name textbox and the search results list.
• In searchable lists, Ctrl+F, F3, and Shift+F3 should start find and navigate matches without changing transfer state.
• In Shared Files, F5 should reload the shared-files list through the same path as the existing reload button.
• In Shared Files, the context menu should show native hints for F2 rename and Delete.
• Outside Search, Alt+N should not switch panes or steal focus.
• Preferences, About, and confirmation dialogs should retain their normal local keyboard handling.