/Bellows

A module for FoundryVTT which adds support for youtube tracks in audio playlists and ambient sounds

Primary LanguageJavaScriptMIT LicenseMIT

Bellows


  • Author: casualchameleon (discord: casualchameleon#6618), temportalflux (discord: temportalflux#3142)
  • Version: 0.3.2
  • Foundry VTT Compatibility: Tested on 0.6.6 and 0.7.5
  • System Compatibility (If applicable): n/a
  • Module Requirement(s): n/a
  • Module Conflicts: no known conflicts, but its plausible that any modules change the playlist or ambient sound data could conflict
  • Translation Support: Playlist import is localised at the moment, but nothing else.

Link(s) to Module

Description

This is a fork of temportalflux's MusicAssist module which is not actively maintained. It aims to add support for youtube tracks and playlists, allowing users to grab their favorite youtube soundtracks and save them as tracks in FVTT. These tracks are played back on each user's computer according to the normal playlist controls. This does require an internet connection to work properly, as it streams the video and just plays the audio.

Not all tracks and playlists are supported, as the YouTube author needs to enable embedding for Bellows to be able to play it.

Installation

Import the module.json as you would any other module. The contents of the module directory should look similar to this github repository's root.

Features

The current feature set includes:

  • Playlist tracks can be imported from a youtube url such as https://www.youtube.com/watch?v=_2xHCZSqpi4
  • Ambient Sound objects can be marked as streaming sounds with the same functionality as streamed playlist tracks (these are unable to fade however)
  • YouTube Playlist imports

Demonstration

Many thanks to Sunamon and OrbitalBliss for putting together a demonstration of Bellows' basic features.

Bellows Demonstration

Known Issues

  • Important Importing high volumes of playlists can cause you to be temporarily timed out by the YouTube API as scraping songs from the iframe makes a lot of calls. Please only import what you need! If you do get timed out, cycling your IP address should fix it for you.
  • In Firefox, audio may not play in certain scenarios due to autoplay restrictions. You can fix this by clicking the autoplay button in the url bar and allowing it for your Foundry VTT site. Each player using Firefox will need to do this for it to work. Chromium based browsers don't have this issue.

image