> ## Documentation Index
> Fetch the complete documentation index at: https://chart-spec.enchor.us/llms.txt
> Use this file to discover all available pages before exploring further.

# scanSongFolder()

```ts theme={null}
function scanSongFolder(files, options?): Promise<ScannedSong>;
```

Scans a song folder in one call: its metadata, issues and statistics, and whatever else `options` asks for.

## Parameters

| Parameter | Type |
| - | - |
| `files` | readonly [`SongFile`](https://chart-spec.enchor.us/scan-chart/api/index/interfaces/SongFile)\[] |
| `options?` | [`ScanOptions`](https://chart-spec.enchor.us/scan-chart/api/index/interfaces/ScanOptions) |

## Returns

`Promise`\<[`ScannedSong`](https://chart-spec.enchor.us/scan-chart/api/index/interfaces/ScannedSong)>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.