SimpleApps - Xenon257R/blue-archive-rainmeter GitHub Wiki

This skin is a generic, template skin used as application/website shortcuts.

This template uses a single square image asset. To those looking to draw apps with adaptive colors, refer to TrayApps instead.

Components & Behaviors

  • @includes:
    • appbasesimple.inc

Context Menu Options

  • Enable/Disable Shine
    • The appropriate option will appear according to the currently active option.
    • This setting is changed for all Tray Apps that inherit appbasesimple.inc.

Mouse Actions

  • Left-Clicking the Icon: Executes Rainmeter Bangs as specified by the user in Execution.
  • Hovering over the Icon: A shimmer is animated over the icon. Disabled by default.

Details

Making Copies

The template of this skin can be found in the TrayApps\ directory by the name of AppSimple, housing a configuration file called simple.inc. You will want to copy the AppSimple directory in the same place, naming each new copy appropriately.

As this is primarily a template skin, it is expected and encouraged that you make as many copies of this skin as you need in the TrayApps directory and rename those directories appropriately. With each newly copied template, it is advised to follow the checklist below to make sure everything continues to work perfectly:

  • Set the Position value to On Desktop in the Rainmeter client (in Rainmeter.ini, the variable name is AlwaysOnTop with a value of -2)
  • Rename the config folder appropriately
  • Catalog the config folder in the ToggleSwitch database (layout.json)
  • If in use, reposition the skin appropriately - then disable dragging in the Rainmeter client

:speech_balloon: Make as many copies of the template for as many apps you use instead of how much you can fit on the tray and catalog them in the ToggleSwitch deactivated. This will allow you to hotswap apps in and out of the tray by simply activating and deactivating the apps directly from the ToggleSwitch database.

A Shine for Your Pins

When the Shine option is enabled, apps will shimmer when it is hovered over. It will copy your image asset and use it as a mask to determine which pixels need to be shined.

Having this option enabled WILL register a brief but large uptick in CPU usage by Rainmeter every time it activates. This value will easily get compounded the more apps you have for absurd CPU usage for a few seconds. If you absolutely must have this feature active, it is advised that you have Hardware Acceleration enabled if applicable and NOT sweep across your app tray left and right with glee while you have heavy processes running at the same time.

Naming Your Apps

The TrayApp skin template is rigid in its dimensions and will not extend itself to make room for long strings. This is particularly true in the negative x/y direction, as Rainmeter cannot expand backwards due to the way its windows are drawn. To accommodate for longer strings, appbase will reduce the Font Size of the string if it becomes too long to fit ONCE, and if after the reduction the string still fails to fit will simply truncate the remainder of the string.

If you prefer the smaller font size to be applied to every App, you can pad the start and end of your string with underscores(_) evenly on both sides. Leading and trailing underscores will be colored transparent by appbase so they still occupy space and still contribute to the length of the string.

The Power of Rainmeter Bangs

Even within the constraints of the UI, the user has as much freedom as Bangs provide in determining what clicking the "app" will do. Reading the official documentation is encouraged for those who want the button to do more than just open applications or webpages. However, if the simple things suffice, the following cheat sheet will get you far enough:

Apps:              ["C:\Filepath\To\Executable\app.exe"]
Windows Shortcuts: ["C:\Filepath\To\Shortcut\shortcut.lnk"]
Webpages:          ["https:\\www.google.com"]

You can concatenate as many of these bangs as you would like one mouse-click to do. For example, the code below will open your browser to YouTube, Reddit and GMail as well as your C: Drive on the side:

["https://www.youtube.com"]["https://www.reddit.com"]["https://www.gmail.com"]["C:\"]

Just remember that all of these Bangs will fire every time you click the app, so multiple clicks can easily become destructive.