BigPizzaV3/CodexPlusPlus · error

Dream Skin theme must contain exactly one image

Error message

Dream Skin theme must contain exactly one image

What it means

Thrown by the Dream Skin theme loader when a theme package's contents are scanned and the number of image files found is not exactly one. A valid theme directory must ship exactly one background image; zero images means an empty/corrupt package, and multiple images make the target asset ambiguous, so the load is rejected instead of guessing.

Source

Thrown at crates/codex-plus-core/src/dream_skin_library.rs:393

        .with_context(|| format!("Dream Skin theme not found: {id}"))?;
    if !metadata.file_type().is_dir() || metadata.file_type().is_symlink() {
        bail!("Dream Skin theme path is not a safe directory");
    }
    let config_path = directory.join(THEME_CONFIG_FILE);
    let metadata = std::fs::symlink_metadata(&config_path)
        .with_context(|| format!("Dream Skin theme config not found: {id}"))?;
    if !metadata.file_type().is_file()
        || metadata.file_type().is_symlink()
        || metadata.len() > THEME_CONFIG_LIMIT
    {
        bail!("invalid Dream Skin theme config");
    }
    let config: DreamSkinThemeConfig = serde_json::from_slice(&std::fs::read(&config_path)?)?;
    if config.id != id {
        bail!("Dream Skin theme id does not match directory");
    }
    let image = find_theme_image(&directory)
        .ok_or_else(|| anyhow::anyhow!("Dream Skin theme must contain exactly one image"))?;
    let draft = DreamSkinThemeDraft {
        config,
        image_path: image.to_string_lossy().into_owned(),
        builtin: false,
    };
    validate_theme_draft(&draft)?;
    Ok(draft)
}

pub fn rename_dream_skin_theme(
    state_dir: &Path,
    id: &str,
    name: &str,
) -> anyhow::Result<DreamSkinThemeSummary> {
    let mut draft = load_stored_dream_skin_theme(state_dir, id)?;
    draft.config.name = name.trim().to_string();
    save_dream_skin_theme(state_dir, &draft)
}

View on GitHub (pinned to f2074595a2)

Solutions

1. Repackage the theme so its directory contains exactly one image file
2. Remove extra image files from the theme directory
3. Re-export or re-download the theme package if it is truncated or corrupt

When it happens

Trigger: Thrown at crates/codex-plus-core/src/dream_skin_library.rs:393 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of BigPizzaV3/CodexPlusPlus@f2074595a2 (2026-08-23). Data as JSON: /api/errors/cef43783cf54d8d3. Report an issue: GitHub.