# Audio Metadat Reader [](https://github.com/ghost-fvtt/audio-metadata-reader/actions)   [](https://forge-vtt.com/bazaar#package=audio-metadata-reader) [](https://www.foundryvtt-hub.com/package/audio-metadata-reader/) [](https://api.reuse.software/info/github.com/ghost-fvtt/audio-metadata-reader) [](https://ko-fi.com/ghostfvtt) A module for [Foundry Virtual Tabletop] that allows setting the title of Playlist Sounds based on the audio metadata of the underlying files. ## Installation To install and use Audio Metadata Reader, simply paste the following URL into the **Install Module** dialog on the Setup menu of Foundry Virtual Tabletop. https://github.com/ghost-fvtt/audio-metadata-reader/releases/latest/download/module.json ## Usage This module adds a new Sheets for Playlists and Playlist Sounds, that change the behavior when importing audio files, so that the name of the playlist sounds is set to the title from the metadata of the file. By default, the sheets are registered as default sheets, but it can be controlled via settings. The Playlist Sound sheet also has a button next to the input field for the name to replace the current name with the title from metadata. Additionally, there are also context menu entries for Playlists and Playlist Sounds to achieve the same thing. ## Development ### Prerequisites In order to build this module, recent versions of `node` and `npm` are required. Most likely using `yarn` also works but only `npm` is officially supported. We recommend using the latest lts version of `node`. If you use `nvm` to manage your `node` versions, you can simply run ``` nvm install ``` in the project's root directory. You also need to install the project's dependencies. To do so, run ``` npm install ``` ### Building You can build the project by running ``` npm run build ``` Alternatively, you can run ``` npm run watch ``` to watch for changes and automatically build as necessary. ### Linking the built project to Foundry VTT In order to provide a fluent development experience, it is recommended to link the built module to your local Foundry VTT installation's data folder. In order to do so, first add a file called `foundryconfig.json` to the project root with the following content: ``` { "dataPath": "/absolute/path/to/your/FoundryVTT" } ``` (if you are using Windows, make sure to use `\` as a path separator instead of `/`) Then run ``` npm run link-package ``` On Windows, creating symlinks requires administrator privileges, so unfortunately you need to run the above command in an administrator terminal for it to work. ## Licensing This project is being developed under the terms of the [LIMITED LICENSE AGREEMENT FOR MODULE DEVELOPMENT] for Foundry Virtual Tabletop. The project itself uses [REUSE] to specify the used licenses. Currently, everything is licensed under the [MIT] license. More information (including the copyright holders) can be found in the individual files. [Foundry Virtual Tabletop]: https://foundryvtt.com/ [LIMITED LICENSE AGREEMENT FOR MODULE DEVELOPMENT]: https://foundryvtt.com/article/license/ [REUSE]: https://reuse.software/ [MIT]: LICENSES/MIT.txt