Metadata-Version: 2.4
Name: deemon-redux
Version: 2.27
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.

## Quick install

Requires **Python 3.8+**.

```bash
pip install deemon-redux
deemon -V
deemon --init
deemon monitor
```

On Linux/macOS, use `pip3` if `pip` points to Python 2. On Windows, run these in PowerShell or Terminal.

## Quick start

```bash
deemon --init          # create config and database (first run only)
deemon monitor         # add artists to watch
deemon refresh         # check for new releases
deemon download --help
```

Config is stored at `~/.config/deemon-redux` (Linux), `~/Library/Application Support/deemon-redux` (macOS), or `%appdata%\deemon-redux` (Windows).

More setup options: [installation docs](https://mon5termatt.github.io/deemon-redux/docs/installation/) · [configuration](https://mon5termatt.github.io/deemon-redux/docs/configuration/)

## Docker

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

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
```

## Development

Clone and install from source:

```bash
git clone https://github.com/mon5termatt/deemon-redux.git
cd deemon-redux
python3 -m venv .venv
source .venv/bin/activate   # Windows: .venv\Scripts\activate
pip install -r requirements.txt
pip install -e .
deemon --help
```

Or use the repo wrapper without activating the venv:

```bash
./bin/deemon monitor
```

## Documentation

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

## Contributing

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