Skip to content

Latest commit

 

History

History
111 lines (74 loc) · 7.34 KB

README.md

File metadata and controls

111 lines (74 loc) · 7.34 KB
Raw

filme-hannover.de

Generate page License: AGPL v3

filme-hannover.de is a non-commercial, free, and open-source application that consolidates cinema programs in Hanover, Germany. This project makes it easier for users to find showtimes, especially for smaller cinemas that aren't listed on commercial websites.

Table of Contents

Features

  • Comprehensive Listings: Aggregates cinema programs from all theaters in Hanover.
  • Daily Updates: GitHub Actions automatically update the page daily.
  • Static Deployment: The site is static and hosted on GitHub Pages.
  • Open Source and Privacy-Focused: No ads, no cookies, no tracking.

Architecture

The project is divided into two main components: the Backend and the Frontend.

Backend

  • .NET (C#) for scraping and data processing.
  • SQLite for temporary data storage and normalization.
  • Scraping: HTML, ICS files, public APIs.

Frontend

  • TypeScript + Vite.
  • WebComponents for a lightweight and modular UI.
  • IndexedDB via dexie.js for local data management.

How to Contribute

We welcome contributions! Here’s how you can get involved:

  1. Find an Issue: Check the open issues and look for labels like "Good First Issue" to find beginner-friendly tasks.
  2. Fork the Repo: Clone the repository and create a new branch for your work.
  3. Submit a Pull Request: When you’re ready, submit a pull request for review.

Areas to Contribute

  • Bug Fixes: Help resolve open bugs.
  • New Features: Suggest or implement new functionalities.
  • Documentation: Improve or expand the documentation, tutorials, or translations.
  • Testing: Write and improve automated tests to ensure the code remains stable.

Why Contribute?

  • Make an Impact: Help users access cinema programs in an accessible and open format.
  • Learn & Grow: Develop skills in C#, TypeScript, WebComponents, and web scraping.
  • Join a Community: Be part of a project with a focus on privacy, accessibility, and open-source ethics.

Data Sources

Data is sourced from the cinemas' official websites and TMDB.

All movie data, titles, and images are the property of their respective owners.

Technologies Used

Legal Disclaimer

This project is non-commercial, free, and open-source. Its sole purpose is to aggregate and present publicly available cinema program data from various cinemas in Hanover, Germany, for the convenience of users. The project does not intend to infringe on any copyrights or intellectual property rights, particularly under German and EU law.

  • Movie Data and Images: All movie titles, descriptions, images, and related content remain the property of the respective film studios, distributors, or other rights holders. This project merely sources such content from publicly accessible platforms, including cinema websites and The Movie Database (TMDB). The TMDB API is used for fetching supplementary data; however, this project is neither endorsed nor certified by TMDB.

  • Use of Scraping Tools: The scraping of cinema program data is done in compliance with publicly available information provided by cinemas. No protected content is accessed or distributed beyond what is openly provided on the cinemas' websites or public APIs. We do not circumvent any protection mechanisms, nor do we scrape personal data or information protected under copyright.

  • No Editorial Changes: The content displayed is provided as-is, directly from the data sources (cinemas and TMDB), without any editorial modification or interference. The website operates purely as an aggregator, presenting cinema programs in their original form.

  • No Commercial Intent: The project is entirely non-commercial. There is no intent to generate revenue or monetize any aspect of the content. The website does not display ads, collect user data, or generate profits in any form. The goal is to make cinema listings more accessible, particularly for venues that may not have a strong online presence.

  • Protection of Copyright: In the event that any content owner believes their rights have been infringed, we encourage them to contact us directly. Upon request, any infringing material will be promptly reviewed and removed if necessary. We strive to comply with all applicable intellectual property laws, including the German Copyright Act (Urheberrechtsgesetz, UrhG) and relevant EU directives.

For inquiries or concerns related to copyright or content usage, please open an issue in the repository or contact the project maintainers.

License

This project is licensed under the GNU Affero General Public License v3.0 (AGPL-3.0). It is free to use, modify, and distribute under the terms of the AGPL-3.0.

Acknowledgements