cinecli

A CLI tool for browsing Cineplexx Austria cinemas, movies, and showtimes.

Installation

Homebrew (Recommended)

brew tap benithors/tap
brew install cinecli

From Source

# Clone the repository
git clone https://github.com/benithors/cinecli.git
cd cinecli

# Build
go build -o cinecli .

# Or install globally
go install .

Add to PATH (fish)

fish_add_path ~/go/bin

Usage

Movies

# List movies for a specific date
cinecli movies -d 2026-01-06

# Show movie details
cinecli movies anaconda
cinecli movies avatar-3

# List movies with date flag
cinecli movies --date 2026-01-10

Output:

MOVIES - 2026-01-06

Title                          Rating     Runtime    Genres
──────────────────────────────────────────────────────────────────────
Anaconda                       Ab 12 Jahren 1h 40m     Komödie, Action, Abenteuer
Avatar: Fire and Ash           Ab 12 Jahren 3h 18m     Fantasy, Action, Abenteuer
Sonic the Hedgehog 3           Ab 6 Jahren  1h 50m     Animation, Abenteuer

Cinemas

# List all cinemas
cinecli cinemas

# Filter by location/state
cinecli cinemas --location wien
cinecli cinemas -l tirol

# Show cinema details
cinecli cinemas 1003

Output:

CINEPLEXX CINEMAS

ID     Name                                Location             Address
──────────────────────────────────────────────────────────────────────────────────────────
1001   Apollo - Das Kino                   Wien                 Gumpendorferstraße 63, 1060 Wien
1002   Artis International                 Wien                 Schultergasse 5, 1010 Wien
1003   Cineplexx Donau Zentrum             Wien                 Wagramer Straße 79, 1220 Wien

Showtimes

# Showtimes for a movie
cinecli showtimes -m anaconda -d 2026-01-06
cinecli showtimes --movie avatar-3 --date 2026-01-10

# Showtimes at a cinema
cinecli showtimes -c 1003 -d 2026-01-06
cinecli showtimes --cinema 1003 --date 2026-01-10

Output:

ANACONDA - 2026-01-06

Cineplexx Donau Zentrum
──────────────────────────────────────────────────
Time     Screen       Tech       Status
15:30    Saal 4       2D         ● Available
18:00    Saal 8       2D         ● Available
19:45    Saal 9       2D         ● Available

Configuration

# Show current config
cinecli config show

# Add favorite cinemas
cinecli config add 1003 1004

# Remove favorite cinema
cinecli config remove 1003

# Set default location
cinecli config set-location wien

When you have favorite cinemas configured, cinecli showtimes -m <movie> will only show showtimes at your favorite cinemas. Use --all to see all cinemas.

Config file location: ~/.config/cinecli/config.yaml

Version

cinecli version

Commands Reference

Command	Description
cinecli movies	List movies
cinecli movies <slug>	Show movie details
cinecli cinemas	List all cinemas
cinecli cinemas <id>	Show cinema details
cinecli showtimes	Show showtimes
cinecli config show	Show current configuration
cinecli config add <ids>	Add favorite cinemas
cinecli config remove <ids>	Remove favorite cinemas
cinecli config set-location	Set default location
cinecli version	Print version

Flags

Flag	Short	Command	Description
--date	-d	movies, showtimes	Filter by date (YYYY-MM-DD)
--location	-l	cinemas	Filter by state (wien, tirol, etc.)
--movie	-m	showtimes	Movie slug or ID
--cinema	-c	showtimes	Cinema ID
--all	-a	showtimes	Show all cinemas (ignore favorites)

Cinema IDs

ID	Cinema
1001	Apollo - Das Kino (Wien)
1002	Artis International (Wien)
1003	Cineplexx Donau Zentrum (Wien)
1004	Cineplexx Millennium City (Wien)
1005	Cineplexx Wienerberg (Wien)
1006	Cineplexx Wien Auhof (Wien)
1007	Village Cinema Wien Mitte (Wien)
1008	Cineplexx Wiener Neustadt (NÖ)
1010	Cineplexx Westfield SCS (NÖ)
1011	Annenhof Kino (Steiermark)
1012	Cineplexx Graz (Steiermark)
1013	Cineplexx Leoben (Steiermark)
1014	Cineplexx Linz (OÖ)
1016	Cineplexx Salzburg Airport (Salzburg)
1017	Cineplexx Hohenems (Vorarlberg)
1018	Cineplexx Villach (Kärnten)
1019	Cineplexx Wörgl (Tirol)
1020	Cineplexx Innsbruck (Tirol)

API Reference

cinecli uses the Cineplexx public API.

Base URL

https://app.cineplexx.at

Headers

client-key: 308330b1-52a5-4883-aee3-304240c22ea1
cineplexx-platform: WEB
content-type: application/json;charset=UTF-8
accept-language: de

Endpoints

Endpoint	Description
GET /api/v1/cinemas	List all cinemas
GET /api/v1/cinemas/{id}	Cinema details
GET /api/v1/locations	Locations grouped by state
GET /api/v2/movies?date={date}&location=all	Movies for date
GET /api/v1/movies/{slug}	Movie details
GET /api/v1/cinemasweb/{id}/movies?date={date}	Cinema schedule with sessions
GET /api/v2/moviesweb/{id}/sessions?date={date}&location=all	Movie sessions

Project Structure

cineplex-cli/
├── main.go                 # Entry point
├── go.mod
├── go.sum
├── cmd/
│   ├── root.go            # Root command setup
│   ├── movies.go          # movies command
│   ├── cinemas.go         # cinemas command
│   ├── showtimes.go       # showtimes command
│   ├── config.go          # config command
│   └── version.go         # version command
└── internal/
    ├── api/
    │   ├── client.go      # HTTP client with headers
    │   ├── movies.go      # Movie API methods
    │   ├── cinemas.go     # Cinema API methods
    │   └── sessions.go    # Session API methods
    ├── config/
    │   └── config.go      # Config loading/saving
    ├── models/
    │   ├── movie.go       # Movie struct
    │   ├── cinema.go      # Cinema struct
    │   └── session.go     # Session struct
    └── ui/
        └── table.go       # Terminal output formatting

Dependencies

• cobra - CLI framework
• lipgloss - Terminal styling
• yaml.v3 - Config file parsing

License

Apache License 2.0 - see LICENSE