#web-finger #client #library #protocols #client-library

app webfinger-cli

A WebFinger client and library written in Rust

19 releases

Uses new Rust 2024

new 0.0.19 Jul 8, 2025
0.0.18 Jul 6, 2025
0.0.17 Jun 20, 2025
0.0.14 May 1, 2025
0.0.10 Sep 30, 2024

#857 in Network programming

Download history 245/week @ 2025-04-29 40/week @ 2025-05-06 30/week @ 2025-05-13 2/week @ 2025-05-20 99/week @ 2025-06-03 126/week @ 2025-06-10 134/week @ 2025-06-17 11/week @ 2025-06-24 65/week @ 2025-07-01

435 downloads per month

MIT/Apache

74KB
718 lines

Webfinger-cli

Crates.io badge License badge Deps.rs badge

webfinger-cli is a command line tool for querying WebFinger servers. It is built on top of the webfinger-rs library, which provides a transport-agnostic implementation of the WebFinger protocol defined by RFC 7033.

Installation

To install webfinger-cli from source, you can use the following command:

cargo install webfinger-cli --locked

Or use cargo-binstall to install a precompiled binary:

cargo binstall webfinger-cli

Usage

Usage: webfinger [OPTIONS] <RESOURCE> [HOST]

Arguments:
  <RESOURCE>  The resource to fetch
  [HOST]      The host to fetch the webfinger resource from

Options:
  -r, --rel <REL>   The link relation types to fetch
      --insecure    Ignore TLS certificate verification errors
  -v, --verbose...  Increase logging verbosity
  -q, --quiet...    Decrease logging verbosity
  -h, --help        Print help (see more with '--help')

E.g. to get the avatar for a user with the account carol@example.com, you can run:

webfinger acct:carol@example.com --rel http://webfinger.net/rel/avatar

Made with VHS

License

Copyright (c) Josh McKinney

This project is licensed under either of:

Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.

See CONTRIBUTING.md.

Dependencies

~18–34MB
~517K SLoC