Introduction

atrogue allows you to specify several settings on the command-line when you start it. Some of these are only available if the respective compile-time configuration options have been enabled before.

Please don't try to use any command-line options which are not documented here - that could cause trouble...

The Command-Line Options

• --version - print a short version information and quit
• --color=on - enable colors for the map display (default); this is only possible if you have enabled the respective compile-time configuration option OPTION_COLORS. If you enable colors but your terminal does not support them, atrogue will still work, it just won't use colors.
• --color=off - disable colors for the map display
• --colorhl=value - when you've enabled color support, some colors can look darker than they should; for example, a yellow obstacle symbol ({) in the level map might look brown with some VGA graphics cards. To avoid that, use this "highlighting" option which will set the yellow color to a "real" yellow (use yellow for value) or highlight all the other colors too (use any for value). If you don't like this highlighting, don't use this option at all or none for value (default).
• --width=number - the width of the dungeon levels; currently, values from 60 to 120 are allowed; if you don't use this option, atrogue will try to adapt the level width to your terminal width automatically when it starts.
• --height=number - the height of the dungeon levels; currently, values from 20 to 40 are allowed; if you don't use this option, atrogue will try to adapt the level height to your terminal height automatically when it starts.
• --log=on - enable writing all game messages into a log file; the log file will be called ".atrogue-log" and lie in your home directory. (If the environment variable "HOME" isn't set, the log file will lie in the current directory instead.) Do not play several atrogue games simultaneously with logging enabled - the messages would intermix in the log file!
• --log=off - disable writing game messages into a log file (default)