Skip to main content

UGC integration for Gladys Assistant

UGC integration for Gladys Assistant

Movies currently playing at your UGC cinema.

View on GitHubAll external integrations

Movies currently playing at your UGC cinema, as a dashboard widget, with a scene trigger for when a new film joins the program.

Important: unofficial integration​

This integration reads the "now playing" page that ugc.fr already serves publicly to any visitor of its site — the same content you would see by opening your cinema's page in a browser, nothing more. It is not developed, endorsed, or affiliated with UGC. UGC can change its site at any time and break this integration without notice.

No paid API, no credential extracted from an app, no bypass of anti-bot protection is used: only the public endpoint the site already uses for itself.

Configuration​

  1. Open the integration's Configuration tab.
  2. Run the Find my cinema action: leave the field empty to list the 5 UGC cinemas nearest your Gladys house (if it has a location set), or type a city / postal code to search across all of them. The result is shown under the button as Cinema name — City (12.3 km) (ID: 10) (the distance only appears for a proximity search).
  3. Copy the numeric ID of your cinema into the Cinema ID field, then save.

If no Gladys house has a location set, leaving the field empty lists every UGC cinema instead (fallback behavior).

Add the integration's now_playing widget to a Gladys dashboard to see the films currently playing at that cinema: poster, a booking link, today's showtimes (time and version, VF/VOST) and, when ugc.fr has one, a trailer link.

Scene trigger​

The integration also declares a new_film scene trigger: create a scene with this trigger to react when a film not seen before appears in the program (send a message, for example). The trigger exposes the film's title, release date, today's showtimes and booking link as scene variables. The integration checks for new films twice a day.

Known limitations (v1)​

  • One cinema at a time per installation of the integration.
  • Only today's films and showtimes (no view of tomorrow or later days).
  • The cinema list is a hand-maintained static list (see the repository's README): a brand-new UGC cinema may not appear in it yet.

Troubleshooting​

The integration logs everything it does: check the integration logs from the Gladys interface (or docker logs on the host) with LOG_LEVEL=debug for full detail.

Configuration settings​

These are the settings UGC asks for in its configuration screen in Gladys.

SettingTypeRequiredDescription
UGC cinemasectionNoThis integration reads the public "now playing" page that ugc.fr already serves to every visitor. It is not an official UGC product, is not affiliated with UGC, and can break without notice if the site changes. Run the action below to find your cinema's ID, then paste it below.
Cinema IDstringYesThe numeric ID shown by the "Find my cinema" action, e.g. 10.

How to install UGC in Gladys​

  1. In Gladys, open Integrations: UGC appears in the catalog, next to the native integrations, with a community badge.
  2. Click Install. Gladys pulls the Docker image (ghcr.io/vincentbesseau/gladys-ugc:1.0.0), starts it in a sandbox isolated from the core, and generates the integration's interface (devices, discovery and configuration).
  3. Open the Configuration screen of the integration, fill in the settings, and save.
  4. You can also install it directly from its repository URL: https://github.com/vincentBesseau/gladys-ugc.

UGC requires Gladys >=5.1.1. The catalog inside Gladys refreshes every hour, so a new version becomes available at most one hour after its release.

Not running Gladys yet? It is free and open source: follow the installation guide to get started.

About external integrations​

UGC is an external integration: a community integration packaged as a Docker container and published on GitHub, that Gladys installs in one click and runs in a sandbox isolated from its core. It is published and maintained by vincentBesseau, not by the Gladys core team.

Subscribe to the Gladys Assistant newsletter

A few emails per month about new releases and project news. Sent by Pierre-Gilles Leymarie, founder of the project. Unsubscribe anytime 🙂
Last updated on