YouTubeBubble - Xenon257R/blue-archive-rainmeter GitHub Wiki

images/youtube.png

This skin displays a marquee of the most recent upload of a catalog of YouTube channels.

Components & Behaviors

  • luascripts:
    • youtube.lua
  • (1000 ms) Update Value: Requires 1-second cycle to tick the marquee
  • Downloads and caches data from the internet

Context Menu Options

  • Edit Database
  • ID Extractor
    • If this tool fails, there are various online tools to do the same task. You can also extract the ID yourself from a channel's Page Source.
    • A valid ID will always start with UC.
  • Force Data Update
    • Clears local cache data to force the Skin to reassess data.
  • Force All Update
    • Clears all local cache to reassess data and redownload image resources.
  • Enable/Disable Animations
Name Type Example Notes
use_name boolean false
font_face string Noto Sans Third-party font files need to be put in the @Resources\Fonts\ directory.
id string UCTSRIY3GLFYIpkR2QwyeklA A valid string will always start with UC.

Mouse Actions

  • Double Left-Clicking the Bubble: Opens the video in your default browser.
  • Double Left-Clicking the Channel Name: Opens the channel's homepage in your default browser.
  • Right-Clicking the Bubble: Iterates to the next entry in the database.
  • Left-Clicking the Scrollbar: Iterates to the selected entry in the database.
    • The scrollbar will not be displayed if 1 or less entries are active.

Details

The YouTube Channel Icon

The script scrapes the channel's homepage to extract their channel icon ONCE when it is first loaded and the icon has yet to be cached locally. Until you Force All Update, this image will never be updated again in the future to prevent any need for further scraping.

Due to this behavior, you may also manually replace the downloaded image asset with your own under the same name and the script will never correct the image. You can exploit this behavior to theme channel icons to your liking or substitute them for your idea of the perfect image representation for the channel. Just be wary that clicking Force All Update WILL delete your image and replace it with the newly scraped one, so make sure you have a backup.

15's the Limit

This skin enforces an active database limit of 15 active entries at a time. This limit is primarily so that the scroll bar UI does not spill beyond the skin's boundaries which will make it impossible for you to navigate to entries at the start or end of the database quickly. You can manually increase this limit by going into bubble.ini and changing the Limit variable to whatever limit you like, but if you use 16 or more it may be in your best interest to disable the Scroll Bar entirely.

Unresolved Parser Issue

This refers to the GitHub Issue #3, in which the WebParser's attempt to download Channel Icons are intercepted by a Cookie request. A failsafe has been placed in the v1.1.0 update that allows the skin to continue functioning, substituting a generic youtube.jpg icon instead for the missing download. Until a proper workaround is found, this will hopefully allow you to still use the skin.

If you wish to change the fallback image, you can substitute youtube.jpg located in @Resources\assets\misc with a different image under the same name, and it will work.