MediaPortal Wiki 
MediaPortal TestTool
Contents
What it is
Information
- This tool was designed to make testing and error reporting as easy as possible for you.
The TestTool is included in your MediaPortal installation (MPTestTool2.exe).
With the MediaPortal TestTool you will be able to export all necessary log files and system informations with only a few mouse clicks.
Alternatively you can still manually attach all log files to support and bug report threads, or upload them to our pastebin and attach the links to your report.
Features:
- Clears all log files before the test.
Starts MediaPortal in "debug-mode" (enables debug logging for this test run).
Exports Windows event logs, DXdiag info, list of installed Microsoft hotfixes and all MediaPortal log files.
- Exports all TV-Server log files (if installed on the same PC; single seat setup).
Saves all log files as one zip file to a configurable destination. (Default is Desktop.)
Automatically starts when MediaPortal crashes and allows you to export all logs.
Captures all created DirectShow graphs and creates JPEG's of them. (This requires the Vista SDK on Windows Vista.)
MediaPortal - Debug Mode Shortcut
When do you use it
When you want to reproduce an issue and create clean log files for your report, you start MediaPortal with the MediaPortal Debug Mode shortcut.
How does it work
The MediaPortal Debug Mode shortcut will start MPTestTool2.exe with the parameter -auto. (Auto means that the Test Tool will perform all actions automatically.)
- All log files get cleared/deleted
MediaPortal is started with log level set to debug for this test-run
After you successfully reproduced the error and closed MediaPortal, the TestTool will export all your logs to a zip file. (Default export location is your desktop.)
Manually starting TestTool
When do you use it
If you want to press the buttons on your own in contrast to the automatic version started with the "MediaPortal Debug Mode" shortcut then this is your way.
How does it work
Settings: Here you can set the export location of the zip file containing the logs. Default is the Windows desktop.
- All log files get cleared/deleted.
MediaPortal is started with log level set to debug for this test-run.
After you successfully reproduced the error and closed MediaPortal, the TestTool will export all your logs to a zip file. (Default export location is your desktop.)
After a crash
When MediaPortal crashes, then this will instantly trigger the TestTool to show up.
- All your log files will then be exported to the configured location. (Default export location is your desktop.)
What to do with the exported logfiles
If you are posting a support thread, please use the template posted in the HowTo: start an support thread announcement.
If you are posting a bug report, please use the template posted in the HowTo: report bugs announcement.
If you post test results based on a test plan, please use the template posted in the HowTo: Use the Testplan and Post the Results announcement.
1. To attach your zip file click on the Manage Attachments button under Additional Options
- 2. Head to your exported zip file and select it
3. Now click Upload
- 4. After that, your file has been uploaded to the server
Additional Information
Command-line parameters
The following command-line parameters can be used:
-auto: all actions will be performed automatically.
-crashed: a crash of MediaPortal is simulated.
-zipfile <path+filename>: specifies the location of the exported zip file.
DirectShow Graph capturing
TestTool is able to capture all created DirectShow graphs, and create a JPEG image of it.
- This works out of the box on Windows XP.
On Windows Vista it does not work out of the box, the reason is that Microsoft has (re)moved some resources. To get the graph capturing working, you will have to install the Vista SDK (1185.7 MB). (We are not allowed to distribute the required Vista SDK files with MediaPortal).
This means that if you encounter some video/audio issues when playing media in MediaPortal, you no longer have to download GraphEdit or DSGraphEdit to connect to the graph and find out which filters are used.
You only have to start MediaPortal with the MediaPortal Debug shortcut from your start menu and play the media file which causes troubles. After that the TestTool automatically creates a zip file which contains all logs and the JPEGs of the created graphs. This zip file can then be attached to your support thread in the forums, so other team and community members can have a look and help you with your problem.