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.
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)
| File | Size | Uploaded | |
|---|---|---|---|
| beets_notify-0.2.2.tar.gz | 104.6 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| 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 logRelease 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