Merge pull request #26 from LRomandine/main

Update Scanning-Issues.md
This commit is contained in:
Georges-Antoine Assi
2025-04-13 22:17:50 -04:00
committed by GitHub
+14 -1
View File
@@ -24,8 +24,21 @@ When scanning the folders mounted in `/library/roms`, the scanner tries to match
### Scan times out after ~4 hours
The background scan task times out after 4 hours, which can happen if you have a very large library. The easiest work around is to keep running scans every 4 hours, **without** checking the "Complete re-scan" option.
The background scan task times out after 4 hours, which can happen if you have a very large library. The easiest work around is to keep running scans every 4 hours, **without** checking the "Complete re-scan" option. You can also change the timeout via [environment variable](../Getting-Started/Environment-Variables.md) `SCAN_TIMEOUT`.
### Scan stops before finishing a platform
Check the logs for RomM, you should find a line that looks like `ERROR: [RomM][scan_handler][2025-04-12 11:48:55]` that explains why the scanner stopped. This can often happen due to a corrupted file or a file the [python zipfile library](https://docs.python.org/3/library/zipfile.html) cannot handle, such as old DOS zip files with backslashes instead of forward slashes.
### When scanning a very large library with many platforms it is difficult to keep track of which systems have scanned in
The easiest method is to check the logs via this command, which will list all the scanned platforms since the RomM container was started `docker logs romm 2>/dev/null|egrep 'scan_handler.*Identified as.*🎮'`
Here is an example output:
```text
$ docker logs romm 2>/dev/null|egrep 'scan_handler.*Identified as.*🎮'
INFO: [RomM][scan_handler][2025-04-12 11:37:40] Identified as PlayStation 🎮
INFO: [RomM][scan_handler][2025-04-12 14:39:32] Identified as DOS 🎮
INFO: [RomM][scan_handler][2025-04-13 12:50:42] Identified as WonderSwan 🎮
```