mouseterm /

Filename Size Date modified Message
English.lproj
French.lproj
utils
33 B
832 B
506 B
574 B
4.3 KB
17.9 KB
185 B
2.4 KB
426 B
197 B
573 B
2.9 KB
124 B
980 B
1.2 KB
8.7 KB
1.7 KB
1.1 KB
207 B
5.3 KB
3.2 KB
813 B
410 B

MouseTerm

MouseTerm is a SIMBL plugin for Mac OS X's Terminal.app that passes mouse events to the terminal, allowing you to use mouse shortcuts within applications that support them.

To get started, first install SIMBL (MouseTerm won't work without it!). Once you've done that, open the .dmg file, run Install, and restart Terminal.app. To uninstall, run Uninstall from the .dmg.

Download

Status

MouseTerm is currently alpha quality software. Some features have not yet been implemented, and there may be bugs in the current implementation.

What works:

  • Mouse button reporting.
  • Mouse scroll wheel reporting.
  • Simulated mouse wheel scrolling for programs like less (i.e. any fullscreen program that uses application cursor key mode).

What's being worked on:

  • A preferences dialog and terminal profile integration.

Frequently Asked Questions

What programs can I use the mouse in?

This varies widely and depends on the specific program. less, Emacs, and Vim are good places to test out mouse reporting.

How do I enable mouse reporting in Vim?

To enable the mouse for all modes add the following to your ~/.vimrc file:

if has("mouse")
    set mouse=a
endif

Run :help mouse for more information and other possible values.

What about enabling it in Emacs?

By default MouseTerm will use simulated mouse wheel scrolling in Emacs. To enable terminal mouse support, add this to your ~/.emacs file:

(unless window-system
  (xterm-mouse-mode 1)
  (global-set-key [mouse-4] '(lambda ()
                               (interactive)
                               (scroll-down 1)))
  (global-set-key [mouse-5] '(lambda ()
                               (interactive)
                               (scroll-up 1))))

Development

Download the official development repository using Git:

git clone git://github.com/brodie/mouseterm.git

Run make to compile the plugin, and make install to install it into your home directory's SIMBL plugins folder. make test will install the plugin and run a second instance of Terminal.app for testing.

Visit GitHub if you'd like to fork the project, watch for new changes, or report issues.

JRSwizzle and some mouse reporting code from iTerm are used in MouseTerm. Ragel is used for parsing control codes.

Contact

Contact information can be found on my site, brodierao.com.

Thanks to Tom Feist and Scott Kroll for their contributions.

Tip: Filter by directory path e.g. /media app.js to search for public/media/app.js.
Tip: Use camelCasing e.g. ProjME to search for ProjectModifiedEvent.java.
Tip: Filter by extension type e.g. /repo .js to search for all .js files in the /repo directory.
Tip: Separate your search with spaces e.g. /ssh pom.xml to search for src/ssh/pom.xml.
Tip: Use ↑ and ↓ arrow keys to navigate and return to view the file.
Tip: You can also navigate files with Ctrl+j (next) and Ctrl+k (previous) and view the file with Ctrl+o.
Tip: You can also navigate files with Alt+j (next) and Alt+k (previous) and view the file with Alt+o.