## Description

Scripts Manager is a tool for streamers, developers, but also anyone who wants to automate actions on their computer.
You can still use it as a toolbox so as not to redevelop software from A to Z if you are a `Java Scripts`/`NodeJS` developer.
Do not hesitate to participate by sending me your suggestions via the Discord server of my Twitch channel: https://discord.gg/BNarUut7Kx.
In case you develop Addons or Scripts, offer them for download from your GitHub account (I may add it in this documentation).

## Download

The version is the one presented in this documentation: https://github.com/Arubinu/Scripts-Manager/releases/tag/v2.0.5.
But you can check all versions here: https://github.com/Arubinu/Scripts-Manager/releases.
You will find the software to download in the `Assets` part (this is not an installer but the complete software).
Put the software where you want to leave it before launching it, avoid folders where there is a request for administrator access (this software will never ask you for this kind of rights).
It is possible that Windows recognizes the software as malicious, since I cannot afford a certificate (far too expensive).

- If Windows blocks the download, you will need to temporarily disable your antivirus.
- If Windows deletes the file once downloaded, you can go to the quarantine part to authorize the software (it will be immediately put back in its place).
- When launching the software, Windows will warn you of the potential danger, you can click on `Additional information` then `Run anyway`

## Addons

Currently there are several Addons integrated into the software which give access in particular to OBS Studio, Spotify, and Twitch.
These can be used via Scripts of your design or the Multi Actions.

### Notifications

Makes the display of notifications available by the various existing scripts.
It is possible to use them from the Notification block of the Multi Actions script.

It is possible to adjust the opacity, the size, the rounding of the corners, as well as the position of the notifications.

### OBS Studio

The address is always the same unless you have a dual-pc setup.
The password is to be recovered in OBS Studio, follow these few steps:

- Click on `Tools` located in the toolbar of OBS Studio (bar at the top of the application),
- Click on `obs-websocket Settings`, to open the settings,
- Check `Enable WebSocket server` if it is not already done, without forgetting to click on `Apply`,
- Click on `Show Connect Info` then on `Copy`, at the level of the password,
- Enter the password in the field provided for this purpose on Scripts Manager.

### Spotify

Control Spotify from the Multi Actions script via a Twitch command or other.

#### Limited connection

You just have to click on `Generate` to give access to your account and generate the tokens.
This method is very limited unless you send me your email address, so I can add it to the Spotify developer app.

#### Extended connection

You have to create yourself a developer application Spotify, without forgetting to enter your own email address to remove the limitations.
This application gives you the `Client ID` as well as the `Client Secret` to be able to generate the associated tokens.

### Twitch

Unlock all features on the Multi Actions script as well as the Stream Flash script.

Just click on `Generate` to give access to your account.
Sending messages, announcements and the like will be on your behalf.

## Scripts

### Multi Actions

This script contains a large number of automation possibilities separated into modules as you see fit.

By clicking on `Toggle Blocks` you will have access to all the script blocks that you can use by dragging them into the module.
The script being very complex, a page is dedicated to it by clicking here: Multi Actions.

### Stream Flash

Flash your screen when a message is sent in Twitch chat.

The first line informs of the number of flashes occurred for the different types of user.

`Screen to flash` leaves the choice of the screen on which to display the flash (often the one where OBS Studio is displayed).
The `Reset statistics` button resets the counters of the first line to zero.

Some settings:

- Opacity: so as not to obscure the information displayed on the screen too much.
- Duration: is the time the flash takes to appear and disappear.
- Delay: ignores messages during this time after a flash has occurred.
- Pause: pauses the Stream Flash system for the chosen duration (accessible from the Scripts Manager icon on the systray).

`Respond to join` activates the flash when a user arrives on the stream (even without speaking).
`Respond to command` activates the flash when a command is sent on the Twitch chat.

### Stream Widgets

Displays web pages on one of your screens.
Can be used to display its alerts, its Twitch chat, or other over a game (does not work on screens where a game is set to exclusive fullscreen).

`Screen for widgets` leaves the choice of the screen on which to display the web pages (often the main screen).

`Anchor` allows to choose the base anchor of the page for the following values.
`X`, `Y`, `Width`, `Height` can be done directly from the Scripts Manager icon in the systray (with the `Edit Mode` option).
To exit edit mode, just press the `Escape` button on the keyboard.

Indicate a name in the `Name` field then the address of the page to display in the `URL` field then click on `Create`. Once displayed, moving and resizing is done from the `Edit Mode` option mentioned previously.