About | Installation | Docker | Documentation | Support

About

deemon is a command line tool written in Python that monitors artists for new releases, provides email notifications and can also integrate with the deemix library to automatically download new releases.

Support

Open an Issue | Discord

Installation

Using pip

$ pip install deemon

From source

$ pip install -r requirements.txt
$ python3 -m deemon

Docker

Docker support has been added for amd64, arm64 and armv7 architectures. It is recommended to save your docker run command as a script to execute via cron/Task Scheduler.

Note: Inside deemon's config.json, download_location must be set to /downloads until I can integrate this myself.

Example: Monitoring a directory of artists

docker run --name deemon \
       --rm \
       -v /path/to/deemon/config:/config \
       -v /path/to/music:/downloads \
       -v /path/to/deemix/config:/deemix  \
       -v /path/to/monitor:/import \
       ghcr.io/digitalec/deemon:latest \
       python3 -m deemon import /import

Example: Monitoring a file of artists

docker run --name deemon \
       --rm \
       -v /path/to/deemon/config:/config \
       -v /path/to/music:/downloads \
       -v /path/to/deemix/config:/deemix  \
       -v /file/to/monitor:/artists.txt \
       ghcr.io/digitalec/deemon:latest \
       python3 -m deemon import /artists.txt

Default Configuration:

{
    "check_update": 1,
    "debug_mode": false,
    "release_channel": "stable",
    "experimental_api": false,
    "query_limit": 5,
    "rollback_view_limit": 10,
    "prompt_duplicates": false,
    "prompt_no_matches": true,
    "new_releases": {
        "by_release_date": true,
        "release_max_age": 90
    },
    "global": {
        "bitrate": "320",
        "alerts": false,
        "record_type": "all",
        "download_path": "",
        "email": ""
    },
    "deemix": {
        "path": "",
        "arl": "",
        "check_account_status": true
    },
    "smtp_settings": {
        "server": "",
        "port": 465,
        "username": "",
        "password": "",
        "from_addr": ""
    },
    "plex": {
        "base_url": "",
        "token": "",
        "library": ""
    }
}