fische

Langue: en

Version: 337477 (ubuntu - 24/10/10)

Section: 1 (Commandes utilisateur)

NAME

fische - standalone sound visualisation

SYNOPSIS

fische [options]

OPTIONS


-D --driver driver

Use the specified audio input driver. Presently alsa and pulse are supported. Autodetected by default.

-d --device device

device names the alsa pcm capture device to get the sound data from. Does nothing when PulseAudio is used. On most systems, the default will do just fine.

-g --geometry XxY

X and Y specify the width and height of the animation. Defaults to 800x400.

-v --virtual XxY

X and Y specify the width and height of the application window. Use this to prevent your computer from trying to switch to non-existent fullscreen resolutions.

-f --fullscreen

Start fische in fullscreen mode.

-s --fps fps

fps specifies the target frames per second. The default, 30, is what fische is designed for

-1 --single

Use only one CPU, even if there are more available

-p --predictive

Use predictive beat detection (experimental)

--exit-on-mouseevent

Exit when a mouse button is clicked (useful mainly on touchscreens)

-n --nowrite

Do not update the configuration file with the last known working configuration.

-h --help

Display a basic help message.

RUNTIME CONTROLS

At runtime, press P to pause, F to toggle fullscreen mode and ESC to quit. R toggles predictive beat detection, which is experimental at this stage. With the --exit-on-mouseevent flag, fische does exactly that.

TROUBLESHOOTING

If you get an error like "X Error of failed request: BadValue..."

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

First of all, try a different input driver. If you are lucky, this already solves your problem.
If not, you now have to choose which driver you would like to get working:
pulse: 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.
alsa: 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.
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...
alsa: 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 still give you the desired results.

FILES

$HOME/.fischerc - automatically updated on clean exit.

SEE ALSO

Runtime control documentation, troubleshooting information and FAQs in the README

AUTHOR

This manual page was written by Marcel Ebmer fische@26elf.at. Permission is granted to copy, distribute and/or modify this document under the terms of the GNU General Public License, Version 2, or any later version published by the Free Software Foundation