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.pyfile. 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.pyyou can use google chrome instead).
Download the app
Currently sceance is not available on pip, but you can clone it directly from this repository.
git clone git@github.com:sjmignot/film-to-cal.git
Then, install the dependencies by running the following line:
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: doing this allows sceance to write to your calendar.
Contribution Guidelines
No contribution guidelines yet.
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
File details
Details for the file sceance-0.1.6.4.tar.gz.
File metadata
- Download URL: sceance-0.1.6.4.tar.gz
- Upload date:
- Size: 21.3 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/3.1.1 pkginfo/1.5.0.1 requests/2.22.0 setuptools/40.8.0 requests-toolbelt/0.9.1 tqdm/4.42.1 CPython/3.7.4
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
ce62b865da1fa9683d83f0e38e49e1899cc6006550f1ff9f8cc36408dc66e2ef
|
|
| MD5 |
bbfc420791f2ed4e3f65d1744c9401b2
|
|
| BLAKE2b-256 |
b14fbcd0a95c91d969f38cc30e8bb1da281877f18ad3424823f85d8b83c4fcbc
|
