GTK UVC VIEWER (guvcview)

Basic Configuration

Dependencies:

Guvcview depends on the following:

intltool,
autotools,
libsdl2 or libsdl,
libgtk-3,
portaudio19,
libpng,
libavcodec,
libavutil,
libv4l,
libudev,
libusb-1.0,
libpulse (optional)
libgsl (optional)

On most distributions you can just install the development packages: intltool, autotools-dev, libsdl2-dev, libgtk-3-dev, portaudio19-dev, libpng12-dev, libavcodec-dev, libavutil-dev, libv4l-dev, libudev-dev, libusb-1.0-0-dev, libpulse-dev, libgsl-dev

Build configuration:

(./bootstrap.sh; ./configure)

The configure script is generated from configure.ac by autoconf, the helper script ./bootstrap.sh can be used for this, it will also run the generated configure with the command line options passed. After configuration a simple 'make && make install' will build and install guvcview and all the associated data files.

Data Files:

(language files; image files; gnome menu entry)

guvcview data files are stored by default to /usr/local/share setting a different prefix (--prefix=BASEDIR) during configuration will change the installation path to BASEDIR/share.

Built files, src/guvcview and data/gnome.desktop, are dependent on this path, so if a new prefix is set a make clean is required before issuing the make command.

After running the configure script the normal, make && make install should build and install all the necessary files.

guvcview bin:

(guvcview)

The binarie file installs to the standart location, /usr/local/bin, to change the install path, configure must be executed with --prefix=DIR set, this will cause the bin file to be installed in DIR/bin, make sure DIR/bin is set in your PATH variable, or the gnome menu entry will fail.

guvcview libraries:

(libgviewv4l2core, libgviewrender, libgviewaudio, libgviewencoder)

The core functionality of guvcview is now split into 4 libraries these will install to ${prefix}/lib and development headers to ${prefix}/include/guvcview-2/libname. pkg-config should be use to determine the compile flags.

guvcview.desktop:

(data/guvcview.desktop)

The desktop file (gnome menu entry) is built from the data/guvcview.desktop.in definition and is dependent on the configure --prefix setting, any changes to this, must be done in data/guvcview.desktop.in.

configuration files:

(~/.config/guvcview2/video0)

The configuration file is saved into the $HOME dir when exiting guvcview. If a video device with index > 0, e.g: /dev/video1 is used then the file stored will be named ~/.config/guvcview2/video1

Executing guvcview

For instructions on the command line args execute "guvcview --help".

JingyuChan/guvcview