Metadata-Version: 2.1
Name: screener
Version: 0.5.0
Summary: Check e-book files for security and privacy issues.
Home-page: https://github.com/tjkuson/screener/
License: LGPL-3.0-only
Keywords: ebook,security,privacy,epub,mobi,kindle
Author: Tom Kuson
Author-email: mail@tjkuson.me
Requires-Python: >=3.10,<4.0
Classifier: License :: OSI Approved :: GNU Lesser General Public License v3 (LGPLv3)
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Topic :: Security
Classifier: Topic :: Utilities
Requires-Dist: EbookLib (>=0.18,<0.19)
Requires-Dist: beautifulsoup4 (>=4.12.2,<5.0.0)
Requires-Dist: mobi (>=0.3.3,<0.4.0)
Project-URL: Repository, https://github.com/tjkuson/screener/
Description-Content-Type: text/markdown

# Screener

[![image](https://img.shields.io/pypi/v/screener.svg)](https://pypi.python.org/pypi/screener)
[![image](https://img.shields.io/pypi/pyversions/screener.svg)](https://pypi.python.org/pypi/screener)

Check e-book files for security and privacy issues.

## Motivation

E-books are great, but the common file formats have security and privacy issues. Most use web browser technologies like HTML, CSS, and JavaScript. Therefore, e-books are vulnerable to security and privacy issues that already exist on the web.

Screener aims to check e-book files for these issues so that you can read with peace of mind!

## Features

- Check e-book files for JavaScript tags.
- Check e-book files for images with external sources to prevent tracking.
- Supports `.epub`, `.mobi`, and `.azw3` files.

## Get started

### Prerequisites

Screener requires [Python](https://www.python.org/about/gettingstarted/).

### Installing

Screener is available on [PyPI](https://pypi.org/project/screener/). To install, run:

```bash
pip install screener
```

#### Development installation

To install Screener for development, ensure you have [Poetry](https://python-poetry.org/) clone the repository and run:

```bash
poetry install
```

### Usage

To check a file, try:

```shell
screener path/to/file.epub
```

For help:

```shell
screener --help
```

## Contributing

Pull requests are welcome and appreciated. For major changes, please open an issue first to discuss what you would like to change. Please make sure to update tests as appropriate.

If you have found a bug or have a feature request, please open an issue.

## Versioning

This project uses [SemVer](http://semver.org/) for versioning.

## Authors

Screener was created by Tom Kuson ([@tjkuson](https://github.com/tjkuson)).

## Licence

Screener is released under the [LGPL version 3](LICENCE).

