Metadata-Version: 2.1
Name: fa-scrapper
Version: 0.3.0
Summary: A Letterboxd-compatible FilmAffinity scrapper.
Home-page: https://github.com/mx-psi/fa-scrapper
License: GPL-3.0-or-later
Author: Pablo Baeyens
Author-email: pbaeyens31+github@gmail.com
Requires-Python: >=3.6,<4.0
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: End Users/Desktop
Classifier: License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)
Classifier: Natural Language :: English
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Topic :: Utilities
Requires-Dist: arrow (>=1.2.1,<2.0.0)
Requires-Dist: beautifulsoup4 (>=4.9.1,<5.0.0)
Requires-Dist: lxml (>=4.5.1,<5.0.0)
Requires-Dist: requests (>=2.21.0,<3.0.0)
Project-URL: Authors, https://github.com/mx-psi/fa-scrapper/blob/master/AUTHORS
Project-URL: Bug Tracker, https://github.com/mx-psi/fa-scrapper/issues
Project-URL: Changelog, https://github.com/mx-psi/fa-scrapper/blob/master/CHANGELOG.md
Project-URL: Repository, https://github.com/mx-psi/fa-scrapper
Description-Content-Type: text/markdown

# filmAffinity to Letterboxd

(_[Versión en español](https://github.com/mx-psi/fa-scrapper/blob/master/README_es.md)_)

Generates CSV file compatible with
[Letterboxd diary importer](https://letterboxd.com/about/importing-data/) from
FilmAffinity user's data given their ID.

_This program is intended for personal use only; please ensure the person you
are getting the data from consents to it beforehand and check which privacy and
data protection regulations might apply before using the program to get data
from other people._

## Installation

### Using `pip`

You can install `fa-scrapper` using `pip` ([Python 3.5+](https://www.python.org)):

```sh
python3 -m pip install fa-scrapper
```

Then run

```sh
fa-scrapper [--csv FILE] [--lang LANG] id
```

### Using Docker

You need to install Docker. Once installed, run:

```sh
docker run --name fa-container fascrapperdev/fascrapper fa-scrapper id
docker cp fa-container:/*.csv .
docker rm fa-container`
```

## Getting your IDs

In order to get your FilmAffinity data you need to find out what your
FilmAffinity ID is. There are different IDs for your user ratings and your
lists.

### How to get your user id

Go to your profile page and copy the `user_id` field from the URL:

`filmaffinity.com/es/userratings.php?user_id=`**XXXXXX**

### How to get a list id

Go to the list pages (in the left menu), and access the list you want (it needs
to be public).

You need to copy the `list_id` field from the URL:

`filmaffinity.com/es/mylist.php?list_id=`**XXXXXX**

## Options

- `--list LIST` sets ID of the public list you want to export
- `--csv FILE` sets CSV export file name to `FILE`
- `--lang LANG` sets language to `LANG`. Letterboxd importer works best in
  English, the default option.

Run `fa-scrapper --help` to see further options.

