1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65
|
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.
|