Skip to main content

An initial tagging script for notmuch mail

Project description

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

Project details


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.0.tar.gz (43.4 kB view details)

Uploaded Source

Built Distribution

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

afew-4.0.0-py3-none-any.whl (31.4 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: afew-4.0.0.tar.gz
  • Upload date:
  • Size: 43.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for afew-4.0.0.tar.gz
Algorithm Hash digest
SHA256 77a59f5ede0ae672dac3076c5971e0cb4fa73095eac6cf50434c6655e5f59b74
MD5 cfe35adc3b340526fb400470843bda76
BLAKE2b-256 5426642065363dcc2100389b354a085bef6bf32bdd4b6a933fe48fe077da99d5

See more details on using hashes here.

Provenance

The following attestation bundles were made for afew-4.0.0.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.

File details

Details for the file afew-4.0.0-py3-none-any.whl.

File metadata

  • Download URL: afew-4.0.0-py3-none-any.whl
  • Upload date:
  • Size: 31.4 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for afew-4.0.0-py3-none-any.whl
Algorithm Hash digest
SHA256 13ead5985ddc74b00c8a84c8c526f9816cbb4599cfbb70eeb1c39caa4843d5a2
MD5 3482112671dcd6147479e83bfcb0d7a1
BLAKE2b-256 c15d597938baf0b586b8b6436289e83eb25862e0ded9dd0b5439f7f80b79e487

See more details on using hashes here.

Provenance

The following attestation bundles were made for afew-4.0.0-py3-none-any.whl:

Publisher: release.yml on afewmail/afew

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

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page