freeseer: A Python repository from zxiiro

Freeseer

=========

by the Free and Open Source Software Learning Centre (FOSSLC)

Freeseer is a free and open source screencasting application. Its primary purpose is capturing or streaming video at conferences.

It's been successfully used to capture presentations, demos, training material, and other videos. It can easily handle very large conferences with many talks using varied hardware and operating systems.

It is one of a few such tools that can also record VGA output or video from external sources such as FireWire, USB, S-Video, or RCA.

Freeseer is written in Python, uses Qt4 for its GUI, and Gstreamer for video/audio processing.

Freeseer is based on open standards and supports royalty free audio and video codecs.

Curious why Freeseer exists? Read our history!

Documentation

Read our documentation at http://freeseer.github.com/docs

Install from a package

Use this option if you just want to run Freeseer. If you plan on developing Freeseer, you would still need to fork and clone the repo.

Visit our downloads page at https://github.com/Freeseer/freeseer/downloads

Note: For the very latest but unstable version, you have to build from the experimental source (see developers section).

Installing Freeseer

1. Install dependencies

Make
Git
Python 2.7+
sqlite3
PyQT development tools
Passlib (for the Freeseer server tool)
Xlib (for one of the Linux plugins)

Ubuntu Linux:
```
 $ sudo apt-get install build-essential qt4-qmake pyqt4-dev-tools libqt4-dev libqt4-sql libqt4-sql-sqlite python-qt4 python-qt4-dev python-qt4-sql python2.7-dev python-feedparser python-setuptools python-xlib
 $ sudo easy_install yapsy==1.9.2 passlib
```
Fedora Linux:
```
 $ sudo yum install git make PyQt4-devel python-feedparser.noarch python-setuptools
 $ sudo easy_install yapsy==1.9.2
```
Windows:
1. python-2.7.3(x86 or x64) + Python needs to be version 2.7.*
2. setuptools-0.6c11.win32-py2.7 (download)
3. GStreamer-WinBuilds-GPL-x86-Beta04-0.10.7(download)
4. GStreamer-WinBuilds-SDK-GPL-x86-Beta04-0.10.7(download)
5. PyQt-Py2.7-x86-gpl-4.8.5-1(x86) + Windows 32-bit packages are recommended (pygtk-all-in-one package does not have a 64-bit installer yet) + On Windows, add the following paths to your PATH variable : C:\Python27;C:\Python27\Lib\site-packages\PyQt4\bin
6. these python eggs : pygtk, feedparser, yapsy
  - C:\Python27\python.exe C:\Python27\Lib\site-packages\easy_install.py feedparser
  - C:\Python27\python.exe C:\Python27\Lib\site-packages\easy_install.py pygtk
  - C:\Python27\python.exe C:\Python27\Lib\site-packages\easy_install.py yapsy==1.9.2
Mac OS X:

Coming soon!

2. Download

If you are a user and would like to use Freeseer you can install the current version using PIP

$ pip install freeseer

If your a developer and want to contribute to Freeseer clone the project with git:

$ git clone git@github.com:Freeseer/freeseer.git  # Clones a copy of the master repo

3. Run

Once you have the prerequisite components you can run Freeseer using the following commands:

Users who installed using pip:

$ freeseer-record  # Recording tool
$ freeseer-config  # Configuration tool
$ freeseer-talkeditor  # Talk-list editor

Developers who git cloned the repo will need to:

$ cd src
$ ./freeseer-record  # Recording tool
$ ./freeseer-config  # Configuration tool
$ ./freeseer-talkeditor  # Talk-list editor

Packaging

See PACKAGE.txt for instructions.

Bug tracker

Have a bug? Please create an issue here on GitHub!

https://github.com/Freeseer/freeseer/issues

IRC channel

Drop by our #freeseer channel on irc.freenode.net to get an instant response.

http://webchat.freenode.net/?channels=#freeseer

Mailing list

Have a question? Ask on our mailing list!

freeseer@googlegroups.com

Subscribe to mailing list

Authors

And many student contributors from Google Summer of Code, Fedora Summer Coding, and Undergraduate Capstone Open Source Projects.

Copyright and license

Licensed under the GNU General Public License, version 3 (GPLv3); you may not use this work except in compliance with the GPLv3.

You may obtain a copy of the GPLv3 in the LICENSE file, or at:

http://www.fsf.org/licensing/licenses/gpl.html

zxiiro/freeseer