This module aims to simplify the process of adding multiple music tracks to Foundry VTT, allowing for bulk importation of songs.
If you're like me, you probably enjoy amassing a large collection of songs to play for your players! However, importing your songs one at a time can be sluggish and time consuming. Playlist importer allows you to bulk import all of your songs!
I will only personally be maintaining the most recent version of foundry. In short, this means you may not get backwards compatibility for any breaking changes. Fortunately, you should be able to use releases to download a compatible version if it exists.
This is a module that enables drag and drop functionality for sound files too.
NOTE: This module is under maintenance, I have no plans to update or add features. However, I will try to fix any bugs as possible. Any contribution is welcome.
Installation
It's always better and easier to install modules through in in app browser.
To install this module manually:
- Inside the Foundry "Configuration and Setup" screen, click "Add-on Modules"
- Click "Install Module"
- In the "Manifest URL" field, paste the following url:
https://raw.githubusercontent.com/p4535992/foundryvtt-playlist-import/master/src/module.json - Click 'Install' and wait for installation to complete
- Don't forget to enable the module in game using the "Manage Module" button
Features
- Allows for quick importation of songs into FVTT
- Only adds songs that haven't been added already (can be disabled) . NOTE: This applies only for songs added by Playlist-importer
- Delete imported playlist
- Build playlist by following the hiearchy of folder or one paylist fr every folder
- Just drop one or more audio files into you playlist directory. Ensemble uploads them and creates a playlist.
It's a feature not a bug!
Please read the following, as it may answer any questions as to unexpected behavior.
NOTE:
- Currently only .mp3, .mp4, .ogg, .wav, .m4a and .flac files are imported. All other types are excluded.
- Organization is force upon you! This means, that when you select your base directory in which to import, only folders within the base directory are checked, not the files. In otherwords, you must subdivide your music into folders inside the base directory.
- Songs added by playlist-importer will be excluded from being added again by the import function. This means, songs names should be unique! Make sure to avoid duplicate names across folders.
- Nested folders will result in unsuccessful importations. This will be addressed in future builds
- For general efficiency questions, refer to the "Efficiency" section below.
- Spaces in folder names should no longer cause issues. Please contact me if they cause trouble.
Usage
Note: The paths are vague, as you may have a different data path for your instance of FoundryVTT. If you have questions, feel free to message me.
- Download and install the mod, then enable it on Foundry.
- Inside of your "/FoundryVTT/Data/" folder, create a new folder called "music" (or any category you prefer).
- Inside of your module settings, navigate to Playlist import and select the desire base directory (music in this example).
- Note 1: If using S3, The Forge, or something similar be sure to select the proper source in the settings
- Note 2: If using S3 specifically, please name the bucket you are using within the "bucket" section of the playlist-importer settings. If you're not using S3, you can ignore this option.
- Inside of your "/FoundryVTT/Data/music" folder, you must create subfolders, perhaps with genres and types.
- Place your music files inside the corresponding folder names (Refer to structure below)
- Inside of FoundryVTT, select the playlist sidebar tab.
- Click "Playlist Import" to receive a conformation prompt.
- Select "Begin Import" to wait for imports to finish.
- A prompt will appear confirming task completion, confirm, and enjoy the music!
Example Structure
| /FoundryVTT/Data
|
|---> /music <----- This should be selected as the directory
| |
| |------> /battle_songs
| | |
| | |----> cool_battle.mp3
| | |
| |------> /epic_songs
| | |
| | |----> epic_battle.mp3
| | |----> last_stand.mp4
| |------> /tavern_songs
| | |
| | |----> gnarly_gnomes.mp3
| | |
| |------> /peaceful_songs
| | |
| | |----> safety.mp3
| | |----> just_kidding.mp4
Settings
- Songs:
- Base music directory: Select a directory to serve as the base directory for music import",
- Select source: Options include ",
- S3 Bucket: If using an s3 bucket, enter in the name of the bucket here.",
- Set repeat for tracks: Should tracks be set to repeat by default?",
- Set stream for tracks: Should tracks be set to stream by default?",
- Set default volume: On a scale from 0.0 - 1.0",
- Song Duplicate Checker: Checks during the importation process to see if duplicate songs exist, excluding them if true.",
- Reassign Regex: Adjust the regex to delete unnecessary based on personal preference. This is used in the first pass to remove things like '-' '_' and leading numbers.",
- Override playlist: If enabled if a playlist with the same name is founded during the import it will be override",
- Delete playlist before import: If enabled if a playlist has the flag of the 'playlist import module' it will be deleted before try the new import. This is useful for when you delete some folder on the disk and want to remove the old playlist on the game.",
- Maintain original folder name: Instead using the hierarchy naming this setting will force to create a playlist with the name of the current folder so instead 'parent_child' will be 'child'"
See more descriptions and usage on the github page!