Tree [2fd82c] master /
History



File Date Author Commit
doc 2014-12-31 Sworddragon Sworddragon [2fd82c] Added support for showing telecast entries from...
install 2014-06-29 Sworddragon Sworddragon [493551] Fixed cleaning up of some files on building/ins...
src 2014-12-31 Sworddragon Sworddragon [2fd82c] Added support for showing telecast entries from...
.gitignore 2014-06-05 Sworddragon Sworddragon [5f53d8] Removed default option in config.json
CODING_STYLE 2014-11-25 Sworddragon Sworddragon [5e5b52] Updated CODING_STYLE
COPYING 2013-04-19 Sworddragon Sworddragon [b4f4a7] Initial release
README 2014-10-20 Sworddragon Sworddragon [a122b1] Minor optimizations
build.py 2014-10-20 Sworddragon Sworddragon [a122b1] Minor optimizations

Read Me

Description
--------------------------------------------------------------------------------

tvoip - a programmable online television.

tvoip can receive http, rtmp and rtmfp streams from the internet which are
configurable with channel files.


Changelog
--------------------------------------------------------------------------------

0.3.0-pre
- Minor optimization.

0.2.0
- Categorized the panel with tabs and added additional tabs to change the
  options, to edit and delete channels and to add channels.
- Datatypes in configuration files are now checked more strict.
- User interface elements can now be configured with the configuration file.
- Enhanced checking for duplicate server entries.
- Added a plugin system to search for channel addresses.
- Added a default plugin to search for channel addresses.
- Several fixes and optimizations.

0.1.0
- Added support for a configuration file and multiple channel files.
- The connection timeout, maximum volume, interval on hold down channel/volume
  buttons, amount changed of the volume per interval and buffer time are now
  configurable.
- Numbered server addresses can now be generated.
- Channels can now be disabled in the channel files.
- Added support for peer-to-peer streams.
- Added error output in the player and the browser console.
- Added detailed status output of the current stream.
- The state of the mute and status buttons are now saved.
- The title bar of the browser contains now the project name.
- Added an option to configure the fallback aspect ratio, if channels shall be
  sorted, to enable hardware acceleration and to limit the status output.
- Added a loading bar that shows the buffering progress of a stream.
- Added a command line interface installer for Linux and Windows.
- Added a button to select manually the aspect ratio.
- Several fixes and optimizations.

0.0.0
- Initial release.


Compiling
--------------------------------------------------------------------------------

To compile the flash application the Apache Flex SDK is required. The flash
application can be compiled by calling build.py or manually by calling mxmlc on
src/lib/player.as.


Requirements
--------------------------------------------------------------------------------

- A webbrowser that is still officially supported and has a minimum worldwide
  marketshare of 1%.
- Flash Player 11.1 or higher.


Running
--------------------------------------------------------------------------------

To successfully receive any streams it is recommended to run a webserver and put
the files of TvoIP into the scope of the webserver. After this it is just needed
to call the local url to TvoIP's index.xhtml. For example start the Apache
webserver and copy the tvoip directory into the htdocs folder of Apache. In this
case the correct url would be "http://localhost/tvoip/index.xhtml".


FAQ
--------------------------------------------------------------------------------

Question: Why should I run a webserver for TvoIP?
Answer  : TvoIP uses the Flash Player to show any streams which needs to run in
          a domain to be able to receive any streams. But some streams can also
          be received if TvoIP is running on the file protocol.

Question: Why doesn't TvoIP receive the stream although I'm able to watch it
          successfully on an external site?
Answer  : The Flash Player uses a DRM system which allows websites to disallow
          any external domains to successfully connect to their streaming
          server.

Question: Why doesn't TvoIP use HTML5 instead of the Flash Player?
Answer  : A lot of streaming servers are sending over the RTMP and RTMFP
          protocols and currently no browser is able to handle these protocols.


Contact information
--------------------------------------------------------------------------------

Maintainer: Sworddragon <sworddragon2@aol.com>