Autorun - Quick Divx Starter
by theorica
Version 1.2.5.0
http://www.theorica.net
e-mail:  theorica@gmail.com


ABOUT:
======
Autorun (Quick Divx Starter) is a *FREE* utility that scans
its directory (or CD), and executes predefined commands when
you press Player(s) buttons.

This software is specifically designed for the Lazy people. :-)

You just copy the Autorun to the folder where the movie is 
placed and press button to watch the film.

If the folder or CD contains any picture file (acceptable 
formats are JPG, GIF or BMP), Autorun uses it as film's poster.

If the folder or CD contains any text file (acceptable file
extensions are TXT, SUB or SRT) that has the same name with 
divx file, the Autorun accept it as a subtitle file.

Simply, you can press the button and watch the film.


INSTALL:
========
Copy Autorun.exe (and autorun.inf optionally) to the folder 
where the movie is placed.


PREPARE:
========
First, you must copy the file Autorun.exe to the folder
which contains your DIVX file. You can also copy VPlayer and
BSPlayer files to this directory.
These files are:
- VPlayer.exe (VPlayer executable file)
- bplay.exe (BSPlayer executable file)
- bsrendv.dll (BSPlayer library file)
Optional files:
- vplayer.ini
- bplay.ini
Or you can use "Select Player" button to launch your favorite
player.


HOW IT WORKS:
=============
When Autorun executed 

- it scans directory or CD where it is.

- It checks Vplayer.exe or bplay.exe, if they are exist, the play 
  buttons are enabled.

- If the folder or CD contains any picture file (acceptable 
  formats are JPG, GIF or BMP), Autorun uses it as film poster.

- If the folder or CD contains any text file (acceptable file
  extensions are TXT, SUB or SRT) that has the same name with divx file,
  the Autorun accept it as a subtitle file.

- If the folder or CD contains the file any text file (the file 
  extension must be "NFO"), Autorun uses it as title release information
  and it enables "Show Info" button. Otherwise this button is not visible.
  
- if the folder or CD contains VPlayer or BSPlayer, it enables its
  "play" buttons.

- if VPlayer button is enabled, you can press VPlayer button 
  and it runs VPlayer with predefined parameters (full screen, 
  auto pan etc.).If you add a section in Vplayer.ini as:

  [QuickDivxStarter]
  Param=/F /A /P55

  Vplayer uses these values as a parameter. 

- if BPlayer button is enabled, you can press BPlayer button 
  and it runs BPlayer with predefined parameters (full screen, 
  auto pan etc.). If the folder or CD contains the file "bplay.ini",
  Autorun uses it as parameter file.

- The configuration file (called autorun.ini) is read from where 
  Autorun is located if it exists when Autorun starts up.
  If you add a section in autorun.ini as:

  [Options]
  Language=French

  Autorun uses these values as a language directive.

  Or alternatively you can set the language from the About box 
  (the selection is written in registry).


- If you add a section in autorun.ini as:

  [Options]
  ButtonTitle=Load Codecs
  ButtonRun=codecs\DivX511.exe

  Autorun uses these values to change "Select Player" button. 
  The text of Select Player button changes to "Load Codecs" and then 
  it executes "DivX511.exe" in the folder "codecs" if pressed.

  Another example:
  [Options]
  ButtonTitle=All Player
  ButtonRun=ALLPlayer.exe
  ButtonParam=Guru.avi FULLSCREEN

  When Autorun starts, the text of "Select Player" button is changed
  to "All Player" and starts the movie file (for example Guru.avi) 
  as fullscreen mode if you press this button. 

- If you add a section in autorun.ini as:
  [Options]
  Picture=DATA\movie_poster.jpg
  Autorun uses these values to use (display) as a film poster. Another example:
  [Options]
  ButtonTitle=Start
  ButtonRun=DATA\Vplayer.exe
  ButtonParam=Guru.avi /F
  Picture=DATA\guru_poster.jpg
  When Autorun starts, the text of Select Player button is changed to Start 
  and starts the movie file (for example Guru.avi) as fullscreen mode if you 
  press this button. Also it shows the file DATA\guru_poster.jpg as a film 
  poster. 

- If you add a section in <span class=prg>autorun.ini</span> as:
  [Options]
  Title=Star Trek VI - The Undiscovered Country
  Autorun uses these values to use (display) as the film title which will work 
  with right button menu commands.
  For example:
  [Options]
  ButtonTitle=Start
  ButtonRun=DATA\Vplayer.exe
  ButtonParam=Guru.avi /F
  Picture=DATA\guru_poster.jpg
  Title=GURU


ADVANTAGES:
===========
- Easy! You just put the file onto CD or any folder where movie is placed.

- It is not necessary to describe the autorun and write a movie title there,
  Autorun get the information from movie filename and it deletes crap 
  words (like DivxSCR, DVL-verified etc.) and shows properly. For instance;
  if movie filename is:
    "Cradle.2.The.Grave.DVDSCR.XViD-DVL.avi"
  in Autorun screen
    "Cradle 2 The.Grave" is displayed as movie title.

- It has not any DLL or another file(s). It is just a single "EXE" file: Autorun.exe

- No installation necessary.

- Size is acceptable to fit in free space in your movie CD.

- It handles picture, subtitle and info files automatically.

- If you have internet connection, you can simply press movie image (poster) or title
  and get the movie information from IMDB.


AN EXAMPLE OF AUTORUN.INI (optional)
====================================
  [Options]
  Language=English

  ButtonTitle=Start
  ButtonIcon=Data\start.jpg
  ButtonRun=Data\Vplayer.exe
  ButtonParam=Guru.avi Guru.srt /F /A /P55

  ButtonTitle2=All Player
  ButtonIcon2=Data\all.gif
  ButtonRun2=Data\ALLPlayer.exe
  ButtonParam2=Guru.avi FULLSCREEN

  ButtonTitle3=Load Codec
  ButtonIcon3=Data\a.jpg
  ButtonRun3=Data\XviD_Install.exe

  Picture=Data\guru_poster.jpg
  Info=Data\New Text Document.txt
  Title=GURU


TECHNICAL INFORMATION:
======================
- Picture and/or "NFO" files can have any name (it takes the first
  in alphabetical order). The program does not suppose there are more 
  than one movie on each folder or CD.
 
- Picture file can be JPG, GIF or BMP format and any size. But it is 
  stretched into 250x350 (Width x Height).

- You can use "Select Player" button to play your favorite player if you 
  want, or you can rename it to Vplayer.exe or Bplay.exe. So, when you 
  press "VPlayer" button, Autorun executes VPlayer.exe like this:
    - VPlayer.exe <avi_file>
    or if there is any suitable subtitle file
    - VPlayer.exe <avi_file> <subtitle_file>

- BPlayer button is also run in the same way:
    - bplay.exe <avi_file>
    or if there is any suitable subtitle file
    - bplay.exe <avi_file> <subtitle_file>
    or if there is a "bplay.ini" file
    - bplay.exe <bplay.ini>


RECOMMENDED SITES:
==================
http://www.theorica.net
http://www.divx-digest.com/software
http://www.doom9.org

VPlayer web site:
http://www.vplayer.albion.top.pl

BPlayer web site:
http://www.bsplayer.org


APPENDIX A:
===========

Sample Vplayer.ini
Example Movie File: TEST.AVI
Example Subtitle File: TEST.TXT

----- BEGIN HERE -----
[Autorun]
FileNameMovie=TEST.AVI
FileNameSubtitles=TEST.TXT

[Fonts]
DistansOfBottom=0
FontName=Arial
FontSize=28
Colour=12648447
Style=nnnn
Charset=1
BorderColour=0
BorderWidth=8
IsAutoBorderWidth=1
RowsOfText=3
AutoSizeOfFont=1
MaxSizeOfFont=20
Transparent=1
HowManySec=4
TurnOffCursor=1
TurnOffCursorSec=3

[Play]
AutoPlay=1
CheckBoxScreensaver=1
CloseAfterPlay=1
AutoSize=1
AutoLoadSubtitles=1
PanScanPercent=15
SkipOnError=1

[Misc]
CheckForNewVersion=0

[View]
PanScanType=4
PanScanCustomZoom=3

----- END HERE -----


APPENDIX B:
===========
Sample bplay.ini
Example Movie File: TEST.AVI
Example Subtitle File: TEST.TXT

----- BEGIN HERE -----
[Movie]
Directory=.
FName=TEST.AVI

[Subtitles]
Title=
Directory=.
Sub1=TEST.TXT
DefaultSub=1
Font=162;Arial;28;0;12648447
FontColor=00C0FFFF


[Options]
FullScreen=1
PanScan=1
CPanScan=370
ExitAtEnd=1
----- END HERE -----


THANKS:
=======
Thanks to all for the suggestions and comments.


BUG REPORT:
===========
Before you e-mail me about possible bug, check my homepage and be
sure you have the newest version of the file. If you want to e-mail 
me, send me also your additional files (such as JPG, GIF, BMP, INI, 
NFO) version of Autorun and player(s). 


CONTACT:
========
If you have any questions, suggestions, bug reports or anything else,
feel free to contact me at theorica@gmail.com or visit the web site 
below:
http://www.theorica.net
