HELP.txt

kp2imdb v1.0.2
https://github.com/oklookat/kp2imdb
https://donationalerts.com/r/oklookat
https://boosty.to/oklookat/donate

Программа конвертирует фильмы (тайтлы) из Кинопоиска в список ID на IMDB.

== Использование ==

./kp2imdb -m file.json

Флаг -m включает ручной ввод IMDB ID при ошибке или когда тайтл не найден.

Начнется сопоставление тайтлов, будет создан файл links.json с уже сопоставленными тайтлами.
По завершению работы будет создан файл в формате {текущее_время_в_unix}.txt.
В TXT файле будет список IMDB id, разделенных переносом строки.

Список ID из TXT можно использовать в скрипте IMDB List Importer:
https://greasyfork.org/en/scripts/23584-imdb-list-importer

== Откуда взять JSON файл? ==

1. Создать самому. 

Пример JSON файла:

[
    {"id":"462762","name":"Железный человек 3","alt_name":"Iron Man Three (2013) 125 мин."},
    {"id": "471158","name": "Выкрутасы","alt_name": " (2010) 97 мин."},
    {"id": "404900","name": "Во все тяжкие (сериал)","alt_name": "Breaking Bad (2008-2013) 47 мин."},
    {"id": "655800","name": "Черное зеркало (сериал)","alt_name": "Black Mirror (2011-...) 43 мин."},
]

id это ID на Кинопоиске. name и alt_name должны быть правильно заполнены, в примере видно какие названия должны быть для фильмов и сериалов.

2. Кинопоиск + скрипт для TamperMonkey.

Скачать:
https://github.com/oklookat/kp2imdb/blob/main/kpexport.js
https://greasyfork.org/en/scripts/487107-kinopoisk-folder-exporter

Краткий гайд:
1. Устанавливаете скрипт (инструкция в сделку не входит).
2. Переходите в папку на Кинопоиске (например в любимые фильмы).
3. Устанавливаете для папки "показывать" на максимальное значение (например 200).
4. Возле "выделить всё" нажимаете на красный фон. Скачивается JSON файл.
5. Если страниц больше чем одна, переходите на следующую страницу и повторяете с пункта 4.

== Как происходит сопоставление ==

1. Поиск на IMDB в формате "name (year)". Пример: "Мстители 2012".
2. Если фильм не найден или происходит ошибка, повторяется первый пункт,
только с использованием alt_name.
3. Если фильм снова не найден или ошибка, то при флаге -m вы можете ввести id вручную.
4. Если был получен ID фильма на IMDB, то он сохраняется в links.json в формате "id_кинопоиска:id_imdb".

Стоит иметь ввиду, что некоторые фильмы могут быть неверно сопоставлены или не найдены.
Это может быть если у фильма необычное название, или например оно на русском языке.