Metadata-Version: 2.1
Name: ha-franklin
Version: 0.1.0
Summary: ha-franklin monitors CUPSD queues and writes information to MQTT for Home Assistant
Author: Joe Block
Author-email: jpb@unixorn.net
Requires-Python: >=3.10.0,<4.0
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Requires-Dist: ha-mqtt-discoverable (>=0.8.1,<0.9.0)
Requires-Dist: pyaml (>=21.10.1,<22.0.0)
Requires-Dist: shell (>=1.0.1,<2.0.0)
Description-Content-Type: text/markdown


# ha-franklin

[![License](https://img.shields.io/github/license/unixorn/ha-franklin.svg)](https://opensource.org/license/apache-2-0/)
[![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)
[![GitHub last commit (branch)](https://img.shields.io/github/last-commit/unixorn/ha-franklin/main.svg)](https://github.com/unixorn/ha-franklin)
[![Downloads](https://static.pepy.tech/badge/ha-franklin)](https://pepy.tech/project/ha-franklin)

<!-- START doctoc generated TOC please keep comment here to allow auto update -->
<!-- DON'T EDIT THIS SECTION, INSTEAD RE-RUN doctoc TO UPDATE -->
## Table of Contents

- [Background](#background)
- [Usage](#usage)
  - [Configuration](#configuration)
  - [Running the Monitor](#running-the-monitor)

<!-- END doctoc generated TOC please keep comment here to allow auto update -->

## Background

I wanted a non-toy test example of using [ha-mqtt-discoverable](https://github.com/unixorn/ha-mqtt-discoverable/tree/v0.8.1).

`ha-franklin` will monitor CUPSD print queues, and present a binary sensor to Home Assistant over MQTT showing whether the printer is printing.

I use this to turn the smart switch for the HP 4050N in the basement on and off so that by the time I walk downstairs from my office after printing something, Home Assistant has turned on the power to the printer and the job has started printing.


## Usage

### Configuration

Create a config file (yaml) with a list of dictionaries in it. Each dictionary should have the following keys:
- `mqtt_server`: DNS name or a raw IP.
- `mqtt_user`: the_mqtt_user
- `mqtt_password`: the_mqtt_password
- `name`: Franklin@cupsd
- `unique_id`: printername-cupsd
- `cupsd_queue_name`: Queue_name_on_cupsd_server
- `cupsd_server`: cupsd.example.com
- `check_interval`: 10

The easiest way to create a configuration file is to start by copying `config/config-example.yaml` and editing it to fit.

### Running the Monitor

I recommend using `docker`, `nerdctl` or `podman` to run the tooling in a container.

`docker run -v "$(pwd)/config":/config --rm unixorn/ha-franklin ha-cupsd-monitor-queues --settings-file /config/config.yaml`

