Rules and MIA

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/laromicas/datoso/llms.txt

Use this file to discover all available pages before exploring further.

​

Rules System

​

System Rules Structure

{
  "company": "Sony",
  "system": "PlayStation",
  "system_type": "Console",
  "override": {
    "prefix": "Consoles/Sony PlayStation"
  },
  "extra_configs": {
    "some_setting": "value"
  }
}

• company: Manufacturer or company name (e.g., “Sony”, “Nintendo”)
• system: System or platform name (e.g., “PlayStation”, “NES”)
• system_type: Type of system (e.g., “Console”, “Handheld”, “Computer”)
• override: Configuration overrides for this system
• extra_configs: Additional system-specific settings

​

Rules Database

• File: systems.json in your DatosoPath (default: ~/.config/datoso/systems.json)
• Database: System table in the Datoso database
• Source: External JSON endpoint (configured in UPDATE_URLS.GoogleSheetUrl)

​

Updating Rules

# Update rules from remote URL
datoso config --rules-update

1. Downloads the latest rules from UPDATE_URLS.GoogleSheetUrl
2. Writes the data to systems.json
3. Truncates and reloads the System table in the database
4. Makes new rules available for processing

​

Rules Source Configuration

[UPDATE_URLS]
GoogleSheetUrl = https://laromicas.github.io/data/systems.json

# View current rules URL
datoso config --get UPDATE_URLS.GoogleSheetUrl

# Set custom rules URL
datoso config --set UPDATE_URLS.GoogleSheetUrl https://example.com/my-rules.json

​

Using Rules in Seeds

from datoso.database.models import System

# Get system configuration
system = System.get(System.system == "PlayStation")
print(f"Company: {system.company}")
print(f"Type: {system.system_type}")
print(f"Override: {system.override}")

​

Missing In Action (MIA)

​

What is MIA?

• It’s documented but not available in current DAT files
• It’s partially dumped or corrupt
• It’s known to exist but not yet preserved
• It’s been removed from distribution

​

MIA Data Structure

{
  "system": "PlayStation",
  "game": "Example Game (USA)",
  "size": "1234567",
  "crc32": "ABCD1234",
  "md5": "def1234567890abcdef1234567890abc",
  "sha1": "1234567890abcdef1234567890abcdef12345678"
}

• system: Platform or system name
• game: Game or ROM name
• size: File size in bytes
• crc32: CRC32 checksum
• md5: MD5 hash
• sha1: SHA1 hash (primary identifier)

​

MIA Database

• File: mia.json in your DatosoPath (default: ~/.config/datoso/mia.json)
• Format: JSON dictionary keyed by SHA1 hash (or MD5, CRC32, or “system - game”)
• Source: External JSON endpoint (configured in UPDATE_URLS.GoogleSheetMIAUrl)

​

Updating MIA Data

# Update MIA data from remote URL
datoso config --mia-update

1. Downloads the latest MIA data from UPDATE_URLS.GoogleSheetMIAUrl
2. Writes the data to mia.json
3. Makes MIA tracking available for processing

​

MIA Source Configuration

[UPDATE_URLS]
GoogleSheetMIAUrl = https://laromicas.github.io/data/mia.json

# View current MIA URL
datoso config --get UPDATE_URLS.GoogleSheetMIAUrl

# Set custom MIA URL
datoso config --set UPDATE_URLS.GoogleSheetMIAUrl https://example.com/my-mia.json

​

MIA Processing

​

Enable MIA Processing

[PROCESS]
# If this is true, it will process the missing in action if found in the seed
ProcessMissingInAction = false
# If this is true, it will mark all roms in set if one of them is MIA
MarkAllRomsInSet = true

​

ProcessMissingInAction

# Enable MIA processing
datoso config --set PROCESS.ProcessMissingInAction true

# Process seed with MIA checking
datoso seed redump

• Each ROM is checked against MIA hashes (SHA1, MD5, CRC32)
• Matching ROMs are flagged as MIA
• Processing time increases due to hash lookups
• MIA information is included in output DAT files

• MIA checking is skipped
• Faster processing
• No MIA flags in output

​

MarkAllRomsInSet

# Enable marking all ROMs in set
datoso config --set PROCESS.MarkAllRomsInSet true

• If any ROM in a game set is MIA, all ROMs in that set are marked
• Useful for multi-disc or multi-ROM games
• Ensures incomplete sets are clearly identified

• Only the specific MIA ROM is marked
• Other ROMs in the set remain unmarked

​

MIA Workflow

​

Complete MIA Setup

1. Update MIA data:
   datoso config --mia-update
   
2. Enable MIA processing:
   datoso config --set PROCESS.ProcessMissingInAction true
   
3. Process DATs with MIA checking:
   datoso seed redump
   

​

Checking MIA Status

from datoso.database.seeds.mia import get_mias

# Load MIA database
mias = get_mias()

# Check if a SHA1 is MIA
sha1 = "1234567890abcdef1234567890abcdef12345678"
if sha1 in mias:
    mia_info = mias[sha1]
    print(f"MIA ROM: {mia_info['game']}")
    print(f"System: {mia_info['system']}")

​

Best Practices

​

Rules Management

1. Update regularly: Keep rules updated to get latest system configurations
   datoso config --rules-update
   
2. Verify rules URL: Ensure the rules URL is accessible and current
   datoso config --get UPDATE_URLS.GoogleSheetUrl
   
3. Backup rules: Keep a backup of systems.json before major updates
   cp ~/.config/datoso/systems.json ~/.config/datoso/systems.json.backup
   

​

MIA Management

1. Update before major processing: Refresh MIA data before large seed operations
   datoso config --mia-update
   datoso seed all
   
2. Enable selectively: Only enable MIA processing when needed
   # Enable for preservation work
   datoso config --set PROCESS.ProcessMissingInAction true
   
   # Disable for performance
   datoso config --set PROCESS.ProcessMissingInAction false
   
3. Monitor performance: MIA processing adds overhead
   • Use verbose mode to see MIA checks: datoso -v seed redump
   • Consider enabling only for specific seeds
4. Backup MIA data: Keep a backup of mia.json
   cp ~/.config/datoso/mia.json ~/.config/datoso/mia.json.backup
   

​

Troubleshooting

​

Rules Update Failures

# Check rules URL accessibility
curl https://laromicas.github.io/data/systems.json

# Verify rules URL configuration
datoso config --get UPDATE_URLS.GoogleSheetUrl

# Check for network issues with verbose output
datoso -v config --rules-update

​

MIA Update Failures

# Check MIA URL accessibility
curl https://laromicas.github.io/data/mia.json

# Verify MIA URL configuration
datoso config --get UPDATE_URLS.GoogleSheetMIAUrl

# Check for network issues with verbose output
datoso -v config --mia-update

​

MIA Processing Issues

# Verify MIA processing is enabled
datoso config --get PROCESS.ProcessMissingInAction

# Check if MIA data exists
ls -la ~/.config/datoso/mia.json

# Update MIA data if missing or outdated
datoso config --mia-update

​

Performance Issues

1. Disable MIA processing:
   datoso config --set PROCESS.ProcessMissingInAction false
   
2. Process in batches: Process specific seeds instead of all
   datoso seed redump  # Instead of: datoso seed all
   
3. Check MIA database size:
   ls -lh ~/.config/datoso/mia.json
   

​

Advanced Usage

​

Custom Rules Source

1. Create rules JSON:
   {
     "values": [
       ["Company", "System", "Override", "ExtraConfigs", "SystemType"],
       ["Sony", "PlayStation", "{}", "{}", "Console"]
     ]
   }
   
2. Configure custom URL:
   datoso config --set UPDATE_URLS.GoogleSheetUrl https://myserver.com/rules.json
   
3. Update rules:
   datoso config --rules-update
   

​

Custom MIA Data

1. Create MIA JSON:
   {
     "values": [
       ["System", "Game", "Size", "CRC32", "MD5", "SHA1"],
       ["PlayStation", "Example Game", "1234567", "ABC123", "...", "..."]
     ]
   }
   
2. Configure custom URL:
   datoso config --set UPDATE_URLS.GoogleSheetMIAUrl https://myserver.com/mia.json
   
3. Update MIA:
   datoso config --mia-update