Tree [a02e22] master /
History



File Date Author Commit
data 2014-07-05 Paulo Assis Paulo Assis [d0a6a6] update appdata screenshots
guvcview 1 day ago Paulo Assis Paulo Assis [a3d9b2] cast opt as int avoiding issues with getopt on ...
gview_audio 2014-08-05 Paulo Assis Paulo Assis [0608a6] Add pthread initialization for static mutexes; ...
gview_encoder 1 day ago Paulo Assis Paulo Assis [72f393] add support for older versions of libavcodec an...
gview_render 1 day ago Paulo Assis Paulo Assis [a02e22] add debug info about current render driver
gview_v4l2core 1 day ago Paulo Assis Paulo Assis [72f393] add support for older versions of libavcodec an...
includes 2014-08-05 Paulo Assis Paulo Assis [0608a6] Add pthread initialization for static mutexes; ...
m4 2014-05-01 Paulo Assis Paulo Assis [9b1ba9] update library versions; update some autoconf f...
pkgconfig 2014-04-30 Paulo Assis Paulo Assis [e58a5b] update pkg-config files
po 2014-08-17 Paulo Assis Paulo Assis [1fa870] update language catalogs
.gitignore 2014-01-30 Paulo Assis Paulo Assis [3d7817] add compile to .gitignore
AUTHORS 2010-06-08 Paulo Assis Paulo Assis [3693b7] * update icons
COPYING 2008-05-05 Paulo Assis Paulo Assis [c75b64] * fixed some dpkg-buildpackage dependencies
ChangeLog 2014-05-02 Paulo Assis Paulo Assis [d02a8a] Update changelog to reflect new version 2.0.0
INSTALL 2014-05-01 Paulo Assis Paulo Assis [9b1ba9] update library versions; update some autoconf f...
Makefile.am 2014-06-26 Paulo Assis Paulo Assis [6f8f30] add appdata xml file to build system (with tran...
NEWS 2009-09-10 Paulo Assis Paulo Assis [0a1840] * fix compilation error (duplicate switch entry)
README.md 2014-03-06 Paulo Assis Paulo Assis [8e2ac8] small update to README
bootstrap.sh 2010-03-04 Paulo Assis Paulo Assis [334fb5] * update autotools configuration
configure.ac 1 day ago Paulo Assis Paulo Assis [72f393] add support for older versions of libavcodec an...
ltmain.sh 2014-05-01 Paulo Assis Paulo Assis [9b1ba9] update library versions; update some autoconf f...

Read Me

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".