beets-notify 0.1.0

A beets plugin to send notifications when albums are imported

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 source (development/testing):

$ git clone https://github.com/brege/beets-notify
$ cd beets-notify
$ pipx inject beets apprise
$ cp beetsplug/notify.py ~/.config/beets/plugins/

From PyPI (not published yet):

$ pipx inject beets apprise
$ pip install beets-notify

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 [e-mail] using the alias [e-mail]:

mailto://1234 5678 5a5c [e-mail]?user=[e-mail]&to=[e-mail]

beets/config.yaml

notify:
    apprise_urls:
        - "pover://abcdefghijklmnopqrstuvwxyz1234@xyz1234zbcdefghijklmnopqrstuvw"
    truncate: 3                  # albums to enumerate before truncating (...)
    body_maxlength: 512          # max body chars (pushover: 1024)
    artwork: yes                 # attach artwork
    artwork_maxsize: 1000000     # (bytes) limits (pushover: 5MB)
    show_first_art: yes          # show art for multiple album imports