[introduction | installation and usage | example | customization | FAQ | download / changelog]
FAQ
Frequently asked questions
CONTENT:
========
- WHAT DO I NEED TO RUN VDRTUBE?
- HOW DO I DELETE A MOVIE FROM THE WEBTREE?
- HOW DO I SWITCH THE THEME OF AN EXISTING WEBTREE?
- HOW DO I MIGRATE TO A NEWER VERSION OF VDRTUBE?
- BEHAVIOR OF CONFIG.PL
- HOW DO I CONVERT A WHOLE SUBTREE OF VDR RECORDINGS?
- HOW DO I PROTECT MY (INTERNET-CONNECTED) WEBTREE FROM PUBLIC VIEWING
- WHICH BITRATE SETTINGS ARE BEST FOR MY CONNECTIONS?
- HOW DO I ADD MY OWN TAGS?
- MY VDR RECORDING DOES NOT CONVERT, WHAT DO I DO?
- HOW DO I EXPORT A SINGLE WEBTREE?
- HOW DO I MAKE CERTAIN PARTS OF THE RECORDING PATH INVISIBLE?
- HOW DO I CREATE MY OWN THEME?
- WHEN USING STREAMDEV WHILE CONVERTING I GET DROPS IN DISPLAY OF
  STREAMING CLIENT
  - HOW DO I USE THE SECOND AUDIOSTREAM
  - CAN I USE MY PSP / IPOD / WINDOWS MOBILE PDA TO VIEW VDRTUBE-VIDEOS?
  - CAN I USE THTTPD WITH VDRTUBE TO DELIVER THE FLASH VIDEOS?
  
  
  WHAT DO I NEED TO RUN VDRTUBE?
  
  In order to run vdrtube you need perl and a x86 CPU. 
  Everything else is included in the package.
  
  
  HOW DO I DELETE A MOVIE FROM THE WEBTREE?
  
  Just do something like 'rm webtree/601[.-]*' to delete all files of id 601
  and call the indexer with './helpers/indexer.pl'.
  
  
  HOW DO I SWITCH THE THEME OF AN EXISTING WEBTREE?
  
  Look into the directory themes/ to see which themes are available.
  
  Edit config/config.pl and change the current theme by editing the line
  with 'our $theme'.
  
  Call retheme.pl by executing 'perl helpers/retheme.pl'
  
  
  HOW DO I MIGRATE TO A NEWER VERSION OF VDRTUBE?
  
  Just move your config.pl, the whole webtree and the matching
recordings.csv
to new version and call 'perl helpers/retheme.pl' .

Example of upgrade from version 0.0.80a to 0.0.81a: 

  cd vdrtube-0.0.81a
    cp ../vdrtube-0.0.80a/config/config.pl config
      cp ../vdrtube-0.0.80a/data/recordings.csv data
        cp -r ../vdrtube-0.0.80a/webtree .
          ./helpers/retheme.pl
          
          
          BEHAVIOR OF CONFIG.PL
          
          To make sure everything works at first all variables from
          sub/config.pl.default will be loaded, if they are found in
config/config.pl
they will be overwriten from there. Otherwise the defaults are used.


HOW DO I CONVERT A WHOLE SUBTREE OF VDR RECORDINGS?

Feed your shell with something like 
  'find /video/XX/ -name \*rec -exec ./vdrtube.pl \{\} \;'
  and change /video/XX/ to the directory you like to be converted
recursively.


HOW DO I PROTECT MY (INTERNET-CONNECTED) WEBTREE FROM PUBLIC
VIEWING?

There are many ways to protect parts (or all) of your webtree from being
viewed by the public. The most common one is having a .htaccess where you
restrict login by username and password.

Please consult your webserver manual or simply use file:// urls to view your
tubes locally. (JavaScript won't work when using file://)


WHICH BITRATE SETTINGS ARE BEST FOR MY CONNECTIONS?

You can choose any bitrate you like. If the bitrate is higher than your
upstream bandwidth just let the player buffer the stream before you start to
play it. As a rule of thumb you can use the following table (done by Ulf and
eule). videobitrate is by rule of thumb the value if your audiostream has
64kbit/s. The bitrate options are configurable via config.pl.

Typical contract name   max.upload bandwidth            videobitrate
DSL 384                 64                              --
DSL 768                 128                             45
DSL 1000                128                             45
DSL 2000                192                             99
DSL 3000                256                             154
DSL 4000                386                             264
DSL 6000                576                             426
DSL 16000               1024                            806
SDSL 512                512                             371
SDSL 1024               1024                            806
SDSL 2048               2048                            1677

(max.upload - overhead [ca 15%] - audiostream = videobitrate)


HOW DO I ADD MY OWN TAGS?

Simply edit config/tags.dat. It contains a list of tags, one by each line.
Please do not use any special characters since the tags are also used to
create the filename of the corresponding index.


MY VDR RECORDING DOES NOT CONVERT, WHAT DO I DO?

If the recording is not found it may be a matter of correctly quoting the
filename.

Sometimes using quotation marks is a good idea in this case. 

Example:

   perl vdrtube.pl

"/video/@Asphalt-Cowboy_Spielfilm_USA_1968_(Midnight_Cowboy)/2007-09-08.23.42.99.99.rec"

If you still have problems, then most likely the recording is not intact.
VDR is very acceptive about incorrectable streams and data files, ffmpeg is
not.

You could try to transcode your recording to valid MPEG using ProjectX (or
other software). 

Sometimes it even helps to use a different audio track.


HOW DO I EXPORT A SINGLE WEBTREE?

Convert the movie as you are used to by calling vdrtube.pl with the
corresponding recording. Then decide if you want the small or large version
exported. Copy the files named ID* from the webtree/ directory to your
target directory and rename ID.html or ID-huge.html to index.html. Also copy
the files from sources/player. You now have a webtree with only a single
movie.


HOW DO I MAKE CERTAIN PARTS OF THE RECORDING PATH INVISIBLE?

In the config/ directory you will find a file called 'titlecleanup.dat'. It
contains a set of strings (one on each line) which are made invisible when
creating the HTML-Files. To make sure that your pattern matches you better
put it in front of the existing patterns, since patterns are executed one
after the other.


HOW DO I CREATE MY OWN THEME?

There is a seperate Documentation at doc/THEMES


WHEN USING STREAMDEV WHILE CONVERTING I GET DROPS IN DISPLAY OF
STREAMING CLIENT

Instead of calling vdrtube.pl directly you could use renice. Try something
like 'renice -n 19 ./vdrtube.pl path-to-recording'.


HOW DO I USE THE SECOND AUDIOSTREAM
 
 Call vdrtube like this:
 
       perl vdrtube.pl -map 0.0 -map 0.2
/video/path/to/recording/datestring.rec

This will use the video stream (always 0.0) and the audio stream with ID 0.2
for the output flv-file.

If you don't like trial and error games and want to see which audio streams
are available in the recording you can convert the movie and have a look at
the logfile while converting.


CAN I USE MY PSP / IPOD / WINDOWS MOBILE PDA TO VIEW VDRTUBE-VIDEOS?

Yes, this is possible. Several ways are mentioned in doc/DEVICES. If you get
it to run on other devices please let us know!


CAN I USE THTTPD WITH VDRTUBE TO DELIVER THE FLASH VIDEOS?

No, thttpd seems to be outdated and it was not even possible for us to force
it delivering the correct Content-Type of the .flv-files by patching the
sourcecode.

Path: vdrtube -> introduction