AGP Renderers - Now Available for All!

Hi everyone,

I'm excited to introduce my new AGP (Aglare Graphics Plugin) renderers, designed specifically for Aglare FHD Skin.

🔹 Fully compatible with:

• Infobar

• Channel list

• EventView

• EPG

• Dynamic Backdrops

🔹 Key features:

• TMDB / TVDB / IMDB / Fanart / Google support

• Auto-scheduled download (scan_time)

• Custom folder paths (USB, RAM, HDD)

• Smart cache with auto-clean

• cornerRadius and zPosition supported

🔹 Example usage (skin.xml):

<widget source="ServiceEvent" render="AglarePosterX" size="185,278" nexts="1" />
<widget source="Event" render="AglareBackdropX" size="680,1000" nexts="2" />

📁 Suggested paths:

POSTER_FOLDER = "/media/usb/posters"
BACKDROP_FOLDER = "/media/usb/backdrops"

🔧 Advanced setup, TMDB API key, and more are available in the full GitHub README.

🔐 License & Usage Policy

✅ You are free to use these renderers except for a 1 skinners ;)

❗ Do not remove or change credits in the files

📩 Please contact me if you plan to use them in a project (a simple DM or post is fine)

👤 Developer: Lululla

🔗 Based on digiteng with major enhancements

📜 License: CC BY-NC-SA 4.0 (No commercial use)

=======================================================

Ciao a tutti,

sono felice di presentarvi i miei nuovi renderer grafici avanzati AGP ottimizzati per Aglare FHD Skin.

Li sto testando attivamente e sono già pienamente integrati con i componenti di Aglare.

🔹 Compatibili con:

• Infobar

• Channel List

• EventView

• EPG

• Backdrop dinamici

🔹 Caratteristiche principali:

• Supporto TMDB / TVDB / IMDB / Fanart / Google

• Download automatico dei poster e backdrop programmabile (scan_time)

• Percorsi personalizzabili (USB, RAM, HDD)

• Sistema di cache intelligente e auto-cleaning

• Supporto per corner radius e zPosition

🔹 Esempio uso (skin.xml):

<widget source="ServiceEvent" render="AglarePosterX" size="185,278" nexts="1" />
<widget source="Event" render="AglareBackdropX" size="680,1000" nexts="2" />

📁 Percorsi suggeriti:

POSTER_FOLDER = "/media/usb/posters"
BACKDROP_FOLDER = "/media/usb/backdrops"

🔧 Configurazione avanzata, API key TMDB, e altri dettagli disponibili nel README completo su GitHub.

🔐 Licenza & Condizioni d’uso

✅ I renderer sono gratuiti e possono essere usati da chiunque (eccetto 1)

❗ Non rimuovere o modificare i crediti nei file

📩 Se li usi in un progetto, fammi sapere! (è sufficiente un messaggio privato o sul thread)

👤 Sviluppatore: Lululla

🔗 Basati su digiteng (con ampi miglioramenti)

📜 Licenza: CC BY-NC-SA 4.0 (No uso commerciale)

Thank's odem2014

Here you will find all the instructions for use and download

Belfagor2005/AGPTEAM

🇬🇧 Posters and Backdrops: Automatic Daily Download Posters and backdrops

are automatically downloaded every day, based on the time set via the scan_time parameter.
If not specified in the widget, a globally configured default time will be used (e.g. "02:00").
✅ The system analyzes all installed channel lists and downloads only the contents of channels that have EPG available.
🔁 The operation is repeated every day automatically, even after EPG updates.
🕓 It is recommended to set the time in night bands (e.g. 02:00–04:00).

In this way, the download is optimized and does not overload the device.

Update: The poster and backdrop download system is now managed through the setup Plugin,

where the time and minutes for the download can be set.

=========================

🇮🇹 Poster e Backdrop: Download Giornaliero Automatico

Italiano: I poster e i backdrop vengono scaricati automaticamente ogni giorno, in base all'orario impostato tramite il parametro scan_time.

Se non specificato nel widget, verrà utilizzato un orario di default configurato globalmente (es. "02:00").

✅ Il sistema analizza tutte le liste canali installate e scarica solo i contenuti dei canali che hanno EPG disponibile.

🔁 L’operazione si ripete ogni giorno automaticamente, anche dopo aggiornamenti EPG.

🕓 Consigliato impostare l'orario in fasce notturne (es. 02:00–04:00).

Aggiornamento: Il sistema di download dei poster e backdrop è ora gestito tramite il Plugin di setup,

dove è possibile impostare l'orario e i minuti per il download.

In questo modo, il download è ottimizzato e non sovraccarica il dispositivo.

Key Features:

• 🌙 Low-traffic hours recommended (e.g., 02:00-04:00)
• 🔄 Daily automatic execution (runs at specified time)
• ⏸️ Pauses during active viewing (no system impact)

pasted-from-clipboard.png

🇬🇧 Automatic Disk Space Management AGP includes a smart disk space management system.At runtime, it checks the available space in the poster folder:

• If the disk space is sufficient ✅, the download continues as normal.
• If free space falls below the configured threshold ❗️, the system automatically deletes older files (based on their age), until enough space is available. You can configure these settings

in /etc/agp.conf: [storage] min_space = 100 ; minimum required space in MB max_age = 30 ; max age of files in days Default values (if the config file is missing):

🧹 Requires at least 100 MB free, and files older than 30 days will be removed.

========================

🇮🇹 Gestione automatica dello spazio su disco

AGP include un sistema intelligente per il controllo dello spazio disponibile.

Durante l'esecuzione, viene verificata la disponibilità di spazio nella cartella dei poster:

• Se lo spazio è sufficiente ✅, il download procede normalmente.

• Se lo spazio libero scende sotto la soglia configurata ❗️, il sistema elimina automaticamente i file più vecchi (in base alla data di creazione), fino a ripristinare spazio sufficiente.

I parametri possono essere configurati nel file /etc/agp.conf:

[storage]
min_space = 100      ; Minimum space required in MB
max_age   = 30        ; Maximum file age in days

Valori di default (in assenza del file):

🧹 Minimo 100 MB liberi e file più vecchi di 30 giorni vengono rimossi.

🇮🇹 Sistema di Log a Colori e Debug Centralizzato

AGP include un sistema avanzato di logging con output a colori, utile per identificare immediatamente eventuali problemi o attività durante il debug.

📁 Tutti i file di log vengono salvati nella cartella /tmp/agplog/ e includono:

• Backdrop/PosterX.log – main renderer log
  
• Backdrop/PosterX_errors.log – captured error messages
• Bakdrop/PosterAutoDB.log – automatic handling log
• Backdrop/PosterAutoDB.log - automatic handling log

🧹 È possibile pulire facilmente tutti i log tramite il metodo clear_all_log() automatico:

🔍 In questo modo l'ambiente di debug rimane pulito e facile da monitorare.

🇬🇧 Colored Logging System and Centralized Debug

AGP includes an advanced colored logging system, making it easy to spot issues and debug activity at a glance.

📁 All log files are stored in /tmp/agplog/ and include:

• Backdrop/PosterX.log – main renderer log

• Backdrop/PosterX_errors.log – captured error messages

• Bakdrop/PosterAutoDB.log – automatic handling log

• Backdrop/PosterAutoDB.log - automatic handling log

🧹 You can clean up all log files using the built-in clear_all_log() automatic method

🔍 This keeps your debugging environment clean and easy to monitor.

🇬🇧 Star Rating System

AGP includes AglareStarX, a renderer that displays content ratings using stars or percentage formats.

⭐️ Supported sources:

• TMDB (default)
• IMDB

⚙️ Configurable display modes:

• Percentage (0-100) – numerical format
• 5-Star Rating – classic star rating
• 10-Star Rating – extended scale

=================

🇮🇹 Sistema di Valutazione con Stelle

AGP integra AglareStarX, un renderer dedicato alla visualizzazione del punteggio dei contenuti tramite stelle o percentuali.

⭐️ Fonti supportate:

• TMDB (predefinito)

• IMDB

⚙️ Modalità di visualizzazione configurabili:

• Percentage (0-100) – punteggio numerico

• 5-Star Rating – valutazione classica a 5 stelle

• 10-Star Rating – valutazione a 10 stelle

Le opzioni possono essere configurate tramite:

<widget source="Event" render="AglareStarX" position="x,y" size="width,height"
    rating_source="imdb" display_mode="stars5" />


<widget source="Event" render="AglareStarX" position="x,y" size="width,height"
    rating_source="tmdb" display_mode="stars10" />

🇬🇧 Info Events

AGP includes a powerful system to display detailed information about EPG events (movies, TV shows) using metadata from TMDb.

🧠 The data is fetched and cached automatically in .json format.

⚙️ Available display modes:

• Short info: brief overview (title, year, rating)
• Full info: full metadata including description Custom format: define your own format using placeholders

================

🇮🇹 Info Eventi

AGP offre un sistema avanzato per mostrare informazioni aggiuntive sugli eventi (film, serie TV) direttamente dall'EPG o dai metadati TMDb.

🧠 Le informazioni vengono recuperate e salvate in cache automaticamente in formato .json.

⚙️ Modalità di visualizzazione disponibili:

• Short info: informazioni sintetiche (titolo, anno, rating)

• Full info: panoramica completa dell'evento

• Custom format: formato personalizzabile con variabili

📝 Esempio di template personalizzato:

<widget source="Event" render="AgpInfoEvents" position="x,y" size="width,height"
    display_mode="full" />


<widget source="Event" render="AgpInfoEvents" position="x,y" size="width,height"
    display_mode="custom"
    info_format="{title} ({year}) - {rating}
{genres}
{overview}" />

🎭 I generi vengono automaticamente convertiti dagli ID TMDb in nomi leggibili:

[28, 12] → "Action, Adventure"

🇬🇧 Parental Rating (AglareParentalX)

AglareParentalX is a renderer that shows graphical age rating icons using data from EPG or PosterX-generated metadata.

🎯 Rating sources:

• Event text (e.g., "FSK 16", "12+") PosterX
• .json files (Rated: "PG-13") Fallback to a default icon if no data is found

🧩 Supports multiple rating formats: TV (TV-Y, TV-PG, TV-14, etc.) Movies (G, PG, PG-13, R, NC-17) Automatically mapped to FSK: PG-13 → 16, TV-MA → 18

🖼️ Required icons should be located at: bash

 /usr/share/enigma2//parental/ FSK_0.png, FSK_6.png, FSK_12.png, FSK_16.png, FSK_18.png, FSK_UN.png

📦 If not found, the system attempts to create the directory and logs any missing files.

===================

🇮🇹 Controllo Parentale (AglareParentalX)

Il renderer AglareParentalX visualizza icone grafiche per il controllo parentale basandosi sulle informazioni dell'evento EPG o dai metadati salvati da PosterX.

🎯 Fonti del rating:

• Testo dell'evento (es. "FSK 16", "12+")

• File JSON generati da PosterX (Rated: "PG-13")

• Fallback a un'icona predefinita se nessuna informazione è disponibile

🧩 Supporta rating multipli:

• TV (TV-Y, TV-PG, TV-14, ecc.)

• Film (G, PG, PG-13, R, NC-17)

• Conversione automatica verso FSK: PG-13 → 16, TV-MA → 18

🖼️ Le icone devono trovarsi in:

/usr/share/enigma2/<skin>/parental/FSK_0.png, FSK_6.png, FSK_12.png, FSK_16.png, FSK_18.png, FSK_UN.png

📦 Se mancano, il sistema tenta di crearne la cartella e segnala gli errori a log.

<widget render="AglareParentalX"
source="session.Event_Now"
position="315,874"
size="50,50"
zPosition="3"
transparent="1"
alphatest="blend"/>

Icons
/usr/share/enigma2/<skin>/parental/
├── FSK_0.png
├── FSK_6.png
├── FSK_12.png
├── FSK_16.png
├── FSK_18.png
└── FSK_UN.png

API Management in AGP (Advanced Graphics Renderer)

The AGP system utilizes several APIs (TMDB, OMDB, TVDB, Fanart) to fetch information about movies and other content. The management of API keys is designed to be flexible, offering two main methods:

1. Direct Configuration (Development): API keys are set directly in the code within the API_KEYS dictionary.

2. File-Based Configuration (Production): API keys are loaded from text files located in the Enigma2 skin directory. These files should be named according to the API (tmdb_api, omdb_api, etc.). If the file exists, the key is read from it; otherwise, default keys are used.

The function _load_api_keys() is used to automatically load the keys, and in case of errors or missing files, the system falls back to default keys.

Key Features:

• Flexibility: Keys can be configured either through files or directly in the code.

• File Configuration Priority: Files in the skin directory take precedence over default keys.

• Multithreaded Access Synchronization: API access is protected by a lock to avoid conflicts in a multithreaded context.

Benefits:

• Ease of Management: Using external files for keys enables centralized and simple management, especially in production environments.

• Easy Updates: Keys can be easily updated without modifying the code.

• Flexibility in Deployment: Suitable for both developers (who can insert keys directly in the code) and production environments (where keys are separated).

Gestione delle API in AGP (Advanced Graphics Renderer)

Il sistema AGP utilizza diverse API (TMDB, OMDB, TVDB, Fanart) per ottenere informazioni sui film e altri contenuti. La gestione delle chiavi API è configurata per essere flessibile, con due metodi principali:

1. Configurazione diretta (sviluppo): Le chiavi API vengono impostate direttamente nel codice, nel dizionario API_KEYS.

2. Configurazione tramite file (produzione): Le chiavi API vengono caricate da file di testo nel percorso della skin di Enigma2. Questi file devono essere chiamati con il nome dell'API (tmdb_api, omdb_api, etc.). Se il file esiste, la chiave viene letta da lì, altrimenti vengono utilizzate le chiavi di default.

La funzione _load_api_keys() è utilizzata per caricare automaticamente le chiavi, e in caso di errore o di file mancanti, il sistema fa affidamento sulle chiavi di default.

Caratteristiche principali:

• Flessibilità: Si possono configurare le chiavi API tramite file o direttamente nel codice.

• Priorità ai file di configurazione: I file nella skin hanno la precedenza sulle chiavi di default.

• Sincronizzazione accessi multithread: L'accesso alle API è protetto da un lock per evitare conflitti in un contesto multithread.

Benefici:

• Semplicità di gestione: L'uso di file esterni per le chiavi consente una gestione centralizzata e semplice, specialmente in ambienti di produzione.

• Facilità di aggiornamento: Le chiavi possono essere facilmente aggiornate senza modificare il codice.

• Flessibilità nel deployment: Adatto sia per sviluppatori (che possono inserire direttamente le chiavi nel codice) che per ambienti di produzione (dove le chiavi sono separate).

Questo approccio permette di mantenere il sistema sicuro e modulare, rispettando la necessità di flessibilità per l'uso in vari ambienti.

SETUP API_KEYS INT O FILE: Agp_apikeys.py

API_KEYS = {
"tmdb_api": "3c3efcf47c3577558812bb9d64019d65",
"omdb_api": "cb1d9f55",
"thetvdb_api": "a99d487bb3426e5f3a60dea6d3d3c7ef",
"fanart_api": "6d231536dea4318a88cb2520ce89473b",
}

or import / set in to plugin Aglare setup ;)

Best Regards

We can also customize the skin setup plugin: you need to know that the download of the posters/backdrops happens immediately as soon as you open the channel list or eventview for example.

So I inserted in the setup the desire or not to download all the events in png format. This makes the channel change system faster but slow in displaying the posters.

section = '--------------------------( SKIN UTILITY SETUP )-----------------------'
list.append(getConfigListEntry(_('Automatic download of poster'), config.plugins.Aglare.pstdown, _("Download favorite list posters with Epg automatically at startup")))
list.append(getConfigListEntry(_('Automatic download of backdrop'), config.plugins.Aglare.bkddown, _("Download favorite list backdrop with Epg automatically at startup")))
list.append(getConfigListEntry(_('Remove all png (poster - backdrop) (OK)'), config.plugins.Aglare.png, _("This operation remove all png from folder device (Poster-Backdrop)")))

pasted-from-clipboard.png

or better set our minutes

pasted-from-clipboard.png