pfefferle / webfinger-cli

1.1.0 2026-09-17 09:34 UTC

Requires

• php: ^8.2
• ext-curl: *
• ext-json: *
• ext-mbstring: *
• barnabywalters/mf-cleaner: ^0.2.0
• mf2/mf2: ^0.5.0
• symfony/console: ^7.4 || ^8.0

Requires (Dev)

• phpunit/phpunit: ^11.5

MIT

• Matthias Pfefferle

• finger
• webfinger
• activitypub
• fediverse

Published on Packagist.org on 2026-09-17 09:35 UTC

README

A small command line tool, similar to Unix' finger, that looks up people and resources via WebFinger (RFC 7033). Works with Mastodon and everything else in the Fediverse.

$ webfinger [e-mail]

The resource can be given as user@host, @user@host, acct:user@host or any URL.

Options

Option	Description
--json, -j	Print the raw JRD document instead of the formatted view
--insecure, -i	Fall back to plain HTTP if HTTPS fails
--no-profile	Skip fetching the h-card from the profile page

Install

Via Composer:

$ composer global require pfefferle/webfinger-cli

Or download webfinger.phar from the latest release, make it executable and put it on your PATH.

Requires PHP 8.2 or newer with the curl extension.

Development

$ composer install
$ composer test

Building the phar

The phar is built with Box. Install it with brew install box or phive install humbug/box, then run

$ composer install --no-dev
$ composer build

which writes build/webfinger.phar. Pushing a tag builds the phar on GitHub Actions and attaches it to the release automatically.