> ## Documentation Index
> Fetch the complete documentation index at: https://amethyst.geoxor.moe/llms.txt
> Use this file to discover all available pages before exploring further.

# Amethyst metadata file (.amf)

<img align="right" src="https://github.com/Geoxor/amethyst/raw/master/assets/images/amf.png" alt=".amf" width="128" />

### What is it?

Upon loading metadata of a file, Amethyst will create a `.amf` similar to  [Ableton Analysis Files (.asd)](https://www.ableton.com/en/live-manual/12/managing-files-and-sets/#analysis-files-asd) to store it's information for faster future access

### Location

This file is stored in the `Metadata Cache` folder within the [storage folder](/introduction#metadata-location) and it's a [JSON](https://en.wikipedia.org/wiki/JSON) file containing
the metadata of the given audio file. The filename is going to be the same as the name of the audio file it stores metadata for.

eg. [enjoii - Never Say Goodbye](https://open.spotify.com/track/7qss1vfkxeWVMDJ1LyLvHK?si=5d94104b590a4eef).flac => [enjoii - Never Say Goodbye](https://open.spotify.com/track/7qss1vfkxeWVMDJ1LyLvHK?si=5d94104b590a4eef).flac.amf

<Note>
  If the file is renamed Amethyst will have to re-cache the metadata, creating a new file resulting in orphaned copies of cached files.
</Note>

### Regeneration

These files are generated when Amethyst analyzes a file for metadata. They can be rewritten by forcefully refreshing metadata
within Amethyst from the dropdown menu or with the shortcut `CTRL + ALT + R`.

### Deletion

As mentioned above, all metadata caches are stored in `%appdata%/Amethyst/Metadata Cache`. Simply deleting the files within the folder will achieve cache deletion.

### Metadata location

Amethyst will create a folder in these locations for storing user-settings, metadata cache and other electron resources

* Windows: `%appdata%/amethyst`
* Linux: `~/.config/amethyst`
* macOS: `~/Library/Application Support/Amethyst`
