A command-line interface for accessing Filmweb.pl data directly from terminal. Search for films, series, games, characters, people, and fictional worlds, with detailed information and VOD availability.
- Search across multiple content types: films, series, games, characters, people, and fictional worlds
- Display detailed information including ratings, descriptions, cast, and crew
- Check VOD availability across streaming platforms
- Interactive fuzzy search mode using fzf integration
- Rich terminal output with formatted tables and colors
Clone the repository and install:
git clone https://github.com/elizaluszczyk/filmweb-cli.git
cd filmweb-cli
pip install -e .- Python 3.11 or higher
- For interactive mode: fzf
The filmweb command provides three main subcommands: search, info, and vod.
For an enhanced interactive experience, use the included filmweb-fzf script:
./filmweb-fzfThis provides:
- Live search-as-you-type
- Preview panel with content details and VOD availability
- Quick selection and full information display
Watch the full demo on Asciinema
Search for content by query string:
filmweb search "christopher"
filmweb search "one flew"Results are grouped by category (films, series, games, characters, people, worlds) with their respective content IDs.
Display detailed information about specific content using its ID:
# Using content ID with type prefix
filmweb info film:10039711
# Using numeric ID (defaults to film)
filmweb info 10039711
Supported content type prefixes:
film:- Filmsserial:- Seriesgame:- Gamesperson:- Peoplecharacter:- Charactersworld:- Worlds
Display full description:
filmweb info -f serial:430668
Check where to watch content online:
# One Battle After Another
filmweb vod 10059894
Compact view:
filmweb vod -c 10059894
Check the most important roles for a given production:
# Obsession
filmweb top 10094250
Runtime dependencies:
- click >= 8.0.0
- pydantic >= 2.12.5
- httpx >= 0.28.1
- rich >= 13.0.0
Development dependencies are listed in requirements/dev.txt.
- Clone the repository:
git clone https://github.com/yourusername/filmweb-cli.git
cd filmweb-cli- Install in development mode:
pip install -e .
pip install -r ./requirements/dev.txt- Set up pre-commit hooks:
pre-commit installThis project uses:
- Ruff for linting and formatting
- Pre-commit hooks for automated checks
- Pyrefly for static type checking
Run linting:
ruff check src/
pyrefly check src/This is an unofficial project and is not affiliated with Filmweb.pl. Data is fetched from publicly available endpoints/pages.
This project is licensed under the MIT License - see the LICENSE file for details.
Eliza Łuszczyk