Skip to content

KsuWebUI-SN 2.0-69

Choose a tag to compare

@dnascorpionofficial dnascorpionofficial released this 18 Nov 22:12
· 5 commits to main since this release
0a7e4bb

Important

Still on the old KsuWebUI-SN (package io.github.a13e300.ksuwebui)? KsuWebUI-SN now uses a new package name, scorpion.ksuwebui.sn. Android treats it as a new app, so this release does not replace your current install, even if the in-app update popup offers it. Install it, then uninstall the old KsuWebUI-SN yourself. Your settings in the old app (pins, backgrounds, icons, theme) are not carried over.

Already using scorpion.ksuwebui.sn? Nothing to do, this is a normal update.

Tip

Highlights: a new Banner transparency slider for every module banner, Brazilian Portuguese is now available, module WebUIs open faster, and the module settings menu has a fresh look.

✨ New

  • Banner transparency: a new action in each module's settings sheet, shown for modules that have a banner. It opens a small sheet with a slider from 0% to 80% and a live preview of the card, so you can see the result as you drag.
    • Per module: every module keeps its own value, so you can fade one banner and leave the others as they are.
    • Works with Blend Banners: with Blend Banners off, a higher value makes the banner more see-through. With Blend Banners on, it controls how strongly the card colour covers the banner, and it never goes below 5% so the text stays readable.
    • Reset: puts the module back to its default. With Blend Banners on that is the automatic dim you had before.
    • Cleans up after itself: the value is cleared when you set a new banner or remove the banner.
    • Translated: available in all languages.
  • Brazilian Portuguese (Português do Brasil): the whole app is now translated, and there is a Brazilian Portuguese README too. Thank you VictorGabriel7Dev for the translation!

🔁 Changed

  • Faster module WebUIs: a module's WebUI now opens right away instead of waiting for the list of installed apps. The list is loaded only when a module asks for it, and it is refreshed each time you open a WebUI, so apps you just installed or removed are picked up.
  • New look for the module settings menu: the actions are now rounded rows with a thin border and a little space between them. Destructive actions (Remove banner, Remove icon, Clear module data) are shown in red.
  • Clearer wording: Set background and Remove background are now Set banner and Remove banner, in every language.

⚠️ Moving from the old package

  1. Install this release.
  2. Open it and grant root as usual.
  3. Uninstall the old KsuWebUI-SN (the one with the previous package name).

The original KsuWebUI Standalone is not affected. It keeps its own package name and can stay installed.

🙏 Thanks

⚙️ Under the hood

For developers ⚠️ (Click to expand)

Banner transparency

  • MainActivity.kt: new showBannerTransparency() bottom sheet and a per module preference banner_alpha_<module id> (a float from 0 to 0.8). New helpers bannerTransparency(), autoBlendAlpha() (the automatic scrim formula, moved out of the card binding) and blendScrim() (the saved value with a 5% minimum, or the automatic value). Normal banners use banner.alpha = 1 - transparency. The preference is removed when the banner is replaced or deleted.
  • Layout and drawables: new sheet_banner_transparency.xml (a Material Slider, a rounded live preview and Reset and Done buttons) and ic_opacity.xml.
  • Strings: set_background and remove_background are renamed to set_banner and remove_banner. New banner_transparency, reset and done strings are added to all seven locales.

Module settings sheet

  • item_sheet_action.xml: the row now uses the new bg_sheet_action.xml (a ripple with a 20dp rounded card_stroke border), 16dp and 3dp margins, a 52dp minimum height and 20dp padding.
  • MainActivity.kt: action() has a new danger parameter that tints the icon and label with DISABLED_RED. It is used for Remove banner, Remove icon and Clear module data.

WebUI loading

  • AppList.kt: getApplist() now loads on demand through runBlocking, guarded by a Mutex. cachedApps is @Volatile and a new invalidate() clears it.
  • WebUIActivity.kt: the startup coroutine that preloaded the app list before prepareWebView() is gone, and onCreate calls AppList.invalidate().
  • MainActivity.kt: the app list preload at startup is removed.
  • FileSystemService.kt: the root check uses Shell.getShell().isRoot instead of creating a new root shell each time.

Translations and docs

  • values-pt-rBR/strings.xml (new): the Brazilian Portuguese translation, with the same strings as the English file.
  • docs/README_pt-BR.md (new): the Brazilian Portuguese README. The language links in README.md and every docs/README_*.md now include it, the Translating section lists it, and the add_language.py example for pt-BR was removed because the language is now included.

Not changed

  • The package, AIDL interface, URI scheme and theme names from the package rename are as before.
  • The ksu, ksu_bars, ksu_download and ksu_exec_log JavaScript bridges and the R8 rules are as before.