# VGMDB Dummy Folders — Seed Folders with a Placeholder FLAC

> **Status:** Active
> **Category:** File Organization
> **Language:** PowerShell
> **Script file:** `Get-ChildItem CVGMPPURLsXYZ -Recurs.ps1`

## Purpose

Recursively walks a directory tree and copies a single small placeholder `.flac` file into every subfolder. This "seeds" otherwise-empty or audio-less album folders so that downstream tagging scripts — which scan for FLAC files — have something to read and operate on.

## Requirements

PowerShell 5.1 or later (no additional modules required).

## Input

| Item | Description | Example |
|------|-------------|---------|
| Source FLAC | A small, pre-existing `.flac` file to copy into every folder | `C:\VGMPP\copy.flac` |
| Target directory tree | The root directory to walk recursively | `C:\VGMPP\URLs\XYZ` |

Both paths are **hardcoded** inside the script (see Notes).

## Output

| Item | Description |
|------|-------------|
| `copy.flac` | One copy placed into every subfolder found under the target directory |

No log file is produced. Output is whatever PowerShell prints to the console from `Copy-Item`.

## Usage

Open PowerShell, then run the script directly. No parameters are accepted — all configuration is inside the file.

```powershell
.\Get-ChildItem CVGMPPURLsXYZ -Recurs.ps1
```

Because both paths are hardcoded, **edit the script before running** if your folder layout differs.

## Examples

```powershell
# Example 1 — Run as-is (uses hardcoded paths)
.\Get-ChildItem CVGMPPURLsXYZ -Recurs.ps1

# Example 2 — Quick one-liner equivalent if you want to test a different tree
Get-ChildItem "D:\Music\Doujin" -Recurse -Directory | ForEach-Object {
    Copy-Item -Path "C:\VGMPP\copy.flac" -Destination $_.FullName
}
```

## Notes

- **Hardcoded paths:** The script has two hardcoded values that must be edited for a different environment:
  - Target directory: `C:\VGMPP\URLs\XYZ`
  - Source file: `C:\VGMPP\copy.flac`
- The script copies `copy.flac` into **every** subfolder in the tree, including nested ones. If a file named `copy.flac` already exists in a subfolder, `Copy-Item` will overwrite it by default.
- The placeholder FLAC should be a minimal, valid FLAC file — small enough to not waste disk space when duplicated across hundreds of folders. It only needs to be parseable by downstream tagging tools.
- This script is a utility step in a broader tagging workflow. The typical use case is to prepare a batch of newly-downloaded or un-tagged album folders so that a FLAC tagger can process them all in one pass.
- No confirmation prompt or summary is shown. The script runs silently and exits immediately.

## Related Scripts

- [vgmdb-doujin-subfolders](vgmdb-doujin-subfolders.md) — organises FLAC album folders by publisher tag (reads FLAC tags from folders seeded by this script)
- [vgmdb-logcue-folderrename](vgmdb-logcue-folderrename.md) — processes album folder names based on the presence of `.log` and `.cue` files