afew · PyPI

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 ;)

https://github.com/pazz/alot

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 :)

Development Status
- 4 - Beta
Environment
- Console
Intended Audience
- End Users/Desktop
Programming Language
- Python
Topic

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

afew-4.0.2.tar.gz (43.3 kB view details)

Uploaded Jul 21, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

afew-4.0.2-py3-none-any.whl (35.1 kB view details)

Uploaded Jul 21, 2026 Python 3

File details

Details for the file afew-4.0.2.tar.gz.

File metadata

Download URL: afew-4.0.2.tar.gz
Upload date: Jul 21, 2026
Size: 43.3 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.13.14

File hashes

Hashes for afew-4.0.2.tar.gz
Algorithm	Hash digest
SHA256	`82c7eaca8543e825d7775e0c8b20399ead1eef013acb2996f52b26c69bbaf84e`
MD5	`d66e37e65939a51f79af6b89e2042255`
BLAKE2b-256	`246dc89b2aa4fc9cb07c57dc12818bb9d582e3564540c3c8d61655e536ad2e60`

See more details on using hashes here.

Provenance

The following attestation bundles were made for afew-4.0.2.tar.gz:

Publisher: release.yml on afewmail/afew

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: afew-4.0.2.tar.gz
- Subject digest: 82c7eaca8543e825d7775e0c8b20399ead1eef013acb2996f52b26c69bbaf84e
- Sigstore transparency entry: 2212428332
- Sigstore integration time: Jul 21, 2026
Source repository:
- Permalink: afewmail/afew@9e2ddbfa887f0416fd642c6bc822b1c2a44f63f6
- Branch / Tag: refs/tags/4.0.2
- Owner: https://github.com/afewmail
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: release.yml@9e2ddbfa887f0416fd642c6bc822b1c2a44f63f6
- Trigger Event: push