AudioPlugin

Audio Plugin

This unofficial TaleSpire plugin adds custom ambient and/or music to the core Talespire atmosphere GUI.

Supports both local files and internet files.

This is a colaborative work between Lord Ashes, HolloFox and Creadth. Lord Ashes did the initial code but most of it

was rewritten by Hollo to use the Atmosphere GUI. Instead of generating new plugin, it was decided to replace

Lord Ashes' plugin. Lord Ashes did a few improvement to Hollo's code for future expandability and added the

remote URL support. After the Taleweaver update, the code was totally re-written patching key methods identified

by Creadth. The latest version was another rewrite based on the research done by Creadth into Content Provider

functionality. The latest version benefits from all the atmosphere audio features but still allows adding audio

from audio files instead of asset bundles.

This plugin, like all others, is free but if you want to donate, use:

Change Log

5.0.0: subscribed music pack download if token is present

5.0.0: Added support for AudioSync plugin (syncs WWW files)

4.1.0: Fixed bug with Apply To Board and reapply audio on board load

4.0.0: Total rewrite based on Content Provider to enable all atmosphere audio features (and keep folders).

3.0.1: Fixed bug that forgot to collect WWW files.

3.0.0: Added folder support.

3.0.0: Total rewrite for for Taleweaver compatibility.

2.1.1: Added Audio/Music and Audio/Ambient folders for in-game share functionality. No plugin change.

2.1.0: Added Logging level for config.

2.1.0: JsonSerialization is now culture agnostic.

2.0.2: Bug Fix: Avoids exception when one has no music files or no ambient files.

2.0.1: Added duplicate audio file detection and warning.

2.0.0: Added support for sharing remote library.

2.0.0: Added support for remote requests.

1.1.0: Rewritten to use Atmosphere GUI for selection.

1.0.0: Initial release.

Install

Use R2ModMan or similar installer to install this plugin.

Configuration

`Core Audio Placement can be either first, alphabetical or last`. This indicates where the core

audio files will appear if they are in the same folder as custom files. The `first` selection means all core

files will appear before custom files. The `last` selection means that all core files will appear after any

custom files. The `alpahbetical` selection means that the core and custom files will be mixed and shown in

alphabetical order.

`Virtual Core Ambient Files Location` indicates the folder, in the hierarchy, where the core ambient file

selection will appear. Defaults to `Ambient/Core meaning a folder named core` in the root of the Ambient

selection options. If the folder points to an existing folder, it can mix core and custom files. If the folder

does not physically exist, it will be shown as if it existed (and thus have only core content). If the entry

is blank, ambient core files will not be shown anywhere.

`Virtual Core Music Files Location same as Virtual Core Ambient Files Location` but for core Music files

instead of Ambient core files..

Usage

Content

The plugin will search for Ambient audio in any File Access Plugin friendly location with the following folder

structure:

`CustomData/Audio/Ambient`

The plugin will search for Music audio in any File Access Plugin friendly location with the following folder

structure:

`CustomData/Audio/Music`

Any files, with the extensions listed below, that is in either of these folders will be registered by this plugin

and will show up in the corresponding section of the Atmosphere GUI.

Supported extensions: `AIF, MP3, OGG, WAV, WWW`

Extensions other than WWW are assoicated with local files where the content of the file contains the audio.

The WWW extension is a special case where the content of the file is a text link (URL) to an internet source for

the audio.

For example, the file "One More Time.www" might contain the content "

The name