Skip to content


Subversion checkout URL

You can clone with
Download ZIP
ResidualVM main repository
C++ C Assembly Objective-C Perl Java Other
branch: mouse

This branch is 76 commits ahead, 952 commits behind residualvm:master

Failed to load latest commit information.
audio ALL: synced with ScummVM
backends android control update
base android cursors
common android control update
devtools CREDITS: updates
dists android control update
doc GRIM: Rewrite Patchr
engines android control update
graphics support worldToScreen() and raycast() with opengl shaders
gui MAC build script, correct version
hs pf.set
icons ICON: added svg version
image ALL: synced with ScummVM
math support worldToScreen() and raycast() with opengl shaders
po ALL: sync with scummvm
script android control update
test MATH: Add a selectable Euler Order to Rotation3D.
video BINK: Fix #863, seeking to frame 0 triggers an assertion
zlib added zlib sources
.gitignore start android support, remove zlib option
COPYING sync with scummvm
COPYING.BSD COMMON: added missing BSD license since mpeg video code use it
COPYING.FREEFONT synced with scummvm
COPYING.ISC GRIM: Add the ISC license for .patchr files
COPYING.LGPL ALL: mention plib and portalib3d in the license file
COPYING.LUA JANITORIAL: cleanup licences
COPYRIGHT ALL: update year headers
Makefile disable -lpng in Makefile
Makefile.common add mouse.lab to apk
NEWS ALL: update year headers
README updated readme
README.ResidualVM patches / scripts
TODO ALL: synced with scummvm
config.guess sync with scummvm
config.sub sync with scummvm
configure updated build scripts
plugin.exp added missing plugin.exp file updated build scripts ALL: sync with scummvm
run added dialog arrows (issue #26), fixed sh (issue #29)
up android scroll -> walk, relocated game data
upess inventory


Grim Mouse
A point-and-click interface for Grim Fandango 
Version 0.7

Executables and instructions are available at

Source code is available at:

What is this ?
Grim Mouse allows to play 'Grim Fandango' like a point-and-click adventure, 
instead of the original tank-style keyboard controls.
The mod is based on the ResidualVM game engine, which means it will also run on
Mac and Linux, not only on Windows as the original game.

* Important note *
Please note that as the game was never meant to be played using the mouse,
Grim Mouse heavily modifies both the game source code and the surrounding
VM-- Neither LucasArts nor the ResidualVM team will provide support for this
mod. See below for information on how to report bugs.

Current state
This mod is alpha. 
You may run into bugs, which may prevent you from finishing the game --
so save often and play at your own risk.

Installing Grim Mouse
Installation of Grim Mouse works exactly like installation of ResidualVM.
In short:
1. Copy all the files in the 'grimdata' folder of both Grim Fandango CDs
   into a folder on your hard drive. Overwriting duplicate files is fine.
2. Download the original v1.1 patch (gfupd101.exe) from
   and put it into the same folder.
3. Mac: Mount (double-click) the .dmg file, and drag the residualvm icon into /Applications
   Windows: Extract the contents of the zip file to any folder on your hard disk
4. Start Grim Mouse / ResidualVM
5. Click 'Add Game' and navigate to your gamedata folder from Step 1
   The screen should say "Grim Fandango Windows/English". That's ok, even
   if running it on Mac or Linux.
6. Click 'OK' and 'Start' -> you're all set.

If your have any problems installing, you may also consult the original
ResidualVM guide ( or README.ResidualVM, as the process is
the same.

Most of the keyboard controls still work in the original manner;
while the game should be playable 100% using the mouse only, if there are
some puzzles which you prefer to solve using the old interface, you can do so.

* New controls *
Left-click   : Walk and use 
               If you left-click on an object, it is used. If Manny
               is holding an inventory object, it is used on the scene object.
Double-click : Run and use
               Same as single-click, except Manny will run to the object.
Right-click  : Look at / Use inventory object on its own
               Same as left-click, except Manny will look at an object instead
               of using it. If Manny is holding an inventory object, right-click
               will use it on its own (e.g. deck of cards, or fire extinguisher
               in Beaver Dam)
Middle-click : Open Inventory
(or I key)     If Manny is holding an object, he will put it away.
               Left-click within the inventory selects an object, right-click
               will make Manny look at it.
Space key    : Show all hotspots in the scene
Shift + Z    : Toggle developer mode

* Useful old controls *
Alt+Enter    : Toggle fullscreen mode
Arrow keys   : Control Manny the old fashioned way
E,U,P,I      : Examine, Use, Pickup, Inventory
F1           : Menu (use arrow keys to navigate)
Escape       : Skip some cutscenes
.            : Skip dialogue lines

Bugs are to be expected. Please report your bugs in the github issue tracker (preferred)
or by email (verticalduck (at) if you don't have a github account.

If you are stuck due to a bug and want to continue playing the game, you can try
using the old controls to manouver out of broken boxes, or activating the 
developer mode with Shift+Z and teleport into an adjacent scene etc. (Check 
README.ResidualVM for the developer mode shortcuts)
Something went wrong with that request. Please try again.