Module i3status_rs::blocks::notmuch

Count of notmuch messages

This block queries a notmuch database and displays the count of messages.

The simplest configuration will return the total count of messages in the notmuch database stored at $HOME/.mail

Note that you need to enable notmuch feature to use this block:

cargo build --release --features notmuch

Configuration

Key	Values	Default
format	A string to customise the output of this block. See below for available placeholders.	" $icon $count "
maildir	Path to the directory containing the notmuch database. Supports path expansions e.g. ~.	~/.mail
query	Query to run on the database.	""
threshold_critical	Mail count that triggers critical state.	99999
threshold_warning	Mail count that triggers warning state.	99999
threshold_good	Mail count that triggers good state.	99999
threshold_info	Mail count that triggers info state.	99999
interval	Update interval in seconds.	10

Placeholder	Value	Type	Unit
icon	A static icon	Icon	-
count	Number of messages for the query	Number	-

Example

[[block]]
block = "notmuch"
query = "tag:alert and not tag:trash"
threshold_warning = 1
threshold_critical = 10
[[block.click]]
button = "left"
update = true

Icons Used

• mail

Structs

• Config

Functions

• run