Metadata-Version: 2.1
Name: LinkChecker-GUI
Version: 10.0.0b3
Summary: GUI for LinkChecker
Project-URL: Homepage, https://github.com/linkchecker/linkchecker-gui
Author: LinkChecker Authors
Maintainer: LinkChecker Authors
License-File: COPYING.icons
License-File: LICENSE
Classifier: Development Status :: 4 - Beta
Classifier: License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Internet :: WWW/HTTP :: Site Management :: Link Checking
Requires-Python: >=3.9
Requires-Dist: linkchecker>=10.1
Requires-Dist: pyqt6
Requires-Dist: pyqt6-qscintilla
Description-Content-Type: text/markdown

# LinkChecker-GUI

[![Build Status](https://github.com/linkchecker/linkchecker-gui/actions/workflows/build.yml/badge.svg?branch=master)](https://github.com/linkchecker/linkchecker-gui/actions/workflows/build.yml)
[![GPL-3](https://img.shields.io/badge/license-GPL3-d49a6a.svg)](https://opensource.org/licenses/GPL-3.0)

This is the GUI client for [LinkChecker](https://linkchecker.github.io/linkchecker/).

## Installation

Python 3.9 or later is needed. Using pip to install LinkChecker-GUI:

`pip3 install linkchecker-gui`

You may wish to first install the dependencies from you distribution e.g.:

`apt install linkchecker python3-pyqt6.qsci python3-pyqt6.qthelp`

The version in the pip repository may be old, to install the latest code first
install qhelpgenerator and rcc e.g.

`apt install qt6-documentation-tools qt6-base-dev-tools`

Then:

`pip3 install https://github.com/linkchecker/linkchecker-gui/archive/master.tar.gz`

## Usage

`linkchecker-gui`

A freedesktop.org desktop entry is installed for compatible environments.

On Debian/Ubuntu if LinkChecker-GUI fails to start with an error:

    qt.qpa.plugin: Could not load the Qt platform plugin "xcb" in "" even though it was found.

this can be resolved by installing libxcb-cursor0:

`apt install libxcb-cursor0`

Recursion depth and verbose output (whether every URL checked is shown or just those with errors)
are configured in Edit/Options. These settings are specific to LinkChecker-GUI and independent
of LinkChecker. More advanced settings are shared with the default LinkChecker linkcheckerrc.

## Development

Development is managed on [GitHub](https://github.com/linkchecker/linkchecker-gui).
