beets-notify

A beets plugin to notify your devices and services when new album(s) are imported into your library.

Apprise is the backend used to send push notifications to your phone, matrix channel, email, push notification service, and many others. Apprise supports nearly all notification services.

If your notification service supports it, album art will be embedded in the notification, automatically handled through Apprise's attachment system.

Install

From PyPI (recommended):

$ pipx inject beets beets-notify

From source (development/testing):

$ git clone https://github.com/brege/beets-notify
$ cd beets-notify
$ pipx inject beets -e .

Apprise Urls

Apprise uses service urls.

Pushover

pover://abcdefghijklmnopqrstuvwxyz1234@xyz1234zbcdefghijklmnopqrstuvw

Email (Fastmail supports 100+ aliased domains)

Using an app-password 1234 5678 5a5c 3b3d for the main email account@fastmail.com using the alias alias@sent.as:

mailto://1234 5678 5a5c 3b3d@sent.as?user=account@fastmail.com&to=alias@sent.as

Configuration

Enable the plugin in your ~/.config/beets/config.yaml:

plugins: notify

notify:
    apprise_urls:
        - "pover://abcdefghijklmnopqrstuvwxyz1234@xyz1234zbcdefghijklmnopqrstuvw"
    truncate: 3                  # albums to enumerate before truncating (...)
    body_maxlength: 1024         # max body chars
    artwork: yes                 # attach artwork
    artwork_maxsize: 0           # max file size in bytes (0 = service limits)
    collage: yes                 # generate NxM collage grid of artwork (max 3x3)