> ## 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.

# SongMetadata

```ts theme={null}
type SongMetadata = { readonly [key in keyof typeof defaultMetadata]: typeof defaultMetadata[key] } & {
  chartOffsetMs: number;
};
```

A song's metadata as games read it: song.ini when the song has one, and the `.chart` `[Song]` section only when it
doesn't. A value that isn't set is its default ("Unknown Artist", -1 for a difficulty, and so on). Text keeps its
style tags, such as `<b>`, which games show as formatting, unless `removeStyleTags` asks for plain text. The keys are
song.ini's, including those only YARG reads, which Clone Hero ignores; without song.ini, the `[Song]` Offset is the
delay, and a preview time song.ini leaves unset is read from `[Song]`.

## Type Declaration

| Name | Type | Description |
| - | - | - |
| `chartOffsetMs` | `number` | The `.chart` `[Song]` Offset, converted from seconds to milliseconds as Clone Hero rounds it; 0 when there's none. |


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