Skip to main content

CGR integration for Gladys Assistant

CGR integration for Gladys Assistant

Movies currently playing at your CGR cinema.

View on GitHubAll external integrations

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

Important: unofficial integration​

This integration reads the showtimes data that cgrcinemas.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 CGR. CGR 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 endpoints 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 CGR cinemas nearest your Gladys house (if it has a location set), or type a city to search across all of them. The result is shown under the button as Cinema name — City (12.3 km) (ID: P0905) (the distance only appears for a proximity search).
  3. Copy the 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 CGR cinema instead (fallback behavior).

Add the integration's now_playing widget to a Gladys dashboard to see the films playing today at that cinema: poster, a booking link, today's showtimes (time and version, VF/VO/VOST) and, when cgrcinemas.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 CGR 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 CGR asks for in its configuration screen in Gladys.

SettingTypeRequiredDescription
CGR cinemasectionNoThis integration reads the public showtimes data that cgrcinemas.fr already serves to every visitor. It is not an official CGR product, is not affiliated with CGR, 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 ID shown by the "Find my cinema" action, e.g. P0905.

How to install CGR in Gladys​

  1. In Gladys, open Integrations: CGR 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-cgr: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-cgr.

CGR 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​

CGR 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