SchaleFolder - Xenon257R/blue-archive-rainmeter GitHub Wiki

images/schalefolder.png

This skin serves as a shortcut to File Explorer, with an additional feature in a variant.

Variants

  • schalefolder.ini
  • mangafolder.ini

\schalefolder.ini

Components & Behaviors

Context Menu Options

  • Edit Right-Click
    • Opens a pop-up where you can enter a function for the Right Click Action.
      • Intended for a Sub-Hub transition. Default layout comes with #GRID# as its parameter.
  • Edit HubSwitch Parameters

Mouse Actions

  • Left-clicking the Folder: Opens up File Explorer.
  • Right-clicking the Folder: (v1.1.0) Runs the programmed execution from the Edit Right-Click context menu.

\mangafolder.ini

Components & Behaviors

  • @includes:
  • luascripts:
    • manga.lua
  • (100%, 100%) Anchor Point
  • Downloads and caches data from the internet

Context Menu Options

  • Edit Database
  • Force Data Update
    • Forces the Skin to reassess data despite last check's timestamp.
  • Enable/Disable Animations
  • Edit Right-Click
    • Opens a pop-up where you can enter a function for the Right Click Action.
      • Intended for a Sub-Hub transition. Default layout comes with #GRID# as its parameter.
  • Edit HubSwitch Parameters
Name Type Example Notes
use_name boolean true
id string decbf626-f76a-4da6-96f8-8ae084718c42 A valid ID is a 5-part hexadecimal string.

Mouse Actions

  • Left-Clicking the Folder: Opens up File Explorer.
  • Right-clicking the Folder: (v1.1.0) Runs the programmed execution from the Edit Right-Click context menu.
  • Left-Clicking the [OPEN] Tab: Pulls up the manga catalogue to browse. Replaces itself with [CLOSE].
    • This button is replaced by [EMPTY] if the manga database is empty.
  • Left-Clicking the [CLOSE] Tab: Puts back the manga catalogue. Replaces itself with [OPEN].
  • Left-Clicking the Arrows: Iterates to the next entry in the database in the specified direction.
    • The respective arrows will be invisible if you are at either extreme of the database.
  • Scroll-wheeling over the Manga: Iterates to the next entry in the database in the specified direction.
  • Left-Clicking the Square to the top-left of the Manga: Timestamps the associated manga with the current time, marking it as "caught up".
    • A "caught up" entry will display a stamp.
    • Further clicks on an already "caught up" entry will NOT update the timestamp to the current value.
  • Left-Clicking the Manga Entry: Opens up the next chapter released since the specified timestamp the value above.
    • If "caught up", instead opens the manga's MangaDex home page.

Details

Proper Accreditation

As per the terms of the MangaDex API's Acceptable Use Policy, this section is dedicated to fully credit MangaDex to make this skin work. This skin as provided DOES NOT provide direct functionality to read chapters and does not run paid ads and services, and only pulls Cover Images, some manga metadata and 0 or 1 chapter entries per manga.

15's the Limit - And You Should Most Definitely Refrain From Increasing This One

This skin enforces an active database limit of 15 active entries at a time. This limit is to adhere to the MangaDex API's rate limits so that your IP does not get blacklisted for excessive calls. THEORETICALLY, you can uncap the limit all the way to 100 as this is the hard cutoff in their API, but this is most definitely overkill and brings very little benefit. This, on top of the written cache system should make it so that the skin only ever make at maximum (1+2n) calls every hour.

New Chapter(s) Available!

If any entry in the active database has found a chapter you haven't read since your last marked timestamp, this pop up will be visible. It will automatically hide itself after you have marked every entry as "caught up" once again.

You're All Caught Up, or You Haven't Started Since Last Time

With the way the "caught up" marker works, using ONLY this skin to keep track of your favorite manga can be VERY frustrating as the only thing the skin clearly identifies is whether there has been at least 1 new chapter you haven't read since the last time you marked "caught up". There is no way to tell the skin to sa you've read 2 of the 5 new chapters released - once you click that square in the top left, the skin considers you to have read all of the latest chapters.

:speech_balloon: This goes into the overarching statement that I made where this widget cannot and DOES NOT aim to fully replace the power of a proper MangaDex account. It only bookmarks a manga on MangaDex, and once you're all caught up with it, you can rely on this widget to be notified when new chapters have been released since. The more you wait to catch up, the less effective this widget becomes as its most optimal use crutches on you reading every new chapter released since your timestamp before every timestamp update.