OBS Lua Automatic Fit to Screen Script 1.8

## Description [EN]
Automatic Fit to Screen Script for OBS (Version 1.8)

This script is designed for use with OBS (Open Broadcaster Software) in live productions. It automatically adjusts video and image sources to fit the screen whenever a scene transition occurs, provided they have not been previously adjusted. This ensures that your media sources are always properly scaled and positioned without manual intervention.

Features:

Automatically fits video and image sources to the screen during scene transitions.
Ensures sources are only adjusted if they haven't been previously modified.
Provides detailed logging for troubleshooting and monitoring purposes.
How it works:

The script listens for scene change events in OBS.
When a scene change is detected, it checks each source in the scene.
If a source is a video or image and hasn't been adjusted before, it scales and positions the source to fit the screen.
The script uses OBS's API to get the canvas dimensions and calculate the appropriate scale and position for each source.
Configuration:

The script includes a setting to enable or disable detailed logging.

## Descripció [CA]
Script d'Ajust Automàtic a la Pantalla per OBS (Versió 1.8)

Aquest script està dissenyat per a ser utilitzat amb OBS (Open Broadcaster Software) en produccions en directe. Ajusta automàticament les fonts de vídeo i imatge per adaptar-les a la pantalla cada vegada que es produeix una transició de escena, sempre que no hagin estat ajustades prèviament. Això assegura que les teves fonts de mitjans estiguin sempre correctament escalades i posicionades sense necessitat d'intervenció manual.

Característiques:

Ajusta automàticament les fonts de vídeo i imatge a la pantalla durant les transicions de escena.
Assegura que les fonts només s'ajustin si no han estat modificades prèviament.
Proporciona un registre detallat per a la resolució de problemes i el monitoratge.
Com funciona:

L'script escolta els esdeveniments de canvi d'escena a OBS.
Quan es detecta un canvi d'escena, comprova cada font a l'escena.
Si una font és un vídeo o una imatge i no ha estat ajustada abans, escala i posiciona la font per adaptar-la a la pantalla.
L'script utilitza l'API d'OBS per obtenir les dimensions del llenç i calcular l'escala i la posició adequades per a cada font.
Configuració:

L'script inclou una configuració per habilitar o deshabilitar el registre detallat.

##README.md​

Description [EN]​

QlistGoStyle_and_AdjustImage_Lua_scripts​

This Release contains two Lua scripts designed to enhance the user experience of OBS Studio, in live presentations, such as theater, conferences, and other live events.

Project Status​

These scripts are currently under review for official inclusion in the OBS Studio community. The approval process is managed by the core developers of the OBS Project, who evaluate the scripts to ensure their quality, security, and usefulness to the community. While we await this approval, users can test the scripts at their own risk.

Included Scripts​

1. Adjust image or video to screen (v1.8)​

This script automatically adjusts image and video sources to fit the OBS screen, ensuring optimal visual presentation during live events.

Main features:

• Automatic adjustment of image and video sources to the screen
• Works with scene changes

2. QlistGOStyle AutoFade AudioMonitor (v1.53)​

An advanced script that provides various functionalities to improve the quality of live presentations.

Main features:

• Automatic Transition and Fade Out for audio/video sources and Next/Previous Scene Change using hotkeys
• Automatic Audio Monitoring

Installation​

1. Download the scripts from this Release.
2. Place the .lua files in the OBS Studio scripts folder or any other location.
   • Windows: %APPDATA%\obs-studio\scripts\
   • macOS: ~/Library/Application Support/obs-studio/scripts/
   • Linux: ~/.config/obs-studio/scripts/
3. Open OBS Studio and go to "Tools" > "Scripts".
4. Click "+" and select the scripts you've downloaded.

Usage​

Adjust image or video to screen​

• Once activated, the script will automatically adjust image and video sources to the screen.
• No additional action is required from the user.

QlistGOStyle AutoFade AudioMonitor​

IMPORTANT: Disable the 'Swap Preview/Program Scenes After Transitioning' option in the OBS Studio 'Transition' menu to ensure correct script operation. This prevents unexpected changes in the scene order.

• Automatic Transition and Fade Out for audio/video sources and Next/Previous Scene Change using hotkeys
• Fade out will be automatically applied to audio sources when changing scenes.
• Audio monitoring will be automatically adjusted for all audio/video sources.

Configuration​

Each script has configuration options that can be adjusted from the OBS Studio scripts interface. Check the comments within each script for specific configuration options.

Compatibility​

These scripts have been tested in the following environments:

• Windows 10 (64-bit)
• Linux Ubuntu MATE 20.04.6 LTS (Focal Fossa) (64-bit)
• OBS Studio version 30.0.2 (64-bit)
• OBS Studio version 31.0.1 (64-bit)

Note: These scripts have not been tested on macOS.

Contributions​

Contributions are welcome! If you have any ideas to improve these scripts or want to report a bug, please open an "issue" or send a "pull request".

License​

[MIT]

Author​

[Pëpep]

---

We hope these scripts enhance your experience with OBS Studio in your live presentations!

Acknowledgments​

This project uses code from OBS-next-scene-hotkey by SimonGZ, under the MIT license.

---

Descripció [CA]​

QlistGoStyle_and_AdjustImage_Lua_scripts​

Aquesta publicació conté dos scripts Lua dissenyats per millorar l'experiència d'ús d'OBS Studio en presentacions en viu, com ara teatre, conferències i altres esdeveniments en directe.

Estat del projecte​

Aquests scripts es troben actualment en fase de revisió per a la seva inclusió oficial a la comunitat d'OBS Studio. El procés d'aprovació és gestionat pel grup de desenvolupadors principals d'OBS Project, que avaluen els scripts per assegurar-ne la qualitat, seguretat i utilitat per a la comunitat. Mentre esperem aquesta aprovació, els usuaris poden provar els scripts sota la seva pròpia responsabilitat.

Scripts Inclosos​

1. Adjust image or video to screen (v1.8)​

Aquest script ajusta automàticament les fonts d'imatge i vídeo perquè s'adaptin a la pantalla d'OBS, garantint una presentació visual òptima durant els esdeveniments en viu.

Característiques principals:

• Ajust automàtic de fonts d'imatge i vídeo a la pantalla
• Funciona amb canvis d'escena

2. QlistGOStyle AutoFade AudioMonitor (v1.53)​

Un script avançat que proporciona diverses funcionalitats per millorar la qualitat de les presentacions en directe.

Característiques principals:

• Transition and Fade Out Automàtic per a fonts d'àudio/video i Canvi d'Escena Següent/Anterior mitjançant tecles d'accés ràpid
• Monitorització Automàtica d'àudio

Instal·lació​

1. Descarrega els scripts d'aquesta publicació.
2. Col·loca els arxius .lua a la carpeta de scripts d'OBS Studio. o a qualsevol altre lloc
   • Windows: %APPDATA%\obs-studio\scripts\
   • macOS: ~/Library/Application Support/obs-studio/scripts/
   • Linux: ~/.config/obs-studio/scripts/
3. Obre OBS Studio i vés a "Eines" > "Scripts".
4. Fes clic a "+" i selecciona els scripts que has descarregat.

Ús​

Adjust image or video to screen​

• Un cop activat, el script ajustarà automàticament les fonts d'imatge i vídeo a la pantalla.
• No es requereix cap acció addicional per part de l'usuari.

QlistGOStyle AutoFade AudioMonitor​

IMPORTANT: Desactiveu l'opció 'Intercanvia Escenes de Previsualització/Programa després de la Transició' al menú 'Transició' d'OBS Studio per assegurar el funcionament correcte dels scripts. Això evita canvis inesperats en l'ordre de les escenes.

• Transition and Fade Out Automàtic per a fonts d'àudio/video i Canvi d'Escena Següent/Anterior mitjançant tecles d'accés ràpid
• El fade out s'aplicarà automàticament a les fonts d'àudio quan canviïs d'escena.
• La monitorització d'àudio s'ajustarà automàticament per a totes les fonts de audio/vídeo.

Configuració​

Cada script té opcions de configuració que es poden ajustar des de la interfície de scripts d'OBS Studio. Consulta els comentaris dins de cada script per a opcions específiques de configuració.

Compatibilitat​

Aquests scripts han estat provats en els següents entorns:

• Windows 10 (64-bit)
• Linux Ubuntu MATE 20.04.6 LTS (Focal Fossa) (64-bit)
• OBS Studio version 30.0.2 (64-bit)
• OBS Studio version 31.0.1 (64-bit)

Nota: Aquests scripts no han estat provats en macOS..

Contribucions​

Les contribucions són benvingudes! Si tens alguna idea per millorar aquests scripts o vols reportar un error, si us plau, obre un "issue" o envia un "pull request".

Llicència​

[MIT]

Autor​

[Pëpep]

---

Esperem que aquests scripts millorin la teva experiència amb OBS Studio en les teves presentacions en viu!

Agraïments​

Aquest projecte utilitza codi del OBS-next-scene-hotkey de SimonGZ, sota llicència MIT.

Author: [Pëpep] Last Update: 4/02/25