NAME

       bambam - a keyboard mashing and doodling game for babies and toddlers

SYNOPSIS

       bambam [OPTIONS]

DESCRIPTION

       -u, --uppercase
              Show UPPER-CASE letters.

       -d, --deterministic-sounds
              Produce same sounds on same key presses.

       -D, --dark
              Use a dark background instead of a light one.

       -m, --mute
              Do not play any sounds.

       --sound_blacklist=GLOB
              List of sound filename patterns to never play.

       --image_blacklist=GLOB
              List of image filename patterns to never show.

       --extension=EXTENSION
              Use the specified extension.

       --wayland-ok
              Do not prevent running under Wayland. See the NOTES section.

       bambam  is  a  keyboard and mouse game for babies written in Python.  Pressing letter keys
       prints them in random locations and colours.  Pressing any other key draws little pictures
       in  random  locations.   Dragging  the  mouse  while  the mouse button is pressed draws in
       randomly changing colours.  The screen is cleared at random.

NOTES

       To quit, directly type the command mentioned in the upper left-hand corner of the  window.
       In the English locales, this is the word: quit.

       Be aware that there are ways to switch to another application from bambam:

       •      when running under Wayland, it is not currently possible for bambam to grab all key
              presses.  A consequence of that is that  if  you  use  GNOME  Shell,  pressing  the
              Windows  (a.k.a.  Super)  key  will activate the activities overview.  Please check
              your environment.  As a workaround, starting with version 1.1.2, bambam will try to
              detect  if  it is running under Wayland. If this is the case, bambam will display a
              warning and refuse to work.  You can disable this workaround, with the --wayland-ok
              option.

       •      bambam  does  not  block  virtual  terminal  switching (e.g.  CTRL+ALT+F1). See the
              example 50-dont-vt-switch.conf file if you would like to block that.

       •      there may be other yet unknown ways in other environments and window managers.

       For the above reasons, starting with version 1.2.0, it is possible and recommended to  run
       bambam in a dedicated login session.

       •      One  way  to  do  this  is  to select BamBam session type from your display manager
              settings when logging in (look for a gear icon).

       •      Another way is use command such as exec startx bambam from a text console.

       To turn the sound off and on, type mute and unmute, respectively, in the game.

       bambam loads images (GIF, JPEG, PNG and TIFF files) and sounds (WAV and  OGG  files)  from
       the following directories:

       •      the data directory distributed with the game,

       •      the   data   directory   in   bambam's   $XDG_DATA_HOME   subdirectory   (typically
              ~/.local/share/bambam/data)

       When scanning directories for  files,  bambam  does  follow  symbolic  links  and  descend
       directories. This makes is easy to have bambam use files located elsewhere.

       As  of  version  1.3.0  bambam has experimental support for extensions, which are a way of
       changing the program behaviour.  Bambam loads extensions from the following directories:

       •      the extensions directory distributed with the game,

       •      the  extensions  directory  in  bambam's  $XDG_DATA_HOME  subdirectory   (typically
              ~/.local/share/bambam/extensions)

       See the EXTENSIONS.md file for documentation on creating and modifying extensions.

AUTHOR

       Spike Burch <spikeb@gmail.com>  Marcin Owsiany <marcin@owsiany.pl>