sxyazi/yazi · error

No receiver has the ability to receive `{kind}` messages.

Error message

No receiver has the ability to receive `{kind}` messages.

What it means

Broadcast-target validation in `ya pub`: the send was addressed to all receivers (`Id::ZERO`) and at least one peer exists, but none of them advertised the ability to handle messages of this `kind`. The faulting input is the message kind combined with the current peer set.

Source

Thrown at yazi-cli/src/dds/shot.rs:65

	pub(super) fn ensure_version(version: Option<&str>) -> Result<()> {
		if version != Some(yazi_version::version()) {
			bail!(
				"Incompatible version (Ya {}, Yazi {}). Restart all `ya` and `yazi` processes if you upgraded either.",
				yazi_version::version(),
				version.unwrap_or("Unknown")
			);
		}
		Ok(())
	}

	pub(super) fn ensure_ability(peers: &HashMap<Id, Peer>, kind: &str, receiver: Id) -> Result<()> {
		match (receiver, peers.get(&receiver).map(|p| p.able(kind))) {
			// Send to all receivers
			(Id::ZERO, _) if peers.is_empty() => {
				bail!("No receiver found. Check if any receivers are running.")
			}
			(Id::ZERO, _) if peers.values().all(|p| !p.able(kind)) => {
				bail!("No receiver has the ability to receive `{kind}` messages.")
			}
			(Id::ZERO, _) => Ok(()),

			// Send to a specific receiver
			(_, Some(true)) => Ok(()),
			(_, Some(false)) => {
				bail!("Receiver `{receiver}` does not have the ability to receive `{kind}` messages.")
			}
			(_, None) => bail!("Receiver `{receiver}` not found. Check if the receiver is running."),
		}
	}
}

View on GitHub (pinned to 5f901b886b)

Solutions

1. Start a yazi instance (receiver) that registers a handler for this message kind.
2. Check the kind string for typos against the receiver's registered abilities.
3. List peers with `ya pub --list` to inspect who is running and what they can receive.

When it happens

Trigger: Thrown at yazi-cli/src/dds/shot.rs:65 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of sxyazi/yazi@5f901b886b (2026-09-02). Data as JSON: /api/errors/852cf81fbedbb30c. Report an issue: GitHub.