Skip to content

A module to emulate transparent backgrounds for Scriptable.app widgets.

Notifications You must be signed in to change notification settings

supermamon/scriptable-no-background

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

28 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

no-background.js

A module to emulate transparent backgrounds for Scriptable.app widgets.

Features

  • Interactive Configuration
  • Dark and Light mode support
  • Methods to get the actual background image or the image path
  • Store/reset widget positions
  • Option for semi-transparent style

The 3-Step Setup

  1. Download no-background.js

  2. Add the following code in your widget code

    const { transparent } = importModule('no-background')
    
    const widget = new ListWidget()
    widget.backgroundImage = await transparent(Script.name())
    
    // the rest of your widget code 
  3. Run your widget!

The transparent is an alias for the original getSliceForWidget method. You can use them interchangably.


More Options


Update the background after you moved your widget's position

The transparent method has an optional second boolean argument to prompt for a new widget position. This is useful when you changed the position of the widget on your home screen.

const RESET_BACKGROUND = true

const { transparent } = importModule('no-background')

const widget = new ListWidget()
widget.backgroundImage = await transparent(Script.name(), RESET_BACKGROUND)

// the rest of your widget code 

Tip: Change const RESET_BACKGROUND = true to const RESET_BACKGROUND = !config.runsInWidget to automatcally prompt for a new position every time you run the script inside the app


Changing Your Wallpaper

Now, you may want update the backgrounds after you change your wallpaper. For that, run the no-bacground module by itself.

You will be presented with 2 options, Generate Slices and Clear Widget Positions Cache.

Use the Generate Slices option to update backgrounds from your current wallpaper.

Clear Widget Positions Cache will delete all saved positions from all widgets. You'll have to run each individual widget to setup their positions.


Static Location

If you have widgets that you are most likely not to move around, you can specify a its position using the getSlice method.

const nobg = importModule('no-background')

const widget = new ListWidget()
widget.backgroundImage = await nobg.getSlice('medium-top')

// the rest of your widget code 

Valid slice names are:

  • small-top-left / small-top-right
  • small-middle-left / small-middle-right
  • small-bottom-left / small-bottom-right
  • medium-top / medium-middle / medium-bottom
  • large-top / large-bottom

Getting the path instead of the actual image

Sometimes you may want to get the actual path of the image for a specific posistion.

const nobg = importModule('no-background.js')
const widget = new ListWidget();

const bgpath = nobg.getPathForSlice('small-top-left')
widget.backgroundImage = Image.fromFile(bgpath)

// the rest of your widget code 

Like the getSliceForWidget method, both the getSlice and getPathForSlice also prompt for setup if the slices don't exist.


Examples

Preview

About

A module to emulate transparent backgrounds for Scriptable.app widgets.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published