Metadata-Version: 2.3
Name: lparchive2epub
Version: 1.5.0
Summary: 
Author: Arwalk
Author-email: Arwalk <siragentprovocateurarwalk@gmail.com>
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Requires-Dist: beautifulsoup4>=4.12.2,<5
Requires-Dist: tqdm>=4.66.4,<5
Requires-Dist: aiohttp>=3.9.5,<4
Requires-Dist: aiohttp-client-cache[all]>=0.14
Requires-Dist: ebooklib>=0.20
Requires-Python: >=3.12, <4
Project-URL: Repository, https://github.com/Arwalk/lparchive2epub
Description-Content-Type: text/markdown

# lparchive2pub

this tool (and library) aims at helping people extracting full epubs of Let's Plays from https://lparchive.org/

```
usage: lparchive2epub [-h] [--no-cache] [--strict] URL OUTPUT_FILE

A tool to transform a Let's Play from lparchive.org to epub format.

positional arguments:
  URL
  OUTPUT_FILE

options:
  -h, --help   show this help message and exit
  --no-cache   Don't cache url calls
  --strict     Fail instead of skipping resources (images...) that can't be
               retrieved
```

The repository also contains the script `util/all_archives.py` that tries to scrape all LPs from lparchive.

## Requirements

### Dev

uv, python 3.12

### Users

python >= 3.12

## Installation

`pip install lparchive2epub`

To have it installed in its own separate environment, you can use https://github.com/pypa/pipx

`pipx install lparchive2epub`

A standalone executable is available for releases on windows. See the releases page.

## Known limitations

- ~~Similar images present in multiple pages in the let's play are duplicated, bloating the file. Though recurring images are usually smileys, so not too big.~~ Now handled!
- ~~Links to images are not properly saved.~~ Now working properly!
- LPs that are mostly link to YouTube videos are not very interesting to transform to epub
- Some LPs completely fail to be downloaded.
- Some LPs contain broken links (typos like `hhttp://`, dead image hosts...). Common typos are repaired automatically; resources that still can't be retrieved are left as external links, and a report is printed at the end. Please paste that report in a [GitHub issue](https://github.com/Arwalk/lparchive2epub/issues/new) so the case can be handled in a future release. Use `--strict` to fail instead.
