vercel/hyper

Hyper doesn't correctly support mouse mode in tmux 2.5

Open

#2020 opened on Jul 20, 2017

View on GitHub
 (46 comments) (33 reactions) (0 assignees)TypeScript (44,582 stars) (3,558 forks)batch import
help wanted

Description

  • I am on the latest Hyper.app version
  • I have searched the issues of this repo and believe that this is not a duplicate
  • OS version and name: OSX 10.12.5
  • Hyper.app version: Version 1.3.3 (1.3.3.1754)
  • Link of a Gist with the contents of your .hyper.js: Vanilla install, no customisation.
  • Relevant information from devtools (CMD+ALT+I on Mac OS, CTRL+SHIFT+I elsewhere): N/A
  • The issue is reproducible in vanilla Hyper.app: Is Vanilla

Issue

Mouse mode in tmux 2.5 (stable) does not appear to function.

Steps to reproduce (from clean install of all tools)

  1. Install Hyper
  2. Install tmux via brew install tmux
  3. Configure tmux to use mouse mode by echo "set -g mouse on" >> ~/.tmux.conf
  4. Run tmux
  5. Inside a tmux session run tmux split-window

Expected behaviour

You should be able to use the mouse to select which pane within the tux session is active.

Actual behaviour

No effect. It does not allow mouse interaction with panes in tmux, and no obvious logging is produced within Hyper to indicate an error.

I've validated this functions as expected in Terminal.app and iTerm with same config and installation steps.

Contributor guide

Tech stack
typescripthtmlcssnodejselectron
Domain
desktopcli
Issue type
bug
DifficultyEstimated implementation difficulty for a new contributor, from 1 for very small changes to 5 for expert-level work.
3
Estimated timeA rough time range for an experienced contributor to investigate, implement, test, and prepare a pull request.
half day
Activity statusHow available the issue appears right now: fresh, active, stale, blocked, or waiting on maintainer input.
stale
ClarityHow clearly the issue explains the expected change, acceptance criteria, and next step.
clear
Prerequisites
Basic terminal emulator conceptstmuxJavaScriptTypeScript
Newbie friendlinessA 1-100 score estimating how approachable this issue is for first-time contributors.
40
Research direction
Investigate how Hyper integrates with xterm.js for mouse events. Check the Hyper source code, particularly files related to terminal rendering (e.g., `src/term.ts` or `src/session.ts`). Review comments in the issue for any previous debugging insights. Test with different tmux versions and configurations to isolate the issue. Consider if the problem lies in xterm.js mouse mode settings or in Hyper's event forwarding to the tmux process.