Animated Background is a feature that allows the GM to set an animated video to play in the background. As the video shows you have you first know of a usable MEDIA URL you wish to use.
Here is a public Media URL for an animated background image. Why not try using it to get started? (For more such images, look in the FAQ and comments as the community shares their own creations, and how to make your own) Here is a public Media URL link YOU can use to see it in action. Why not try inserting it to get things started?
You should see a blue swirling gaseous nebula looking effect. The Video plays under the map layer (this cannot be changed), so any things put onto the map layer may cover part or all of the animated background.
- example: You could use one of the ocean animations for a swells on the ocean, then put a Ship or Island Map Asset from the Image Repo, the animation would be playing but the ship / island would appear ontop of those waves.
Feature/Formatting Requirements (if any)
- The File must be of a
.mp4video type, and hosted in a location that all the player's browsers can resolve without further authentication or pass through.
That is a simple way of saying only certain files will play, and that if you're not careful you may see the video, and everyone else might not be able. (See below).
Instruction Walkthrough (How to use it)
By default animated backgrounds will be enabled on entering Roll20 for the first time after R20ES's installation.
- Look for the animated background configuration icon. (Located near the top RIGHT-hand corner by the Page Toolbar - NOTE it was recently relocated, and so its location differs from the animation above)
- Which when clicked a window will open and show...
- You will need to insert a valid media URL into that field.
(see The FAQ / Support/Suggested Use Guidance and Comments for more animated backgrounds.)
There are also several artists that are creating animated backgrounds their patreon accounts are listed below.
Usable Media URLs from Online sources
This method requires VLC player
- Get it [here](https://www.videolan.org/vlc/index.html)
- Open VLC
- Choose Media
- Choose Open Network Stream
- Choose Network
- Where prompted, Enter the URL / Link to the video (such as `https://www.youtube.com/watch?v=ahwMlwJXPPs`)
- Then in the menu at the top click on
- Choose `Media Information` (or
Ctrl + i)
- At the bottom, under location - you can triple click on that to copy a direct link to the video or double click &
ctrl + c(It will be a very large string of letters and numbers)
[https://r6---sn-5uaeznzk.googlevideo.com/videoplayback?id=o-ADXSkzdDq8RM-Jn5ObZi6JGV0TkYkmusF3YAvA8l_ncv&c=WEB&expire=1541603400&ipbits=0&pl=26&signature=1E2D2BE185FA6F00216100BED0C3D2C5AA2E903B.C97AAFE29C396824C2404ACE4AA6DFE19127BC5F&mime=video%2Fmp4&requiressl=yes&ip=2601%3Ac6%3A8302%3Ad600%3A7c52%3A7b49%3A52d0%3A948d&mt=1541581677&fvip=4&key=yt6&sparams=dur%2Cei%2Cid%2Cinitcwndbps%2Cip%2Cipbits%2Citag%2Clmt%2Cmime%2Cmm%2Cmn%2Cms%2Cmv%2Cpl%2Cratebypass%2Crequiressl%2Csource%2Cexpire&ms=au%2Conr&itag=22&lmt=1494324191606141&dur=10800.065&mv=m&ratebypass=yes&source=youtube&initcwndbps=1885000&mn=sn-5uaeznzk%2Csn-vgqsknez&mm=31%2C26&ei=6KviW6eYBYq2j-8PsK2k-As https://r6---sn-5uaeznzk.googlevideo.com/videoplayback?id=o-ADXSkzdDq8RM-Jn5ObZi6JGV0TkYkmus F3YAvA8l_ncv&c=WEB&expire=1541603400&ipbits=0&pl=26&signature=1E2D2BE185FA6F00216100BED0C3D2 C5AA2E903B.C97AAFE29C396824C2404ACE4AA6DFE19127BC5F&mime=video%2Fmp4&requiressl=yes&ip=2601% 3Ac6%3A8302%3Ad600%3A7c52%3A7b49%3A52d0%3A948d&mt=1541581677&fvip=4&key=yt6&sparams=dur%2Cei% 2Cid%2Cinitcwndbps%2Cip%2Cipbits%2Citag%2Clmt%2Cmime%2Cmm%2Cmn%2Cms%2Cmv%2Cpl%2Cratebypass%2 Crequiressl%2Csource%2Cexpire&ms=au%2Conr&itag=22&lmt=1494324191606141&dur=10800.065&mv=m&rat ebypass=yes&source=youtube&initcwndbps=1885000&mn=sn-5uaeznzk%2Csn-vgqsknez&mm=31%2C26&ei=6Kv iW6eYBYq2j-8PsK2k-As]
this link does expire in several days (varies but as a guess around 20 days), so you may this, but realize you will need to update the link from time to time.
The method creates temporary URLs that will expire in about a day* (assumes From Youtube)
- Find a video on or upload a video to youtube you wish to use.
- Get the URL for that video and copy it.
- Go to https://alltubedownload.net/
- Paste your Youtube video's URL
- The URL that is provided will expire in about a day.
Other Related Features:
Support/Suggested Use Guidance (FAQ).
(this is a community-curated set of best practices / FAQ on the feature's support and solutions/workarounds.)
examples of bad Media URLs (they won't work, and why they won't work -- so you can avoid them in your testing)
That is a local file (that address is a loopback to whatever machine you are on) and nobody else will be able to see it.
That link either requires authentication, or issues a redirect - if pass-through authentication is required the Roll20 client will not pass that, and redirections are most often changes in HTML. The player doesn't know what to do with it.
That's a youtube URL - like above, there is a website side actions that the link asks the browser to take to redirect or initiate some other elements, and the Roll20 client will not be able to act on that so those links WILL fail.
That's an animated .gif (see the ending bit of text? that says .gif -- the player doesn't use and cannot play animated gifs, if your file doesn't work, and ends in .gif, that's why.
That's the new animated .gif format .gifv. (and in case you're wondering, renaming a file to .webm or mp4 won't make the file's "type" change - the file is written in a specific language/structure. The player reads that language, and if its not in that language - it just doesn't work.
One/Some/All of my players cannot see the animation, but I can!
- Tier 1
Check to see if the player(s) are using the supported environment, have the most current version of R20ES installed correctly, and that it is enabled.
Check to see if the extension is running, or they are on supported environment. If it is not, install or enable the extension/plugin. See the installation guide.
- Most likely the URL you have chosen isn't a public address, and so your browser is playing it because it is authorized already to see that file, while your players are not.
Move the file (see Where can I host my Animated Backgrounds ...) to a place everyone has access to.
- Give everyone access to that location.
The best way to see if its a public file is to open a new browser (Chrome if you are using Firefox, Firefox if you are using Chrome - and install R20ES to work in Incognito or Private viewing mode. then log into Roll20 and see if that browser can see the animation.
You can also test this by putting or choosing ANOTHER animation from that site and setting it as a landing page for the players, before play, make sure they can see the animation clearly - then you can proceed with confidence. Otherwise, you will need to have a backup map as whomever cannot see the test animation on the landing page, very likely cannot see the other image.
How do I resize the video?
- You change the page dimension. The animated map maintains its aspect ratio and scales with the page's dimensions.
- TVs/ monitors work within a 16:9 ratio so use that as a metric that to avoid letterboxing (dead space around the image) as much as possible.
|Page's X value||Page's Y value|
- ultimately you'll need to play around so that the scale matches the encounter in some capacity, and some of the animated backgrounds are made intentionally to be modular - so those files you save locally then manufacture complex systems for players to wander through.
Where do I find animations?
- Mostly YouTube and then extract links to them from there, however, DMGE offers a freeware tool to make such (works wonders with the modular dungeon segments.)
- Also there is the [Roll20 Resource Git]() which has
listings by filenameported to the Wiki here
- listings by theme
- listing spreadsheet
- Art Repo (forthcoming)
- Effects Videos
How do align the grid to the animation's grid?
- Most often, you don't. there is some chance it will work, but most often its best to turn off the grid and go from there.
How do I make my own Animated Backgrounds?
- Manny Sykes uses this tool to create many of his animated backgrounds, and you can too. DMGE is tool offered by /u/mcdoolz through his Patreon site .
- You find a game with a virtual environment you enjoy
- confirm there is a 'no clipping' sort of crack or feature.
- use a software for recording the screen.
- then... post the video onto Imgur; YouTube; etc etc.
- use the same practices as above to generate a usable link.
- Watch this to help walk you through the process
Where can I host my Animated Backgrounds so that my players can see and marvel (as can other GMs)?
- Loads of options abound. But... GoogleDrive, Onedrive, Amazon - are most often not usable. so
- github (under 25mb)
- webmland (under 100mb)
- or.....leave a request in the notes with a link to the file
- artist: Tom Swogger
- artist: Manny Sykes
Note: most (if not all) of these maps are screen captures from video games, as a result they tend to be relatively small and do not lend themselves easily to battle maps as their visual elements often suggest the scale of the image is a total of ~30ft across.
Did that not answer your question(s)? if not please check the Known Issues page for further guidance, or leave a comment below to let others know (and help you).