There are three possible ways to install QTV. The first way is to get a pre-compiled package from QTV download page and just extract the package somewhere. The package should contain proper directory structure, required files and an example config.
The second way is to use SVN and get example-configs from QTV SVN. This procedure is explained at the bottom of the page.
The third way is to get sources from the SVN repository (http://qw-dev.net/projects/qtv/repository) and compile the binary yourself. After this you still need to make proper directory structure and copy few files from the SVN directory. The next part explains how to make QTV from SVN sources.
Using SVN (the hard way)¶
You need to have SVN client installed before taking this route. In Debian you can install it by typing apt-get install subversion and in Gentoo you can do it by typing emerge subversion. You need to check your distribution's instructions for more detail on how you can install SVN. So, let's start installing the QTV using SVN command by command.
- Use the following command to get the sources from SVN:
svn co http://qw-dev.net/svn/qtv qtv
- Go to the sources directory by typing:
- Type make and press enter and wait for compilation to finish.
- After the compilation make directory for QTV in your homedir, for example:
- Copy qtv.bin to this directory from qtv/trunk directory.
- Make another directory called qtv in qtvproxy directory.
- Copy files: qtvbg01.png, style.css, save.png and stream.png from qtv/trunk to qtvproxy/qtv directory.
- Also copy levelshots directory and all its contents from qtv/trunk to qtvproxy/qtv directory.
- Create qtv.cfg file in qtvproxy directory. You should add at least following info in the qtv.cfg
mvdport 28000 hostname whatever QTV admin_password youradminpasswordhere maxclients 100 maxservers 100 floodprot 4 2 2 allow_http 1
- Also qtv.cfg can contain download related items if you want people to be able to download through QTV.
allow_download_other 1 allow_download_demos 1 allow_download_maps 1 allow_download_sounds 1 allow_download_models 1 allow_download_skins 1 allow_download 1
- You can add multiple servers here to be connected by QTV. Just add them as you like, a hostname or an ip-address can be used.
qtv quakeworld.fi:28001 qtv quakeworld.fi:28002 mypassword qtv 126.96.36.199:27501 qtv 188.8.131.52:27502 mypassword2
- Remember to increase the maxservers variable if you have more than hundred servers listed (default is 100). If not, save and exit your editor, you're done here.
- You should softlink id1 and demos directories from your QuakeWorld server directory so one can download stuff via QTV
- When looking to your QTV directory, it should look like this:
qtvproxy/qtv.bin qtvproxy/qtv.cfg qtvproxy/id1 (SOFTLINK!) qtvproxy/demos (SOFTLINK!) qtvproxy/qtv/style.css qtvproxy/qtv/qtvbg01.png qtvproxy/qtv/levelshots/*.jpg
- Now you can fire the QTV up by using the following command in the qtvproxy directory:
./qtv.bin +exec qtv.cfg
Getting EXAMPLE-CONFIGS from SVN (the easy way)¶
You will need to do two things to get things running. The first thing to do is:
svn co http://qw-dev.net/svn/qtv/trunk/example-configs qtvproxy
Now you got all QTV related files except QTV binary. You can either get the sources and compile one by yourself (example above) or get pre-compiled binary from our QTV files section. Don't forget to edit the qtv.cfg file to suit your needs and create those softlinks pointing to id1 and demos.