PeerYgg

English · Русский

The utility for search nearest peers in Yggdrasil

PeerYgg is a tool for discovering and analyzing Yggdrasil network peers with minimal latency.

The program automatically detects available peers and calculates the routing hops to each node, helping you select the most efficient connections.

Key Features

• Latency measurement — identify minimal latency to each peer
• Routing analysis — calculate hop count (traceroute) to target nodes
• Flexible output formats — export results as table, configuration file, or JSON for easy integration and analysis
• Group results — group peers by IP address for better organization and analysis
• Compatibility – Good compatibility with various types of architectures (x64, ARM, ARMv5-7, MIPS(LE))

---

Install

Windows

Download binary file and run in shell

macOS

Quick Run (Intel)

curl -LO https://github.com/GenkaOk/PeerYgg/releases/latest/download/peerygg-darwin-amd64.tar.gz
tar -xvf peerygg-darwin-amd64.tar.gz 
cd peerygg-darwin-amd64

./peerygg

Quick Run (Apple Silicon)

curl -LO https://github.com/GenkaOk/PeerYgg/releases/latest/download/peerygg-darwin-arm64.tar.gz
tar -xvf peerygg-darwin-arm64.tar.gz 
cd peerygg-darwin-arm64

./peerygg

Linux

Quick Run (Linux AMD64)

curl -LO https://github.com/GenkaOk/PeerYgg/releases/latest/download/peerygg-linux-amd64.tar.gz
tar -xvf peerygg-linux-amd64.tar.gz
cd peerygg-linux-amd64

./peerygg

From source

git clone https://github.com/GenkaOk/PeerYgg
cd PeerYgg
go build -o peerygg ./cmd/peerygg/main.go
# binary is at ./peerygg

---

Usage

Supported OS

Utility supported next OS:

System	File	Tested
Windows	peerygg-windows-amd64.zip	Yes
Windows x86	peerygg-windows-i686.zip	Yes
Linux x64	peerygg-linux-amd64.tar.gz	Yes
Linux ARM	peerygg-linux-arm64.tar.gz	No
Linux MIPS	peerygg-linux-mips.tar.gz	No
Linux MIPSLE	peerygg-linux-mipsle.tar.gz	Yes
Linux ARMv5	peerygg-linux-armv5.tar.gz	No
Linux ARMv6	peerygg-linux-armv6.tar.gz	No
Linux ARMv7	peerygg-linux-armv7.tar.gz	Yes
MacOS (Intel)	peerygg-darwin-amd64.tar.gz	Yes
MacOs (Apple Silicon)	peerygg-darwin-arm64.tar.gz	Yes

CLI mode

Usage of PeerYgg:
  -c int
    	concurrency for pings (default 30)
  -group
    	group peers by host and select best connection per server
  -insecure
    	allow skip SSL verification
  -n int
    	number of fastest peers/servers to output (default 5)
  -output string
    	output format: current|json|table|config (default "current")
  -progress string
    	progress mode: [n]one|[s]imple|[f]ull (default "full")
  -t int
    	timeout per ping in seconds (default 1)
  -trace-count int
    	tracing count peers to calculate hops, 0 for disable trace calculate (default 5)
  -trace-max-hops int
    	max hops count for calculate (default 20)
  -trace-timeout int
    	timeout in seconds for tracing all peers (default 30)

Output Formats

Format	Use Case	Command	Screenshot
Default	Default output	peerygg
Table	Quick visual inspection of peer data in terminal	peerygg -output table
Config	Output as Yggdrasil configuration files for integration with another CLI tools	peerygg -output config
JSON	Programmatic access and integration with other tools	peerygg -output json > out.json

---

License

MIT