mouseterm /

Filename Size Date modified Message
834 B
506 B
574 B
4.2 KB
17.9 KB
1.4 KB
1.7 KB
424 B
4.3 KB
2.7 KB
8.2 KB
410 B

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

No configuration is necessary, just open the `.dmg` file, run `Install`, and
restart To uninstall, simply run `Uninstall` from the `.dmg`.
No configuration is necessary, just install SIMBL and move



[MouseTerm.dmg][3] (80 KB)



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 scroll wheel reporting.
* Simulated mouse wheel scrolling for programs like `less` (i.e. any
  fullscreen program that uses [application cursor key mode][4]).

What's being worked on:

* Reporting for other mouse buttons.
* `xterm` "hilite" mouse tracking mode.
* 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][5],
and [Vim][6] 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

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:

    (xterm-mouse-mode 1)
    (mouse-wheel-mode 1)
    (global-set-key [mouse-4] '(lambda ()
                                 (scroll-down 1)))

    (global-set-key [mouse-5] '(lambda ()
                                 (scroll-up 1)))



Download the official development repository using [Mercurial][7]:

    hg clone

Run `make` to compile the plugin, and `make install` to install it into
your home directory's SIMBL plugins folder. Run `make` and `make builddmg`
to create a disk image of the application.

[JRSwizzle][8] and some mouse reporting code from [iTerm][9] are used in