Metadata-Version: 2.1
Name: sceance
Version: 0.1.4
Summary: Uses a watchlist and favorite theaters to suggest film screenings
Home-page: https://github.com/sjmignot/sceance
Author: Samuel Mignot
Author-email: sjmignot@gmail.com
License: MIT License

Copyright (c) 2019, Samuel Mignot

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.

Download-URL: https://github.com/sjmignot/sceance/archive/v_01.tar.gz
Description: Sceance is an application for moviegoers. If you provide it with a list of your favorite cinemas and your movie watchlist, it suggests showtimes, letting you watch your favorite movies in theaters.
        
        It was designed with Paris, a city full of small and independent cinemas, in mind.
        
        ## Installation
        
        To start running sceance, install the project and enable the Google calendar API.
        
        ### Dependencies
        
        Most dependencies are optional:
        
        - **A Letterboxd account**: sceance currently provides a way of downloading your watchlist from letterboxd provided you store your letterboxd credentials in a .envrc file. This is done with the `update_watchlist.py` file. Otherwise you can manually create a watchlist as a list of newline seperated film titles.
        
        - **A Google Account**: for sceance to create and suggest events to your calendar.
        
        - **Firefox**: to run the selenium headless browser to find film showings (with a little customization to `get_showings.py` you can use google chrome instead).
        
        ### Download the app
        
        Currently sceance is not available on pip, but you can clone it directly from this repository.
        
        ```sh
        git clone git@github.com:sjmignot/film-to-cal.git
        ```
        
        Then, install the dependencies by running the following line:
        
        ```sh
        pip install -r requirements.txt
        ```
        
        ### Enable the Google calendar API
        
        To enable the Google calendar API, you need to download a credentials file from the following link and place it in the `film_to_cal/film_to_calc/data` subfolder. This file can be downloaded from:
        
        `https://developers.google.com/calendar/quickstart/python?hl=en#step_1_turn_on_the`
        
        ## How sceance works
        
        Sceance uses selenium to gather showtime information for every theater in your theater.txt file, from Google. These films are then intersected with your watchlist. Details on the resulting films and their showtimes are then filtered out based on 9am-5pm work hours. For all the films that remain, you are prompted with a list of showtimes and can select one.
        
        This showtime is then automatically added to your calendar using the google calendar api. Note, for now this requires that you [enable the Google calendar API](#enable-the-google-calendar-api): doing this allows sceance to write to your calendar.
        
        ## Contribution Guidelines
        
        No contribution guidelines yet.
        
Keywords: movie theater,showtimes,selenium,movies,film
Platform: UNKNOWN
Description-Content-Type: text/markdown
