Generating error logs

If you’re having a problem with HDoujin Downloader, it is always very helpful to include an error log with your bug report. These logs contain information about what happened when the problem occurred, making finding the source of the problem and providing a bug fix much easier.

Log files are saved to a folder named “log” in the same folder as HDoujin Downloader, which is created when the first log file is created.

Enabling logging

Logs are not generated by default. To enable logging, click Help > Enable Diagnostics from the menu at the top of the program window.

 

Generating log files

The next step depends on the type of problem you are having. Find the option most applicable to you, and follow the instructions.

Pages or chapters aren’t downloading properly

If you’re having problems downloading from a particular site, enable logging as described above, and then add one or more of the affected URLs to the download queue. A log file will immediately be generated and saved to the log folder, named something similar to “[<date>] <website> added”.

Most of the time, this will be enough to address the problem and you can send this file by itself with your bug report.

If you see the message “some failed” after running a download, this means that some images or chapters could not be downloaded. You can see which pages failed by enabling the Create a text file listing missing/failed pages setting under Settings > Save to > Metadata.

This will create a “failed.txt” file in the download directory listing the missing pages. If this is relevant to your problem, it may be helpful to include with your bug report as well.

Something else isn’t working right

If you’re having problems with someone else, such as seeing error messages, enable logging as described above and perform the actions that caused the problem to occur. You will find a file named “debug.log” in the log folder that you can include with your bug report.

Sending your log files with your bug report

Once you have generated your log files, you can either send them by email (the contact email address is on the “About” of the program), or you can upload them to a file host of your choice and include a download link in the contact form.

After generating your log files, you may want to disable logging again by clicking Help > Disable Diagnostics to avoid generating unnecessary and excessive log files.