Skip to main content

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.

Overview

Seeds are plugins that define how to fetch and process DAT files from specific sources (e.g., Redump, No-Intro, TOSEC). The seed command provides subcommands for managing and working with these plugins.

List Installed Seeds

Display all currently installed seed plugins:
datoso seed installed
Output:
  • Seed name (e.g., redump, nointro, tosec)
  • Description of the seed’s purpose

Show Seed Details

Get detailed information about a specific seed:
datoso seed details <seed-name>
seed-name
string
required
The name of the seed to show details for (e.g., redump, nointro)
Example:
datoso seed details redump
Output includes:
  • Module name
  • Version
  • Author
  • Description

Working with Individual Seeds

Once seeds are installed, you can interact with them directly using their name as a command.

Fetch DAT Files

Download DAT files from the seed’s source:
datoso <seed-name> --fetch
-f, --fetch
flag
Fetch DAT files from the seed’s remote source
Example:
datoso redump --fetch
This command:
  1. Connects to the seed’s data source
  2. Downloads available DAT files
  3. Stores them in the configured download path
  4. Reports any errors encountered

Show Seed Details (Shorthand)

datoso <seed-name> --details
-d, --details
flag
Show details of the seed

Process DAT Files

Process downloaded DAT files and import them into the Datoso database:
datoso <seed-name> --process
-p, --process
flag
Process DAT files from the seed
Example:
datoso nointro --process
The process command:
  1. Reads fetched DAT files
  2. Applies configured actions (copy, parse, merge, etc.)
  3. Updates the database
  4. Generates output files

Process Options

-a, --actions
string
Specify specific actions to execute (can be used multiple times)
-fd, --filter
string
Filter which DAT files to process based on filename pattern
-o, --overwrite
flag
Force overwrite existing DAT files (only available for individual seeds, not all)
Example with actions:
datoso redump --process --actions LoadDatFile --actions Copy
Example with filter:
datoso redump --process --filter "Sony - PlayStation"

Working with All Seeds

Process multiple seeds at once using the special all command:
datoso all --fetch
datoso all --process

Exclude Seeds

-e, --exclude
string
Exclude specific seeds when using all (can be used multiple times)
Example:
datoso all --fetch --exclude redump --exclude nointro

Include Only Specific Seeds

-o, --only
string
Process only specified seeds when using all (can be used multiple times)
Example:
datoso all --process --only tosec --only pleasuredome

Complete Workflow Example

A typical workflow for working with a seed:
# 1. Check if seed is installed
datoso seed installed

# 2. View seed details
datoso seed details redump

# 3. Fetch DAT files
datoso redump --fetch

# 4. Process the fetched files
datoso redump --process

# 5. Check for any issues
datoso doctor redump

Combined Fetch and Process

Fetch and process in a single command:
datoso <seed-name> --fetch --process
Example:
datoso redump --fetch --process

Seed-Specific Arguments

Some seeds may provide additional command-line arguments specific to their functionality. Use --help to see seed-specific options:
datoso <seed-name> --help

Configuration

Seed behavior can be customized in the configuration file under a section named after the seed (in uppercase):
[REDUMP]
OverrideActions = LoadDatFile,Copy,AutoMerge

[NOINTRO]
OverrideActions = LoadDatFile,Copy,Deduplicate

Troubleshooting

If a seed encounters errors during fetch or process:
  1. Enable verbose output:
    datoso -v redump --fetch
    
  2. Check the log file:
    datoso log
    
  3. Run the doctor command:
    datoso doctor redump
    

Next Steps

Build docs developers (and LLMs) love