
BASIC
--------------------------------------------------------------------------------
Run fische with the -h or --help flags for a basic help message.
Fische also has a man page, which is distributed with the source tarball.
Fische tries to read a configuration file ($HOME/.fischerc), and will update the
file with the most recent "known good" parameters.
--------------------------------------------------------------------------------

RUNTIME
--------------------------------------------------------------------------------
At runtime, press 'P' to pause, 'F' to toggle fullscreen mode and 'ESC' to quit.
'N' toggles "nervous mode".
With the --exit-on-mouseevent flag, fische does exactly that.
--------------------------------------------------------------------------------

TROUBLESHOOTING (Linux only)
--------------------------------------------------------------------------------
***** If you get this error:
      X Error of failed request:  BadValue (integer parameter out of range for
      operation)
----- Try to start fische with the -v or --virtual flags and set X/Y to values
      that correspond to a fullscreen resolution that you know exists.
      For example: fische -g 1400x700 -v 1400x1050

***** If fische starts, but won't react to sound
----- There are many possible solutions:
      a) First of all, try to use a different audio input driver. At the moment
         fische supports ALSA and PulseAudio input. See "fische -h" for details.
      b) If you are using PulseAudio for input, fische opens the default source
         as set with pavucontrol or similar tools. For example, if you would
         like to visualize "what's playing", set the corresponding
         "monitor of output XYZ" device as default.
      c) You might be using the wrong ALSA device. By default, fische tries to
         open the "default" device. It should be correctly configured on most
         systems, but with some soundcards you need complex ALSA configuration
         to achieve recording capabilities - look into the ALSA documentation.
         For example, soundcards with ICE1712 chips record internally produced
         sound on channels 10 and 11 instead of 0 and 1.
      d) ALSA recording might not be enabled. Check with "alsamixer" or an other
         mixer application. If you are trying to visualize sounds produced by an
         audio player, you must enable recording of what's called "PCM" on most
         cards. For external input, record "Line In", and so on...
      e) Your sound card might not support recording of your chosen source. In
         this case, you are in bad luck. Most notably, many C-Media based cards
         do not allow recording while SPDIF out is in use. You can try a setup
         using an "aloop" dummy card - but that process is far beyond the scope
         of this README, and with most distributions, it requires kernel or ALSA
         re-compilation. However, in this case the PulseAudio input driver might
         give you the desired results.
--------------------------------------------------------------------------------

FAQ
--------------------------------------------------------------------------------
***** Will fische support recording from OSS/jack/EsounD...
----- It might, provided I can find someone to write the related code. If you
      know something about sound programming, you are welcome to join.
     
***** Will fische evolve towards different types of visualization?
----- No, this program is highly optimized to do what it does now. There might
      be one or two feature enhancements, but the general picture will remain.

***** Did you know "fische" means "fish" in German?
----- Yes I did. And no, it's not supposed to make any sense.

