Debug log

From MrMC Wiki
Jump to: navigation, search

Parent topic: Reporting bugs


1 Enable debug logging
The normal log file doesn't contain debugging information by default. To capture this information to the log you must first enable debug logging:
In MrMC home screen -> Settings (the "gear" icon on touch devices) -> System -> Logging and turn on Enable debug logging. Settings level needs to be set to Standard
Enable logging.jpg
2 Enable the web server
To make it easy to access the log file from another computer on the same network, enable the built-in web server:
In MrMC home screen -> Settings (the "gear" icon on touch devices) -> System -> Services and turn on Allow Remote control via HTTP
Enable server.jpg
3 Find your IP address
IP address TV.jpg
TV users

From MrMC's home screen, move over to the "System" tab and then select the lower-menu item called "System information". Note the IP address listed under "General".

IP address touch.jpg
Touch screen users

From MrMC's home screen, tap the system settings "gear" icon. Then tap the "i" icon. Note the IP address listed under "General".

4 Restart MrMC
In order to record valuable startup information in the log, please quit MrMC completely and then re-open the program. The easiest method would be to simply restart your device.
5 Capture the problem
Once MrMC has started back up, give it a minute to "settle down", as various processes occur on a fresh startup. Then proceed to do whatever it is that triggers the bug or issue you are reporting. For example, if playing back a video causes an issue, play back that video.
6 Download the log
Web UI log.png
Using the IP address you got from Step 3, go to another computer on the same local network and type in

http://IPADDRESS:8080

Where IPADDRESS is the number you got before. For example, if your IP address was 10.0.0.5 you would to go http://10.0.0.5:8080

Here you can access your current log file.

Old log

Sometimes you might be asked for the "old log". Simply use the "old log" button for this. The MrMC log is reset each time MrMC is started, and the "old log" contains the log from the previous session.

7 Posting your log file online
Pastebin.png
Pastebin2.png
Select and copy the whole log from your web browser. Then go to a paste website such as http://pastebin.com and make a new "paste" by pasting the log and submitting. Note the URL of your new log paste and give that link to whoever asked for your log.
8 Turn off debug logging
In MrMC home screen -> Settings -> System -> Logging and turn off Enable debug logging

Optionally, you can also turn off the web server if you do not use it for other features:

In MrMC home screen -> Settings -> System -> Services and turn off Allow Remote control via HTTP