{"id":19322709,"url":"https://github.com/picatz/iface","last_synced_at":"2025-06-20T16:10:28.736Z","repository":{"id":28015204,"uuid":"115658992","full_name":"picatz/iface","owner":"picatz","description":"🕶  Cross-platform network interface command-line utility.","archived":false,"fork":false,"pushed_at":"2023-01-23T10:15:11.000Z","size":20,"stargazers_count":17,"open_issues_count":1,"forks_count":4,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-02T03:08:25.832Z","etag":null,"topics":["command-line","cross-platform","linux","macos","network","windows"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/picatz.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2017-12-28T20:57:39.000Z","updated_at":"2024-10-03T03:44:51.000Z","dependencies_parsed_at":"2023-02-12T22:16:42.167Z","dependency_job_id":null,"html_url":"https://github.com/picatz/iface","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/picatz%2Fiface","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/picatz%2Fiface/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/picatz%2Fiface/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/picatz%2Fiface/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/picatz","download_url":"https://codeload.github.com/picatz/iface/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":250308445,"owners_count":21409272,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["command-line","cross-platform","linux","macos","network","windows"],"created_at":"2024-11-10T01:42:14.441Z","updated_at":"2025-04-22T19:31:49.060Z","avatar_url":"https://github.com/picatz.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# iface\n\u003e Network interface command-line utility.\n\nTools like `ifconfig`, `ip` and `ipconfig` are awesome! But, sometimes they're just a little too much to parse -- or you just don't want to fuss with all of that. With `iface`, you get a clean, scriptable command-line utility that's lightweight, cross-platform, and easy to learn. Learn once, use everywhere!\n\n## Supported Platforms\n\n\u003e Thanks to [`VBaczynski`](https://github.com/VBaczynski) for helping test FreeBSD!\n\n* macOS\n* Linux\n* Windows\n* FreeBSD\n\n## Install\n\n```\n$ go get github.com/picatz/iface\n```\n\n## Build from Source\n\nUntil I've figured out a better solution:\n\n```\n$ go get github.com/urfave/cli\n$ git clone https://github.com/picatz/iface.git\n$ cd iface\n$ go build iface.go\n```\n\nBuild `iface.exe` on macOS or Linux to run on a Windows box:\n\n```\n$ GOOS=windows GOARCH=386 go build iface.go\n```\n\n## Example Usage\n\nGet the first `default` ( non-[loopback](https://en.wikipedia.org/wiki/Loopback#Virtual_network_interface) ) network [interface](https://en.wikipedia.org/wiki/Network_interface):\n\u003e This sort of simulates the LibPcap [`lookupdev`](https://linux.die.net/man/3/pcap_lookupdev) function to get the default interface to capture packets on.\n\n```\n$ iface default\n```\n\nGet all of the network interface names available on the system:\n\n```\n$ iface names\n```\n\nGet network interface names with thier [mac addresses](https://en.wikipedia.org/wiki/MAC_address):\n\n```\n$ iface macs\n```\n\nGet network interface names with their [IP addresses](https://en.wikipedia.org/wiki/IP_address):\n\n```\n$ iface ips\n```\n\n## Command-line Interface\n\n```\nNAME:\n   iface - network interface command-line utility\n\nUSAGE:\n   iface [global options] command [command options] [arguments...]\n\nVERSION:\n   1.0.1\n\nCOMMANDS:\n     names    all network interface names\n     macs     network interfaces with their mac addresses\n     mtus     network interfaces with their maximum transmission unit (mtu)s\n     ips      network interfaces with their (local) ip addresses\n     default  the first non-loopback network interface\n     help, h  Shows a list of commands or help for one command\n\nGLOBAL OPTIONS:\n   --help, -h     show help\n   --version, -v  print the version\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpicatz%2Fiface","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpicatz%2Fiface","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpicatz%2Fiface/lists"}