WolfWiki - User contributions [en]

ETTVd:Known Bugs

2007-02-19T16:30:39Z

Arni: /* ETTVd Daemon */

== Webinterface ==

2.00 - 2.02

Some commands are sent in the wrong order effectively breaking recordmode connect - if you want to use it, spawn the recorder with recordmode ready and then edit it to make it "connect".

== ETTVd Daemon ==

All versions

Not getting all symlinks right on first start - just restart it ^^

ETTVd:Known Bugs

2007-02-19T16:30:17Z

Arni: /* ETTVd Daemon */

== Webinterface ==

2.00 - 2.02

Some commands are sent in the wrong order effectively breaking recordmode connect - if you want to use it, spawn the recorder with recordmode ready and then edit it to make it "connect".

== ETTVd Daemon ==

All versions:
Not getting all symlinks right on first start - just restart it ^^

ETTVd:Known Bugs

2007-02-19T16:23:18Z

Arni: /* Webinterface */

ETTVd:Known Bugs

2007-02-19T16:06:12Z

Arni: /* Webinterface */

== Webinterface ==

2.00 - 2.02

Some commands are sent in the wrong order effektively breaking recordmode connect - if you want to use it, spawn the recorder with recordmode ready and then edit it to make it "connect".

== ETTVd Daemon ==
none

ETTVd:Readme

2006-12-01T19:07:04Z

Arni:

=== Important ===

For an updated manual visit http://eicher.homelinux.com/ettvd/ - this one sucks bigtime
thanks a lot eicher for creating this documentation project for ettvd

=== Requirements: ===

* php5 cli installed (install [http://www.apachefriends.org XAMPP] if you dont want to compile)
(some people also report it working on some php4 versions but with 5 you are on the safe side)

=== Remarks ===

BETA2 24.11.2006

=== Changes for b2 ===

* New options in config.php - watch out
* Fixed a mean bug cloning objects by accident
* Quick serverswitch
* More ingame information
* Better playlists
* Increased security
* Control IP whitelisting
* Improved logging
* Maximum recorders, replayers, slots that can be spawned from the control interface
* Number of people to start recording with now configurable via the interface
* Added example demo file to get it to run faster
* A lot of stupid warnings removed
* Cleaned up the servers directory from more files that are not needed
* a lot of small stuff
* a completely new webinterface but skooli is too lazy to document it

=== Features b1 ===

Complete management of all ettv servers - the servers are started as children of the ettvd process
for full control over them. The servers will recieve all commands needed from the ettvd service.

* Start of recording when enough players are ready
* Recording pause when players leave the server
* Disconnect from matchserver after timeout
* Simultanious recording of as many games as you want (limited by cpu/ram)
* Replay of recorded games
* Multiple broadcast servers showing the same or different games in Live, Semi-Live or Replay mode.
* Spam protection with a sticky mute system (/reconnect doesnt help)
* A fully featured webinterface (by skooli)
* ETTVoD ready
* Display of intermediate maptimes
* Announcer for next game, current game both ingame and in sv_hostname
* Most settings configurable in a single file
* Fully painless matchserver crash recovery
* Recovery of all sorts of ettv broadcaster crashes (replayers continue where they crashed)
* Ingame admin commands !mute, !kick, !reclist, etc
* Complete demo management for archiving
* Constantly maintaining the correct ettv_delay
* Replay Playlists or playing specific games again
* Probably more

=== Installation: ===

ETTVd:
Edit: start.sh, config.php
Add maps and pak0.pk3 to etmain
Make ettv.x86 executable

Webinterface:
upload to php'able webspace
configure includes/config.php

=== Starting: ===

./start.sh as superuser (edit it first) - if you're not root change start.sh acordingly

My _example_ script will automatically set a higher priority and change user to my ettv user

=== Thanks ===

Big thanks to skooli for the webinterface
Big thanks to zinx and bani for caring about my ettv whine
Thanks to frop for pimping the webinterface
Thanks to conr4d for that suitable ettvd logo
Thanks again to eicher for starting a proper documentation for ettvd
Thanks to everyone reporting bugs

=== Ingame chat commands ===

These commands are available for all people who have logged in to the webinterface
within the past 6 hours or used the adminip console command.

!admintest
--Check if you have admin access ingame

!recordmode <mode>
--Same as console recordmode, see below

!nextmap
--Jumps to the next map of the current recording
--See console nextmap for more information

!autoreplaynum
--See below

!reclist
--A quick ingame overview what the recorders are doing

!findviewer
--Debug function for viewer matching function used by below functions
--Supports partial matches, strips colours and is case insensitive

!mute <match> <time>
--Mute a viewer specified by the <match> for <time> minutes, if <time> is not given default is to 5min

!unmute <match>
--Unmutes the viewer (also removes the sticky mute)

!kick <match>
--Goodbye <match> (banned for 5min by default)

=== Basic Commands (Not needed when using webinterface) ===

connect <ip> <gpw> <ettvpw>
--Creates a new recorder and connects it to this server

gamename <recid> <name>
--Sets the name of the currently running game on a recorder

recordmode <recid> <mode>
--Sets the recordmode for a recorder, the following modes are currently supported.
--ready - recording starts once 4 players are ready
--connect - recording starts as soon as the recorder is connected

--Remark to recording: Recording stops when less than 50% of the players the game started
--with remain on the server, it resumes when 2/3 of those players rejoin.
--Please do not forget to kill your recorders even if they paused recording

livecast <recid> <repid>
--Tells a replayer that it should replay whatever that recorder will be recording
--If the replayer is not running at the point that the recorder starts recording it will not work

broadcast <slots> <port> <privateslots> <gameid> <config>
--Starts a new broadcaster - you can omit everything except slots

killrec <recid>
--kills a recorder after broadcast

killrep <repid>
--kills a replayer for whatever reason

quit_rly
--shuts down everything cleanly - better than killing the process

reloaddemos
--reloads the demolist from disk in case you deleted some or whatever

demolist
--shows a list of all recorded games

viewerlist <repid>
--shows some info about connected viewers

playgame <repid> <gameid>
--plays a certain game

nextmap <repid>
--jumps to the next map - if it was the last map of the game it will chose the next game in the reply cycle
--if you do this in live broadcast mode you will leave the live broadcast, because we cant jump into the future !!

autoreplaynum <repid> <number>
--the number of recent games the replayer will automatically replay

serverlist
--shows all server processes currently managed by ettvd

debug <1/0>
--turns debug information on or off

There are more functions used by the webinterface - if you really care, please check the
sourcecode of ettvd.php - commands are pretty easy to understand

ETTVd:Readme

2006-12-01T18:54:39Z

Arni:

=== Important ===

For an updated manual visit http://eicher.homelinux.com/ettvd/ - this one sucks bigtime
thanks a lot eicher for creating this documentation project for ettvd

=== Requirements: ===

* php5 cli installed (install [http://www.apachefriends.org XAMPP] if you dont want to compile)
(some people also report it working on some php4 versions but with 5 you are on the safe side)

=== Remarks ===

BETA2 24.11.2006

=== Changes for b2 ===

* New options in config.php - watch out
* Fixed a mean bug cloning objects by accident
* Quick serverswitch
* More ingame information
* Better playlists
* Increased security
* Control IP whitelisting
* Improved logging
* Maximum recorders, replayers, slots that can be spawned from the control interface
* Number of people to start recording with now configurable via the interface
* Added example demo file to get it to run faster
* A lot of stupid warnings removed
* Cleaned up the servers directory from more files that are not needed
* a lot of small stuff
* a completely new webinterface but skooli is too lazy to document it

=== Features b1 ===

Complete management of all ettv servers - the servers are started as children of the ettvd process
for full control over them. The servers will recieve all commands needed from the ettvd service.

* Start of recording when enough players are ready
* Recording pause when players leave the server
* Disconnect from matchserver after timeout
* Simultanious recording of as many games as you want (limited by cpu/ram)
* Replay of recorded games
* Multiple broadcast servers showing the same or different games in Live, Semi-Live or Replay mode.
* Spam protection with a sticky mute system (/reconnect doesnt help)
* A fully featured webinterface (by skooli)
* ETTVoD ready
* Display of intermediate maptimes
* Announcer for next game, current game both ingame and in sv_hostname
* Most settings configurable in a single file
* Fully painless matchserver crash recovery
* Recovery of all sorts of ettv broadcaster crashes (replayers continue where they crashed)
* Ingame admin commands !mute, !kick, !reclist, etc
* Complete demo management for archiving
* Constantly maintaining the correct ettv_delay
* Replay Playlists or playing specific games again
* Probably more

=== Installation: ===

ETTVd:
Edit: start.sh, config.php
Add maps and pak0.pk3 to etmain
Make ettv.x86 executable

Webinterface:
upload to php'able webspace
configure includes/config.php

=== Starting: ===

./start.sh as superuser (edit it first) - if you're not root change start.sh acordingly

My _example_ script will automatically set a higher priority and change user to my ettv user

=== Thanks ===

Big thanks to skooli for the webinterface
Big thanks to zinx and bani for caring about my ettv whine
Thanks to frop for pimping the webinterface
Thanks to conrad for that suitable ettvd logo
Thanks again to eicher for starting a proper documentation for ettvd
Thanks to everyone reporting bugs

=== Ingame chat commands ===

These commands are available for all people who have logged in to the webinterface
within the past 6 hours or used the adminip console command.

!admintest
--Check if you have admin access ingame

!recordmode <mode>
--Same as console recordmode, see below

!nextmap
--Jumps to the next map of the current recording
--See console nextmap for more information

!autoreplaynum
--See below

!reclist
--A quick ingame overview what the recorders are doing

!findviewer
--Debug function for viewer matching function used by below functions
--Supports partial matches, strips colours and is case insensitive

!mute <match> <time>
--Mute a viewer specified by the <match> for <time> minutes, if <time> is not given default is to 5min

!unmute <match>
--Unmutes the viewer (also removes the sticky mute)

!kick <match>
--Goodbye <match> (banned for 5min by default)

=== Basic Commands (Not needed when using webinterface) ===

connect <ip> <gpw> <ettvpw>
--Creates a new recorder and connects it to this server

gamename <recid> <name>
--Sets the name of the currently running game on a recorder

recordmode <recid> <mode>
--Sets the recordmode for a recorder, the following modes are currently supported.
--ready - recording starts once 4 players are ready
--connect - recording starts as soon as the recorder is connected

--Remark to recording: Recording stops when less than 50% of the players the game started
--with remain on the server, it resumes when 2/3 of those players rejoin.
--Please do not forget to kill your recorders even if they paused recording

livecast <recid> <repid>
--Tells a replayer that it should replay whatever that recorder will be recording
--If the replayer is not running at the point that the recorder starts recording it will not work

broadcast <slots> <port> <privateslots> <gameid> <config>
--Starts a new broadcaster - you can omit everything except slots

killrec <recid>
--kills a recorder after broadcast

killrep <repid>
--kills a replayer for whatever reason

quit_rly
--shuts down everything cleanly - better than killing the process

reloaddemos
--reloads the demolist from disk in case you deleted some or whatever

demolist
--shows a list of all recorded games

viewerlist <repid>
--shows some info about connected viewers

playgame <repid> <gameid>
--plays a certain game

nextmap <repid>
--jumps to the next map - if it was the last map of the game it will chose the next game in the reply cycle
--if you do this in live broadcast mode you will leave the live broadcast, because we cant jump into the future !!

autoreplaynum <repid> <number>
--the number of recent games the replayer will automatically replay

serverlist
--shows all server processes currently managed by ettvd

debug <1/0>
--turns debug information on or off

There are more functions used by the webinterface - if you really care, please check the
sourcecode of ettvd.php - commands are pretty easy to understand

ETTVd

2006-11-28T02:53:42Z

Arni:

<table width="98%" cellpadding="0" cellspacing="0">
<tr>
<td colspan="2">
<div style="border:1px solid #AAAAAA; padding:0em 1em 1em 1em; background-color:#F9F9F9;">http://arni.name/etpro/ettvd_small.png
ETTVd is a control daemon for ETTV servers and manages your live broadcasts, demos and and replays. It's completely written in PHP
</div>
</td>
</tr>
<tr>
<td width="50%" valign="top">
<div style="margin-right:10px; margin-top:5px; border:1px solid #AAAAAA; padding:0em 0em 0em 1em; background-color:#F9F9F9;">
'''Download:'''<br>
[http://arni.name/etpro/ETTVd_b2.zip ETTVd Beta2]<br />
    [http://eicher.homelinux.com/ettvd/ETTVd_b2_repack.zip Mirror 1] (Eicher)<br />
    [http://eraser.homelinux.com/kai/etpro/ETTVd_b2.tar Mirror 2] (engee)
</div>
<div style="margin-top:10px; margin-right:10px; padding:0em 0em 0em 1em; border:1px solid #AAAAAA; background-color:#F9F9F9;">
'''Quicklinks:'''<br>
* [[ETTVd:commands]]
* [[ETTVd:Readme]]
* [[Requirements]]
* [[ETTVd:Known_Bugs]]
</div>
</td>
<td width="50%" valign="top">
<div style="margin-top:5px; border:1px solid #AAAAAA; padding:0em 1em 1em 1em; background-color:#F9F9F9;">
'''Feature Summary:''' ([[Features|entire list]])
* Replay of recorded games
* Multiple broadcast servers showing the same or different games in Live, Semi-Live or Replay mode.
* Announcer for next game, current game both ingame and in sv_hostname
* Spam protection with a sticky mute system (/reconnect doesnt help)
* Display of intermediate maptimes
* Ingame admin commands !mute, !kick, !reclist, etc
* Simultanious recording of as many games as you want (limited by cpu/ram)
* Constantly maintaining the correct ettv_delay
* Start of recording when enough players are ready
* Recording pause when players leave the server
* Disconnect from matchserver after timeout
* Fully painless matchserver crash recovery
* Recovery of all sorts of ettv broadcaster crashes (replayers continue where they crashed)
* Complete demo management for archiving
* Replay Playlists or playing specific games again
* Maximum recorders, replayers, slots that can be spawned from the control interface
* A fully featured webinterface (by skooli)
* Most settings configurable in a single file
* ETTVoD ready
</div>
</td>
</tr>
</table>

ETTVd

2006-11-28T02:50:53Z

Arni:

<table width="98%" cellpadding="0" cellspacing="0">
<tr>
<td colspan="2">
<div style="border:1px solid #AAAAAA; padding:0em 1em 1em 1em; background-color:#F9F9F9;">http://arni.name/etpro/ettv.png
ETTVd is a control daemon for ETTV servers and manages your live broadcasts, demos and and replays. It's completely written in PHP
</div>
</td>
</tr>
<tr>
<td width="50%" valign="top">
<div style="margin-right:10px; margin-top:5px; border:1px solid #AAAAAA; padding:0em 0em 0em 1em; background-color:#F9F9F9;">
'''Download:'''<br>
[http://arni.name/etpro/ETTVd_b2.zip ETTVd Beta2]<br />
    [http://eicher.homelinux.com/ettvd/ETTVd_b2_repack.zip Mirror 1] (Eicher)<br />
    [http://eraser.homelinux.com/kai/etpro/ETTVd_b2.tar Mirror 2] (engee)
</div>
<div style="margin-top:10px; margin-right:10px; padding:0em 0em 0em 1em; border:1px solid #AAAAAA; background-color:#F9F9F9;">
'''Quicklinks:'''<br>
* [[ETTVd:commands]]
* [[ETTVd:Readme]]
* [[Requirements]]
* [[ETTVd:Known_Bugs]]
</div>
</td>
<td width="50%" valign="top">
<div style="margin-top:5px; border:1px solid #AAAAAA; padding:0em 1em 1em 1em; background-color:#F9F9F9;">
'''Feature Summary:''' ([[Features|entire list]])
* Replay of recorded games
* Multiple broadcast servers showing the same or different games in Live, Semi-Live or Replay mode.
* Announcer for next game, current game both ingame and in sv_hostname
* Spam protection with a sticky mute system (/reconnect doesnt help)
* Display of intermediate maptimes
* Ingame admin commands !mute, !kick, !reclist, etc
* Simultanious recording of as many games as you want (limited by cpu/ram)
* Constantly maintaining the correct ettv_delay
* Start of recording when enough players are ready
* Recording pause when players leave the server
* Disconnect from matchserver after timeout
* Fully painless matchserver crash recovery
* Recovery of all sorts of ettv broadcaster crashes (replayers continue where they crashed)
* Complete demo management for archiving
* Replay Playlists or playing specific games again
* Maximum recorders, replayers, slots that can be spawned from the control interface
* A fully featured webinterface (by skooli)
* Most settings configurable in a single file
* ETTVoD ready
</div>
</td>
</tr>
</table>

ETTV:Viewer's Guide

2006-06-27T12:37:05Z

Arni: /* Known Issues */

== ETTV Viewer's Guide ==
=== Introduction ===
ETTV is a modification that allows anybody to spectate Enemy Territory matches without actually being on the server the teams are playing on. The purpose is so that you have have thousands of people all able to watch an exciting match live, without being able to interfere or otherwise cause problems with the match.

The ETTV modification is supplied within the ETPro modification, you do not need any further modification unless you intend to run an [[ETTV:Server_Configuration|ETTV Server]].

=== Watching ETTV ===
Simply connect to an ETTV server like any other Enemy Territory server. Once you are connected it will look and feel very much like you are in spectator mode on any normal server.

There are some issues which occur frequently enough to make it worth noting here, however.

* ETTV servers frequently do not allow clients (that's you/your game) to auto-download any missing files. You should try to ensure you '''have the correct patch, modification and custom map versions before you join'''. This is usually, but not necessarily the latest official version. If you do not have the correct versions you may be unable to join, or disconnected at some point during viewing.

* '''Do not be concerned about interfering with the match''', you cant. The ETTV server you join is essentially playing a live demo of the match which is actually being played on another server. You can spectate freely and talk crap with the other viewers on the same ETTV server, thats it. Chat from ETTV viewers is distinguished from chat in the match by the red "ETTV" preceding it.

* '''Connecting via IP address''' (command-line or console) is identical to any other Enemy Territory server. If you've been given the IP address of an ETTV server and are wondering what to do with it, open the console (usually by pressing the key under ESCape, often the ~ or ` key) and use the following command (including the forwardslash) - <tt>/connect ip.add.ress:port</tt>
:(for example: <tt>/connect 62.75.178.112:27962</tt>)

=== Additional Controls ===
* cycle between everybody on the server (who shows up on the scoresheet)
:fire <tt><Left Mouse button></tt>
* cycle following only objective carriers
:Prone + (fire / altweapon) <tt><X + LeftMouse></tt>
* cycle following only spectators / shoutcasters
:Zoom + (fire / altweapon) <tt><nowiki><B + LeftMouse></nowiki></tt>
* Jump directly to following a player in view
: Press activate while pointing crosshair at player
* return to free floating mode.
: Press jump or activate <tt><Spacebar></tt>

=== Generally Useful Tips ===
* Chats from other ETTV spectators can be hidden with the console command <tt>/tvchat off</tt>, and re-enabled with <tt>/tvchat on</tt>. All chat done on ETTV won't be seen on the game server (luckily). If certain chatters start to irritate you, you can easily ignore specific people with the <tt>/ignore</tt> command and can use the <tt>/unignore</tt> command to show their chat messages again.

* To spectate a specific player through their eyes, open console and put in the command <tt>/players</tt>, and notice the player number. Now just <tt>/follow x</tt>. If you're new to Enemy Territory, you might find it most entertaining to follow a shoutcaster, if there is one.

* Viewing ETTV in a window can be convenient while you find other IP's, talk in IRC, or access WinAmp, for example. To do this, you can go to the options screen and set a resolution which is smaller than your desktop screen resolution, and then select windowed mode. Alternatively, enter <tt>/r_mode 3</tt> into console, and then hit ALT+Enter.

* Normal cvar restrictions dont apply when viewing demos, nor do they (usually) when viewing ETTV. This is OK because you're not playing against anyone. Several leagues remove the foliage (all the grassy stuff) on Radar because it hurts performance and, some say, isnt good for competitive gaming. As an ETTV viewer you can remove it via console: <tt>/r_drawfoliage 0</tt>. To further incrase performance you can remove wolffog (an effect which "adds" fog to the map, sometimes restricting the viewing distance [e.g. Railgun]) by setting <tt>r_wollfog 0</tt>. You might want to ensure that is reset to 1 before you join a normal gameserver however.

* ETTV is generally not live; normally a few minute long delay is added so competing teams cannot have another member watching and sending participants advantagous information.

== Shoutcasts ==
A [http://en.wikipedia.org/wiki/Shoutcast shoutcast] is essentially a match commentary, broadcast over something akin to internet radio. The shoutcaster is usually someone heavily involved with the ET community and listening to the shoutcast greatly enhances the entertainment value of ETTV.

A shoutcast is completely seperate from ETTV however, to listen to a shoutcast you will need to open the URL with a suitable program - [http://winamp.com/ WinAmp] being one of many such programs. The shoutcast URL is often available at the same place you found the ETTV details for the match you want to watch.

Like ETTV, shoutcasts are usually not totally live - normally a few minutes delay is added so competing teams cannot have another member watching or listening in and sending participants advantagous information. Typically ETTV has a longer delay than the shoutcast does, so the result is ETTV and shoutcast are out of sync.

Fortunately it isnt the other way around, because you can pause WinAmp to syncronise the two. Simply listen for some event in the shoutcast (often shoutcaster will read out the time on the clock for this purpose, or you can listen for event's like 'FIGHT!' or 'dynamite planted') and immediately hit pause. When the event occurs in ETTV, hit play again. This can be easier if you view ETTV in windowed mode, also if you make a mistake and pause WinAmp for too long, reconnect to the shoutcast URL.

== Replaying ETTV demos on a local Windows server ==

If you have ETTV Demo files (*.tv84), you can watch them locally on your windows machine. in order to do so, you will need a ETTV-Server. Download the latest version (currently: http://returntocastlewolfenstein.filefront.com/file/ETTV;52030) and proceed with the following steps:

* Extract all files except <i>tvgame.mp.i386.so</i> into your "Wolfenstein - Enemy Territory" root directory (<b>not</b> etmain).
* The <i>tvgame.mp.i386.so</i> file goes into the etpro directory.
* Put the *.tv_84 files in your <i>etpro\demos</i> directory
* Create a shortcut to ETTV.exe (Right click in explorer windows, "new..." -> "Shortcut").
* Change the program call in the shortcut (Right click, "Properties") to: '<i>"path</i>\ettv.exe" +set fs_game etpro +set ettv_autoplay 1 +demo demo0000'

When you double click on the shortcut, ETTV should come up displaying a console and starting the playback. Note that the demo files are required to be named like <i>demo0000.tv_84, demo0001.tv_84, etc.</i> in order to work like this. The server will autoplay all demos in successive order. You can now start your ET and connect to your local server (choose "Internet Play", then "connect to IP" <i>127.0.0.1</i>.

==== Known Issues ====

You have to install the complete etpro package for servers - the pk3 file that clients have is not enough.

I have discovered client error "MAX_GAMESTATE_CHARS" on several demos: The ETTV seems to run fine but local clients get kicked for that reason. I have not yet found why this happens, nor a solution. Any hints on that would be helpful.

This short How-To was written on request for gamestv.org, they are hereby permitted to use this text on their own site.

== External Links ==
* [http://www.gamestv.org/ GamesTV.org] is an ETTV listings site.
* [http://www.radioitg.com/schedule.php Radio iTG's schedule] is a source of shoutcasts.

[[Category:ETTV]]