General Questions:
What is DivX Doctor II?
What are the requirements?
Do you have other recommendations?
How does it work?
Will I be able to watch Doctored DivX Movies on Windows?
Do I still need Windows Media Player 6.3?

Could you give me more information about:
The main batch window
Make Stand-Alone Movies
Auto-Run First Movie
Decompress Audio
Start
View Error Log
Clear Error Log
Preferences
Same as Input
Ask Where
Use Folder
Scratch Disk
Auto-Doctor
Fix AVI Filetypes
Process Non-AVIs
Quit When Done
Auto-Magic Doctoring
How Do I make AVI's Open Automatically?

Problems:
How Do I Play My Video With WMA Audio?
How do I install the WMA codec?
How Do I Play My Video With AC3 Audio?
How Do I Play 'MP42' Video? (often known as "I Just Get A White Screen?")
I Just Get A White Screen?
AVI2MOV
DivX Validator
AVI MovieImport
AVI File Extensions and Filetypes
Seeking Is Slow
I Get Weird Errors!
The Application Unexpectedly Quits with a Type 3 Error
How Do I check which version of CarbonLib I have?
What Is A -223 Error And Why Am I Getting It?

Other Information:
Websites
Known Limitations
Support
Bugs


General Questions:
What is DivX Doctor II?
DivX Doctor II updates DivX .avi videos to 3ivx QuickTime (.mov) videos. After the conversion you will be able to play the video smoothly, and the audio glitches inherrant in the AVI format will be fixed. The conversion is fast.

DivX Doctor II also provides a number of other functions, which will be detailed later in this short note.

What are the requirements?
Mac OS 8.6 or greater (including Mac OS X)
CarbonLib 1.5
QuickTime
Hard disk space

Do you have other recommendations?
MacOS 9 or greater
3ivx MPEG-4 5.0 or greater
QuickTime 5 or greater
CarbonLib 1.5 or greater
a WMA codec (http://home.comcast.net/~appleguru/wmaaudio.sit)
mAC3dec 1.5.1 or greater (http://prdownloads.sourceforge.net/mac3dec/mac3ec1.5.2.sit.hqx?download)

How does it work?
Download the 3ivx MPEG-4 codec from http://www.3ivx.com, if you're using Mac OS X install as per directions.

Download a WMA codec (http://home.comcast.net/~appleguru/wmaaudio.sit), currently there is only a Mac OS 9 codec available, you should install it.

Open the DivX Doctor II application, drag your avi into the application window, press start...

If the DivX Doctor II beeps at you then the file was not an AVI

When the DivX Doctor II has finished Doctoring the AVI you can open it in QuickTime (or whatever media player you prefer) and view it, providing you've installed the 3ivx MPEG-4 codec.

Will I be able to watch Doctored DivX Movies on Windows?
By installing 3ivx D4 for Windows you will be able to play Doctored Movies in Windows Media Player (and any other DirectShow applications) and any QuickTime application.

Do I still need Windows Media Player 6.3?
No.


Could you give me more information about:
The main batch window
The Main Batch Window lists the currently queued AVIs. You can drag AVIs to this window to add them to the batch, you can also drag AVIs to DivX Doctor II's icon. By selecting an AVI in the batch list and then choosing Remove from the File menu, or by pressing delete, you can delete it from the batch. You can add AVIs to a batch while the batch is being processed.

Make Stand-Alone Movies
A stand-alone movie does not contain any references to the original AVI and is wholly contained. This means you can delete the original AVI if you want after the Doctoring process. Stand-Alone movies also cause less disk access during playback which results in better playback. Stand-Alone movies don't suffer from mp3 squeaks during playback.

If you untick Make Stand-Alone movies, then the resulting .mov will not contain the video track, but rather a reference to the original AVI, you should not delete the original AVI as it is required for successful playback.

Stand-alone movies are recommended.

Auto-Run First Movie
If ticked, the first Movie in the batch will be opened in QuickTime Player.

Decompress Audio
Decompress Audio will convert the audio track to uncompressed 44.1Khz 16bit Stereo sound (CD Quality). This is good in two situations.

If your machine is too slow to play your videos, but it has a fast hard disk (say SCSI) then by decompressing the audio you can avoid the real-time audio decompression during playback. On slow machines this can save up to 15%. On fast machines it's normally not a good idea.

The other major reason to decompress the audio is when the audio is compressed using the WMA codec. Essentially, to play WMA audio properly it needs to be decompressed first. The DivX Doctor II will always decompress WMA audio, but because WMA codecs are only available for OS9 you will have to carry out the Doctor process in OS9 (either Classic or OS9 proper).

In Mac OS X you can tell the DivX Doctor II to run as a Classic Application by using the Show Info panel in the Finder ( "Open in the Classic Environment" )

Start
Start will start the batch Doctor process. If a batch is already being processed Start becomes Cancel. Clicking Cancel will abort the batch processing (without losing your batch list).

View Error Log
The DivX Doctor II error log will be opened, usually with SimpleText or TextEdit. The error log is saved in your preferences folder with the name "DivX Doctor II Log.txt".

Clear Error Log
The error log will be cleared.

Preferences
The DivX Doctor II Preferences can be opened via the Edit menu in Mac OS 9 and via the "DivX Doctor II" menu in Mac OS X.

The Destination Preference controls where DivX Doctor II will save Doctored movies.

Same as Input
The Doctored Movie will be saved in the same folder or volume as the original source AVI, and with an intelligent name. If the folder or volume is locked (for example, when the original AVI is on a CD-ROM) then you will be prompted to choose a new location, and given the opportunity to modify the proposed filename.

Ask Where
You will be prompted where to save the Doctored Movie.

Use Folder
The Doctored movie will be saved into the folder specified. You can specify the folder by clicking on the path name.

Scratch Disk
The specified disk will be used for all temporary files. DivX Doctor II can require a large amount of scratch space to work correctly, and it should be on a fast disk for best results. You can choose a scratch disk by clicking "Scratch Disk:" or the current scratch disks name.

Auto-Doctor
The DivX Doctor II will automatically start doctoring as soon as an AVI is added to the batch list.

Fix AVI Filetypes
The correct filetype for AVI files is 'VfW '. DivX Doctor II will correct AVIs with the wrong filetype as long as this option is selected, and the AVI is not on a locked media (such as a CD-ROM). QuickTime sometimes requires the right file type in order to handle an AVI. "Fix AVI Filetypes" should always be selected.

Process Non-AVIs: The DivX Doctor will process files other than AVIs. There are a number of reasons you would want to do this. For example, the DivX Doctor II can be used as a batch QuickTime Movie flattener, or perhaps, you would like to Decompress the audio in a QuickTime Movie.

Quit When Done
The DivX Doctor II will Quit after it finishes processing the last AVI in the batch.

Auto-Magic Doctoring
By setting DivX Doctor II to Auto-Doctor, Auto-Run First Movie and Quit When Done, you can configure the DivX Doctor to behave as an automatic DivX Playback solution. It will automatically doctor, save and open in QuickTime Player, any AVI dropped on its icon, and then Quit. On Mac OS X you can set .avi files to open automatically with DivX Doctor II when double clicked.

How Do I Make AVIs Open Automatically?
In Mac OS X, select an AVI, choose Show Info from the Finder's File menu, then choose "Open with application…" from the Info Panel's popup menu. Next choose DivX Doctor II from the application popup menu (it looks like a square with an icon in it and a downward facing triangle), then press the Change All… button.


Problems:
How Do I Play My Video With WMA Audio?

1. Download and install the WMA codec (see http://home.comcast.net/~appleguru/wmaaudio.sit)
2. If you're running Mac OS X, then use the Finder's Info Panel to set DivX Doctor II to "Open in the Classic environment"
3. Drop your WMA on DivX Doctor II
4. Start the batch decode. The progress bar is deceptive for WMA audio, in actuality it only takes about a 12th the time the progress bar indicates.

The WMA codec might return an internalComponentError under Mac OS 8.6

How do I install the WMA codec?
Download the WMA codec from http://home.comcast.net/~appleguru/wmaaudio.sit

Copy the WMA codec to your "QuickTime Extensions" folder in your "Extensions" folder in your "System Folder". You should then restart.

How Do I Play My Video With AC3 Audio?
DivX Doctor II includes rudimentary AC3 support.

1. Download and install the mAC3dec application (http://prdownloads.sourceforge.net/mac3dec/mac3ec1.5.2.sit.hqx?download)
2. When prompted by DivX Doctor II, select a folder. DivX Doctor II will write an "audio.ac3" file into this folder, your machine may not respond until this has finished.
3. Use mAC3dec to decode the .ac3 file to either an AIFF or to an MP3
4. Using QuickTime Pro, extract the video track from the AVI, then add the AIFF or MP3 to it.
5. Save

How Do I Play 'MP42' Video? (often known as "I Just Get A White Screen?")

1. Download and install the WMA codec (see http://home.comcast.net/~appleguru/wmaaudio.sit)
2. If you're using Mac OS X, then you will need to use the Classic QuickTime player to play the movie.
3. If you're using Mac OS 9, then just double click your movie file... It will play in the QuickTime Player

The MP42 codec contained in the WMA codec works best when you Present Movie -> Normal.

I Just Get A White Screen?
QuickTime does not have a codec to play your Movie installed. See above.

AVI2MOV
AVI2MOV writes invalid QuickTime files, it also discards AVI keyframe information. It should only be used for extracting MP3 audio. If you set DivX Doctor II to "Process Non-AVIs" it will be able to correct QuickTime movies which were made with AVI2MOV. It will not be able to restore the lost keyframe information.

DivX Validator
If "Fix AVI Filetypes" is turned on DivX Doctor II should 'repair' AVI files which were 'validated' with this tool.

AVI MovieImport
The "AVI MovieImport" extension conflicts with QuickTime's AVI handling and should not be installed.

AVI File Extensions and Filetypes
The correct extension for an AVI file is ".avi". The correct filetype is 'VfW '.

Seeking Is Slow
DivX Doctor II preserves the keyframe information in an AVI. This forces the playback codec to seek to keyframes, resulting in more reliable video playback, but slower seeking.

I Get Weird Errors
DivX Doctor II requires a relatively large amount of disk space to perform its operations. The disk space is allocated in your Temporary Items folder, which is normally on the same disk as your System Folder. Ensure that you have enough space. DivX Doctor normally requires two times the size of the Doctored movie to work correctly. If you are decompressing audio then it could require a LOT more space than you might think, for example, one hour of uncompressed audio is about 605MB.

If your source DivX is corrupt then it will cause the DivX Doctor to generate errors, the most usual result is the sound drops out after the corruption.

If the AVI is extremely corrupted it could cause QuickTime to crash.

If your DivX is not complete, i.e. it's missing the end, then QuickTime Player will not be able to detect the keyframes. This would normally happen when an AVI hasn't been completely downloaded. You will probably not notice this using the 3ivx D4 codec.

The Application Unexpectedly Quits with a Type 3 Error
DivX Doctor II requires at least Mac OS 8.6 and CarbonLib 1.5 or greater, please check your CarbonLib version and your version of Mac OS

How Do I check which version of CarbonLib I have?
If you are not using Mac OS X then you will need to find the file "CarbonLib" in your extensions folder, in your system folder. Once you find it, select it, choose "get info" from the file menu, there's the version.

What Is A -223 Error And Why Am I Getting It?
-223 error is an siInvalidCompression error from the audio decoder, it means roughly that an invalid compression type was found.

If you received this error when trying to Doctor an AVI which contained a WMA audio track, then we have found a few work-arounds.

If you're using OSX, see if you have the WMA codec installed in your /Library/Quicktime folder, if you do, please delete it, it is NOT OSX compatible, and will cause these errors. You must install the WMA codec in your "QuickTime Extensions" folder in your Classic "Extensions" folder. You will need to restart Classic and use DivX Doctor II under Classic <http://www.3ivx.com/divxdoctor/faq.html#How Do I Play My Video With WMA Audio?>

If you're using OS9, then if you have the MPG4-DIVX, DIVX-MPG4, MPG4 or any other similar codecs installed in either your "Extensions" or "QuickTime Extensions" (in the "Extensions" folder) then you will need to delete them, and restart. These extensions caused problems with the DivX Player, and they are completely incompatible with the DivX Doctor II.

If you're using OS8.6, then the WMA codec does not appear to work, and will generate these errors.

If you are experiencing an error -223 and are not trying to Doctor an AVI with WMA audio then you probably have an AVI with abnormal audio compression, eg MS-GSM. People have found ways to decode these using VirtualDub running under VirtualPC <http://forums.3ivx.com/cgi-bin/ikonboard/topic.cgi?forum=2&topic=73#post6>. Please make arrangements with <doctorbugs@3ivx.com> to upload a sample movie and we'll see what we can do.


Other Information:
Websites
DivX Doctor II http://www.3ivx.com/divxdoctor
3ivx Codec http://www.3ivx.com
DivX Doctor II Forums http://forums.3ivx.com

Known Limitations
DivX Doctor II does not currently handle long filenames. They will be truncated to Mac OS 9 32 character hashes.

DivX Doctor II's AppleScript support is broken.

Support
This application is provided free of charge, please make use of the community forums provided at http://forums.3ivx.com

Bugs
If you find a bug, please send a detailed description to doctorbugs@3ivx.com. Emails to this address which aren't about bugs will be deleted, without replies.