Skip to content
forked from zstix/Bellows

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

License

Notifications You must be signed in to change notification settings

RHeynsZa/Bellows2

 
 

Repository files navigation

Bellows2 - Electric Boogaloo

Description

There have been multiple forks of the Bellows package, and even individuals just forking, adding a few commits, and slapping a funding button on it. I've made a new fork (yes, how is this different from anyone else), but I'm looking to actually maintain this a bit better. And also have a better community around it. This includes bug reports, feature requests, and general feedback. Also drop a PR if you like, that would be great.

Original Description

This is a fork of temportalflux's fantastic MusicAssist module which is no longer actively maintained. It aims to add support for youtube tracks and playlists, allowing users to grab their favorite youtube playlists and songs 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.

About

  • Version: 2.0.0
  • Foundry VTT Compatibility:
    • 0.3.2 Tested on 0.6.6 and 0.7.5
    • 0.4.1 Tested on 0.8.8 - confirmed incompatible with 0.8.6
  • Module Conflicts: Reported to conflict with Maestro - YMMV. It's plausible that any modules that change the playlist or ambient sound data could conflict with Bellows.
  • Translation Support: Playlist import is localized at the moment, but nothing else. This is coming soon.

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

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

Credits

Massive thanks to TemportalFlux for his initial work on this project. Massive thanks to Zack Stickles for their additional work on this project.

Thanks to Blackcloud010 for his fantastic project template, FoundryVTT-Module-Template-Hotswap.

About

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

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • TypeScript 87.0%
  • JavaScript 8.4%
  • Handlebars 3.1%
  • CSS 1.5%