Metadata-Version: 2.4
Name: deemon-redux
Version: 2.25
Summary: Deemon Redux — monitor new releases by artists and auto download using the deemix library
Home-page: https://github.com/mon5termatt/deemon-redux
Author: digitalec
License: GPL3
Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
Classifier: Programming Language :: Python :: 3.8
Classifier: Operating System :: OS Independent
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: deemix~=3.6
Requires-Dist: packaging~=23.0
Requires-Dist: requests~=2.28.0
Requires-Dist: click~=8.1.0
Requires-Dist: setuptools~=66.1.0
Requires-Dist: wheel~=0.43.0
Requires-Dist: PlexAPI~=4.5.2
Requires-Dist: tqdm~=4.61.0
Requires-Dist: mutagen~=1.46
Requires-Dist: Unidecode~=1.3.6
Dynamic: author
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: license
Dynamic: license-file
Dynamic: requires-dist
Dynamic: requires-python
Dynamic: summary

# Deemon Redux

<img src="deemon/assets/images/deemon.png" alt="Deemon Redux" width="300">

Deemon Redux is a continuation of the archived [deemon](https://github.com/digitalec/deemon) project — a monitoring utility for new artist releases with email alerts and automated downloading via the deemix library.

## Development setup

### Prerequisites

- Python `>= 3.8`

### Install dependencies

```bash
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
pip install -e .
```

### Run without activating `.venv`

If you prefer not to `source .venv/bin/activate`, use the repo wrapper:

```bash
./bin/deemon --help
./bin/deemon monitor
```

### Initialize local app data

```bash
deemon --init
```

This creates the local configuration/database used by the CLI.

## Run locally

```bash
deemon --help
deemon monitor
```

For command-specific help:

```bash
deemon monitor -h
```

## Docker

Pre-built images are published to GitHub Container Registry on each release:

```bash
docker pull ghcr.io/mon5termatt/deemon-redux:latest
```

Example usage:

```bash
docker run --rm -it \
  -v deemon-redux-config:/config \
  -v ~/Music:/downloads \
  ghcr.io/mon5termatt/deemon-redux:latest --help

docker run --rm -it \
  -v deemon-redux-config:/config \
  -v ~/Music:/downloads \
  ghcr.io/mon5termatt/deemon-redux:latest --init

docker run --rm -it \
  -v deemon-redux-config:/config \
  -v ~/Music:/downloads \
  ghcr.io/mon5termatt/deemon-redux:latest refresh
```

Configuration is stored in the `/config` volume (mapped to `~/.config/deemon-redux` inside the container).

## Testing / sanity checks

```bash
deemon test -h
deemon test -E '<URL regex pattern>'
deemon test -e
```

## Documentation

- Online docs: https://mon5termatt.github.io/deemon-redux/
- CLI help: `deemon <command> -h`
- Source docs in-repo under `docs/`

## Contributing

Open an issue for bugs/feature requests and submit PRs with a short test plan.
