Skip to main content

​
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

Get started for freeTalk to us