Skip to main content

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)

Metadata

Release files for beets-notify 0.2.2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for beets-notify 0.2.2
File Size Uploaded
beets_notify-0.2.2.tar.gz 104.6 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for beets-notify 0.2.2
File Interpreter ABI Platform
beets_notify-0.2.2-py3-none-any.whl Python 3 none any Details

Total release size: 110.7 kB

Release files / beets_notify-0.2.2.tar.gz

Download URL beets_notify-0.2.2.tar.gz
Size 104.6 kB
Tags Source
SHA-256 checksum
How to use checksums
a6c5ebc0869e534945ed50686cb9945bd1db1f84e65cfe0fd05d906dbd489f14
BLAKE2b-256 checksum
How to use checksums
6e8d2f582fe8d31182684cc366fb0cf7a7c2a4482603ccc1c404bba09a4ec3af
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Jul 27, 2026.

Transparency log

Release files / beets_notify-0.2.2-py3-none-any.whl

Download URL beets_notify-0.2.2-py3-none-any.whl
Size 6.1 kB
Tags Python 3
SHA-256 checksum
How to use checksums
e16ab286112990e149a6f6b2ccb0acfda452740a3578c0c54fe8242b004076a7
BLAKE2b-256 checksum
How to use checksums
a42acd6e3e40487b6ec69e2b4cbf9be878014a36d39e31df9dcd5429de2640d2
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Jul 27, 2026.

Transparency log

Release history Release notifications | RSS feed

This release

0.2.2 This release

2 release files

0.2.1

2 release files

0.2.0

2 release files

0.1.1

2 release files

0.1.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page