Difference between revisions of "Reporting unknown MD5 checksums"

Jump to navigation Jump to search
Wikifying the page into groups
(Wikifying the page into groups)
Line 1: Line 1:
This page contains instructions on what to do if you got a version of a game that the ScummVM team is not aware of (perhaps a rare version, or a less known one, or perhaps an unknown non-English version). In such cases, here's what you can do to get your version supported under ScummVM:
This page contains instructions on what to do if you got a version of a game that the ScummVM team is not aware of (perhaps a rare version, or a less known one, or perhaps an unknown non-English version). In such cases, here's what you can do to get your version supported under ScummVM.


To get the MD5 sums:
==From ScummVM==
* The easiest way would be to check the ScummVM console window, which will report the unknown MD5s you got. If you can't see the console window, you can redirect ScummVM's output to a text file, by running ScummVM as follows:
 
The easiest way would be to check the ScummVM console window, which will report the unknown MD5s you got. If you can't see the console window, you can redirect ScummVM's output to a text file, by running ScummVM as follows:
  scummvm > file.txt
  scummvm > file.txt
* If for some reason you can not see ScummVM's window or do not get any output in the text file, you need to follow an a bit harder process. The MD5-based detection in ScummVM uses the first bytes of each file to determine its MD5 checksum. This is necessary to speed up the detection process and to avoid having to calculate the MD5 checksums of large files, which would make game detection very slow.
 
If for some reason you can not see ScummVM's window or do not get any output in the text file, you need to follow an a bit harder process.
 
==Manually==
 
The MD5-based detection in ScummVM uses the first bytes of each file to determine its MD5 checksum. This is necessary to speed up the detection process and to avoid having to calculate the MD5 checksums of large files, which would make game detection very slow.
Each engine in ScummVM uses a different number of bytes to calculate their MD5 checksums.  
Each engine in ScummVM uses a different number of bytes to calculate their MD5 checksums.  


Line 16: Line 22:
[[Queen]], [[Sky]], [[Sword1]], [[Sword2]] use a different detection.
[[Queen]], [[Sky]], [[Sword1]], [[Sword2]] use a different detection.


To get the correct MD5 checksum, run the following:
To get the correct MD5 checksum, run the following


'''Under *nix (including Mac OSX):'''
===Under *nix (including Mac OSX)===
   head -c size file | md5sum
   head -c size file | md5sum


'''Under Windows''', download [http://md5deep.sourceforge.net/ md5deep]
Where <code>size</code> depends on the engine, as described above.
and run it like this:
 
===Under Windows===
 
Download [http://md5deep.sourceforge.net/ md5deep] and run it like this:
   md5deep -p size file | find /i "offset 0-"
   md5deep -p size file | find /i "offset 0-"


Where ''size'' depends on the engine, as described above.
Where <code>size</code> depends on the engine, as described above.
 
Alternatively, you can download the [http://gnuwin32.sourceforge.net/packages/coreutils.htm gnuwin32 coreutils] and run the *nix command above. You will need <code>head.exe</code>, <code>md5sum.exe</code>, and the two libraries from the dependency package.


Alternatively, you can download the [http://gnuwin32.sourceforge.net/packages/coreutils.htm gnuwin32 coreutils] and run the *nix command above. You will need head.exe, md5sum.exe and the two libraries from the dependency package.
==Submitting the MD5 Checksum==


After you get the MD5 sums of the game files, you can report them by using our [https://bugs.scummvm.org bug tracker]. It is much preferred over a post in the forums.
After you get the MD5 sums of the game files, you can report them by using our [https://bugs.scummvm.org bug tracker]. It is much preferred over a post in the forums.


Also to speedup things, please consider providing directory layout of your game.
Also to speedup things, please consider providing directory layout of your game.
TrustedUser
567

edits

Navigation menu