`Shift+M` to toggle mouse capture for native text selection

[toobuntu]

On terminals such as macOS Terminal.app no modifier key bypasses mouse reporting — making native text selection impossible while leaf is running.

A Shift+M shortcut that issues DisableMouseCapture / EnableMouseCapture would let users pause mouse reporting, perform a selection with the terminal's native drag behavior, then resume. This is the keyboard-driven mode-switch pattern tmux uses, and should work uniformly across all terminal emulators.

Proposed behavior:

• Shift+M (normal view only, not inside popups) toggles crossterm mouse capture off/on
• A status-bar indicator (e.g. [mouse off]) while capture is disabled

[RivoLink]

Hi,
Thanks for your feedback.

According to #123, if shift+drag doesn't work, option+drag can be used as an alternative.

Let me know if that doesn't work for you.

[toobuntu]

Yes, it works for me in iTerm2. The issue I raised in #173 is that it is not documented. Or, rather, that the documentation specifies Shift, which doesn't work on iTerm2 (needs Option/Alt) or Terminal.app (no solution yet). There is still no solution for Terminal.app, however. This feature proposal aims to solve that.

[RivoLink]

Okay, I'll think about Shift+M

For the shortcut in #173, I think it's the same to:

• leave Shift+Select in the help modal and add documentation for Option+Select in the README, or
• use Shift/Alt in the help modal and add documentation in the README explaining that Shift/Alt means Shift+Drag or Alt+Drag.

[RivoLink]

I don't think either of these is the right solution.

[toobuntu]

Agreed. The 11 character limit in the help modal make it challenging. I thought about modify+sel, but that's probably less clear for the many (most) users who can use Shift. I actually liked Copilot's idea there to adjust the description column to “select text (drag)”. But I think Shift+M is still a good idea if it allows selection in Terminal.app.

[RivoLink]

Hi,
Sorry for the late reply.
I added the Shift+M shortcut to toggle mouse capture.
Thanks for your suggestion.

[toobuntu]

Thanks!