ifm man page

IFM — Interactive Fiction Mapper


ifm [options] [file...]


IFM is a program for keeping track of your progress through an Interactive Fiction game. You can record each room you visit and its relation to other rooms, the initial locations of useful items you find, and the tasks you need to perform in order to solve the game.

The IFM mapping commands are designed so that you can easily add to the map as you explore the game. You type in the rooms you visit and the directions you move in to reach other rooms, and IFM calculates the position of each room relative to the others. A map can consist of several independent sections, allowing you to divide up the map however you like.

The IFM task commands, if used, allow you to specify the order in which game-solving tasks must be done. The IFM program can then calculate and print different styles of walkthrough for the game.

IFM can write hardcopy maps directly to PostScript, suitable for printing or viewing. It can also write maps in Fig format, which can be viewed and edited using Xfig, or converted into many other formats.

This man page just presents a summary of the command-line options. Detailed documentation on how to use IFM can be found in the in the See Also section.

Output options

-m, -map[=sections]
Select map output
-i, -items
Select item output
-t, -tasks
Select task output
-f, -format <fmt>
Select output format
-o, -output <file>
Write output to file

Auxiliary options

-S, -style (name)
Push a style onto the style list
-s, -set (var=val)
Set a customization variable
-w, -nowarn
Don't print warnings
Don't read personal init file

Preprocessor options

-D (var[=val])
Define a preprocessor symbol
-I (dir)
Prepend directory to search path
Just preprocess input

Information options

-show <type>
Show information
-v, -version
Print program version
-h, -help
This help message

Output formats (may be abbreviated)

Fig drawing commands
Nicely-formatted ASCII text
Recording of game commands
Graph of task dependencies
Raw ASCII text fields
Tcl/Tk program commands (tkifm)

Show options (may be abbreviated)

Show map sections
Show defined variables
Show file search path


Colon-separated list of extra directories to search for include files.


User resource file (ifm.ini on Windoze).

See Also

Online documentation
Documentation suitable for printing


IFM version 5.1 November 2004