TPDbCollectionMaker

KO | EN

gitlite — search

#ai #llm #go #golang #rust #linux #docker #nodejs #macos #java #windows #cli #awesome-list #open-source

TPDbCollectionMaker

(★ 33)

Quickly make Kometa (PMM) poster entries from ThePosterDatabase sets

TPDbCollectionMaker 최신버젼 다운로드

최종 버전 다운로드 (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# TPDbCollectionMaker
Python script to quickly make Kometa (PMM) poster entries from
[ThePosterDatabase](https://theposterdb.com) (TPDb) sets.

Because TPDb doesn't permit automated scraping, this tool reads HTML files.

This tool will read handle collections, movies, shows, and season posters all in
one file and output YAML that can be used in Kometa metadata files.
An example of part of the output for TheDoctor30's
[Marvel Television Set](https://theposterdb.com/set/11318) is shown below:

```yaml
# --------------------------------------------------------------------------------
# collections
Marvel Television:
  url_poster: https://theposterdb.com/api/assets/19724
# --------------------------------------------------------------------------------
# shows
Marvel's Daredevil:
  url_poster: https://theposterdb.com/api/assets/19725
  seasons:
    1: {url_poster: https://theposterdb.com/api/assets/19726}
    2: {url_poster: https://theposterdb.com/api/assets/19727}
    3: {url_poster: https://theposterdb.com/api/assets/19728}
Marvel's Jessica Jones:
  url_poster: https://theposterdb.com/api/assets/19729
  seasons:
    1: {url_poster: https://theposterdb.com/api/assets/19730}
    2: {url_poster: https://theposterdb.com/api/assets/19731}
    3: {url_poster: https://theposterdb.com/api/assets/19732}
Marvel's Luke Cage:
  url_poster: https://theposterdb.com/api/assets/19733
  seasons:
    1: {url_poster: https://theposterdb.com/api/assets/19734}
    2: {url_poster: https://theposterdb.com/api/assets/19735}
# etc..
```

# How to Use
## Help Menu
This is a Python command-line tool. All arguments are shown with `--help`:

```console
$ uv run main.py -h
usage: main.py [-h] [-p] [-q] HTML_FILE

TPDb Collection Maker

positional arguments:
  HTML_FILE           file with TPDb Collection page HTML to scrape

optional arguments:
  -h, --help          show this help message and exit
  -p, --primary-only  only parse the primary set (ignore any Additional Sets)
  -q, --always-quote  put all titles in quotes ("")
  ```

## Installation

> NOTE: If copying these commands, do __not__ copy the `$` - that is just to
show this is a _command_.

1. Install `uv` (you may type `python`, or `py` instead of `python3`).

```console
python3 pip install uv
```

2. Download this tool:
```console
git clone https://github.com/CollinHeist/TPDbCollectionMaker/
```

3. Run the script (see [Arguments](#arguments) for details). The following
command prints the help menu.
```
uv run main.py -h
```

## Getting Page HTML
Because TPDb doesn't permit automated scraping, this tool reads HTML files. To
get the HTML of a set, right-click the set page and select `Inspect`:

This should launch your browser's HTML inspector. It should look something like:

Go to the top-most HTML element (if HTML is selected, hold the left-arrow key
to collapse all the HTML). The top-most HTML should look like:

```html
<!DOCTYPE html>
<html class="h-100" lang="en"><head>
...
```

Right-click the `<html class="h-100" lang="en"><head>` element, go to `Copy` >
`Inner HTML`. Your clipboard now has the complete HTML of the set page; paste
this into some file alongside the `main.py` file of this project. This file will
be the input to the script (see below).

## Arguments
### `html`
Input HTML file to parse.

### `-p`, `--primary-only`
Only parse the primary content on the given HTML page, ignoring any Additional
Sets. If unspecified, then the entire page is parsed.

### `-q`, `--always-quote`
Quote all titles in the output. If unspecified, only titles with colons are
quoted.

Below is an example of this argument:

```console
$ uv run main.py in.html --always-quote
"Iron Man (2008)":
  url_poster: https://theposterdb.com/api/assets/9773
"The Incredible Hulk (2008)":
  url_poster: https://theposterdb.com/api/assets/9775
"Iron Man 2 (2010)":
  url_poster: https://theposterdb.com/api/assets/9776
```

TPDbCollectionMaker

TPDbCollectionMaker 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

TPDbCollectionMaker

TPDbCollectionMaker 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Download README