Skip to main content

afew

GithubTag CI Status

About

afew is an initial tagging script for notmuch mail:

Its basic task is to provide automatic tagging each time new mail is registered with notmuch. In a classic setup, you might call it after ‘notmuch new’ in an offlineimap post sync hook.

It can do basic things such as adding tags based on email headers or maildir folders, handling killed threads and spam.

In move mode, afew will move mails between maildir folders according to configurable rules that can contain arbitrary notmuch queries to match against any searchable attributes.

fyi: afew plays nicely with alot, a TUI for notmuch mail ;)

IRC

Feel free to ask your questions and discuss usage in the #afewmail IRC Channel on Libera.Chat.

Features

  • spam handling (flush all tags, add spam)

  • killed thread handling

  • automatic propagation of tags to whole thread

  • tags posts to lists with lists, $list-id

  • autoarchives mails sent from you

  • catchall -> remove new, add inbox

  • can operate on new messages [default], --all messages or on custom query results

  • can move mails based on arbitrary notmuch queries, so your sorting may show on your traditional mail client (well, almost ;))

  • has a --dry-run mode for safe testing

Installation and Usage

Full documentation is available in the docs/ directory and in rendered form at afew.readthedocs.io.

Have fun :)

Metadata

Release files for afew 4.0.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 afew 4.0.2
File Size Uploaded Provenance
afew-4.0.2.tar.gz 43.3 kB With provenance Details

Built distribution (wheel)

Table of built distributions (wheels) for afew 4.0.2
File Interpreter ABI Platform
afew-4.0.2-py3-none-any.whl Python 3 none any Details

Total release size: 78.3 kB

Release files / afew-4.0.2.tar.gz

Download URL afew-4.0.2.tar.gz
Size 43.3 kB
Tags Source
SHA-256 checksum
How to use checksums
82c7eaca8543e825d7775e0c8b20399ead1eef013acb2996f52b26c69bbaf84e
BLAKE2b-256 checksum
How to use checksums
246dc89b2aa4fc9cb07c57dc12818bb9d582e3564540c3c8d61655e536ad2e60
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 21, 2026.

Transparency log

Release files / afew-4.0.2-py3-none-any.whl

Download URL afew-4.0.2-py3-none-any.whl
Size 35.1 kB
Tags Python 3
SHA-256 checksum
How to use checksums
22847a5a171cd0d87adc9265aacdb39c9716f86a223cbb1b354478e4cfc39632
BLAKE2b-256 checksum
How to use checksums
b6f139f31f2924d0089c34c0d9adbd8c6ba395f1647198b7a76175ac0d20673c
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 21, 2026.

Transparency log

Security for afew 4.0.2

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.

Full provenance

All 2 files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for afew-4.0.2.tar.gz

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 21, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

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