Installation¶

Installation procedure¶

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:
  

  cd qtv/trunk

• Type make and press enter and wait for compilation to finish.
• After the compilation make directory for QTV in your homedir, for example:
  

  mkdir qtvproxy

• 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 94.23.221.104:27501
qtv 94.23.221.104: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.