Tree [c2a157] master /
 History

HTTPS access


File Date Author Commit
 data 2016-01-27 Paulo Assis Paulo Assis [5d516d] fix some appstream-util validation errors: vali...
 guvcview 2017-08-06 Paulo Assis Paulo Assis [c2a157] fix qt5 build on ppc64 and ppc64le <lovigi@user...
 gview_audio 2016-09-06 Paulo Assis Paulo Assis [d36c56] fix segfault when destroying mutexes by unlocki...
 gview_encoder 2017-03-23 Paulo Assis Paulo Assis [4a03ec] update to new libavcodec API with decoupled inp...
 gview_render 2017-03-23 Paulo Assis Paulo Assis [4a03ec] update to new libavcodec API with decoupled inp...
 gview_v4l2core 2017-06-26 Paulo Assis Paulo Assis [a8bf85] fix resolution change: set correct fps after ch...
 includes 2017-01-18 Paulo Assis Paulo Assis [8df96c] add blur effect; remove antialiasing 2x
 m4 2016-07-30 Paulo Assis Paulo Assis [b11613] update m4 scripts
 pkgconfig 2015-12-30 Paulo Assis Paulo Assis [9c4ce8] add initial support for Qt5 interface
 po 2017-04-18 Paulo Assis Paulo Assis [7fb23e] Apply patch by Marvin Schmidt <marvin.schmidt19...
 .gitignore 2016-11-03 Paulo Assis Paulo Assis [416c5e] git ignore multiple build dirs
 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 2017-02-08 Paulo Assis Paulo Assis [401a63] Update Changelog for final 2.0.5 version
 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 2016-09-26 Paulo Assis Paulo Assis [4f68b1] fix libgsl devel package name in README (libgsl...
 bootstrap.sh 2010-03-04 Paulo Assis Paulo Assis [334fb5] * update autotools configuration
 configure.ac 2017-03-23 Paulo Assis Paulo Assis [4a03ec] update to new libavcodec API with decoupled inp...

Read Me

GTK UVC VIEWER (guvcview)


Basic Configuration

Dependencies:

Guvcview depends on the following:
- intltool,
- autotools,
- libsdl2 and/or sfml,
- libgtk-3 or libqt5,
- portaudio19,
- libpng,
- libavcodec,
- libavutil,
- libv4l,
- libudev,
- libusb-1.0,
- libpulse (optional)
- libgsl0 (optional)

On most distributions you can just install the development
packages:
intltool, autotools-dev, libsdl2-dev, libsfml-dev, libgtk-3-dev or qtbase5-dev,
portaudio19-dev, libpng12-dev, libavcodec-dev, libavutil-dev,
libv4l-dev, libudev-dev, libusb-1.0-0-dev, libpulse-dev, libgsl0-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.

guvcview will build with Gtk3 support by default, if you want to use
the Qt5 interface instead, just run ./configure --disable-gtk3 --enable-qt5
you can use SDL2 (enabled by default) and/or SFML (disabled by default)
as the rendering engine, both engines can be enabled during configure
so that you can choose between the two with a command line option.

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