List every cinema we know about, optionally filtered to a single chain. Call this once at the start of a session to discover cinema ids. Ids are namespaced like uci:slug or thespace:numericId and are needed by the other tools.

Cheap overview of the films playing in the given cinemas on the given date, without showtimes. Use this after list_cinemas to discover which films are worth querying with get_showtimes. Pass chain to restrict to one chain or a list of chains (e.g. chain: 'uci' for loyalty promotions); cinema ids that belong to other chains are dropped.

Showtimes for the given cinemas on a date, with optional time window and title substring filters. Returns a compact text view grouped by film and cinema: time, and only the format/language tags that deviate from the chain default (2D in Italian -> nothing; e.g. '21:30 IMAX', '20:20 EN', '21:30 ISENSE' otherwise). Italian is the default language and is omitted; EN, OV are normalised. Sold-out shows are tagged '(sold out)'. Booking links stay off by default; pass include_links=true to add them. Pass chain to restrict to one chain or a list (e.g. chain: 'uci' for loyalty promotions); cinema ids that belong to other chains are dropped.

Time axis: each requested date is a 'cinema day' that spans [date 06:00, date+1 06:00) in Europe/Rome. from_time/to_time earlier than 06:00 means the next calendar day (e.g. to_time '01:00' is 'until 01:00+1'). Showtimes after midnight are rendered with a '+1' marker ('22:00+1' is too far east to happen in practice; '00:30+1' is the usual case). If a film has only out-of-window showtimes at a cinema, that cinema line becomes 'cinema - none in window (N earlier, last HH:MM)'; if the film has zero in-window shows anywhere, an 'Outside the time window:' line is appended.