{"id":27949104,"url":"https://github.com/samtherapy/awl","last_synced_at":"2025-05-07T15:19:56.530Z","repository":{"id":44334783,"uuid":"509855743","full_name":"SamTherapy/awl","owner":"SamTherapy","description":"A command-line DNS lookup tool that supports DNS queries over UDP, TCP, TLS, HTTPS, DNSCrypt, and QUIC. [Mirror]","archived":false,"fork":false,"pushed_at":"2025-05-06T18:01:39.000Z","size":927,"stargazers_count":12,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-05-07T15:19:47.317Z","etag":null,"topics":["bind9","dig","dns","dns-client","dns-over-https","dns-over-quic","dns-over-tls","drill","freebsd","go","golang","linux","macos","openbsd","plan9","windows"],"latest_commit_sha":null,"homepage":"https://git.froth.zone/sam/awl","language":"Go","has_issues":false,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-3-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/SamTherapy.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"docs/CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null},"funding":{"custom":"https://donate.hsi.org/page/119584/donate/","liberapay":"samme"}},"created_at":"2022-07-02T20:30:48.000Z","updated_at":"2025-04-01T15:58:18.000Z","dependencies_parsed_at":"2024-05-03T16:06:46.123Z","dependency_job_id":"b2b7dd09-9791-4d14-a6c0-65a705d48dcb","html_url":"https://github.com/SamTherapy/awl","commit_stats":{"total_commits":341,"total_committers":4,"mean_commits":85.25,"dds":0.501466275659824,"last_synced_commit":"c0b10176dba28982fb74df681037f45de498b72e"},"previous_names":[],"tags_count":29,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SamTherapy%2Fawl","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SamTherapy%2Fawl/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SamTherapy%2Fawl/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SamTherapy%2Fawl/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/SamTherapy","download_url":"https://codeload.github.com/SamTherapy/awl/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252902620,"owners_count":21822263,"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":["bind9","dig","dns","dns-client","dns-over-https","dns-over-quic","dns-over-tls","drill","freebsd","go","golang","linux","macos","openbsd","plan9","windows"],"created_at":"2025-05-07T15:19:55.677Z","updated_at":"2025-05-07T15:19:56.524Z","avatar_url":"https://github.com/SamTherapy.png","language":"Go","readme":"\u003c!-- markdownlint-disable MD033 --\u003e\n# \u003cimg src=\"./docs/img/awl-text.png\" width=\"50%\" title=\"awl logo\" alt=\"awl\"\u003e\n\n\u003e awl *(noun)*: A pointed tool for making small holes in wood or leather\n\nA command-line DNS lookup tool that supports DNS queries over UDP, TCP, TLS, HTTPS, DNSCrypt, and QUIC.\n\n[![Gitea Release](https://img.shields.io/gitea/v/release/sam/awl?gitea_url=https%3A%2F%2Fgit.froth.zone\u0026display_name=release\u0026style=for-the-badge)](https://git.froth.zone/sam/awl)\n[![Last Commit](https://img.shields.io/gitea/last-commit/sam/awl?gitea_url=https%3A%2F%2Fgit.froth.zone\u0026style=for-the-badge)](https://git.froth.zone/sam/awl/commits/branch/master)\n[![License](https://img.shields.io/github/license/samtherapy/awl?style=for-the-badge)](https://spdx.org/licenses/BSD-3-Clause.html)\n[![Go Report](https://goreportcard.com/badge/dns.froth.zone/awl?style=for-the-badge)](https://goreportcard.com/report/dns.froth.zone/awl)\n\nAwl is designed to be a drop-in replacement for [dig](https://bind9.readthedocs.io/en/v9_18_3/manpages.html#dig-dns-lookup-utility).\n\n## Examples\n\n```shell\n# Query a domain over UDP\nawl example.com\n\n# Query a domain over HTTPS, print only the results\nawl example.com +https --short\n\n# Query a domain over TLS, print as JSON\nawl example.com +tls +json\n```\n\nFor more and the usage, see the [manpage](https://git.froth.zone/sam/awl/wiki/awl.1).\n\n## Installing\n\nOn any platform, with [Go](https://go.dev) installed, run the following command to install:\n\n```shell\ngo install dns.froth.zone/awl@latest\n```\n\n### Packaging\n\nAlternatively, many package managers are supported:\n\n\u003cdetails\u003e\n\u003csummary\u003eLinux\u003c/summary\u003e\n\n#### Distro-specific\n\n\u003cdetails\u003e\n\u003csummary\u003eAlpine Linux\u003c/summary\u003e\n\nProvided by [Gitea packages](https://git.froth.zone/sam/-/packages/alpine/awl-dns) \\\n***Any distro that uses apk should also work***\n\n```shell\n# Add the repository\necho \"https://git.froth.zone/api/packages/sam/alpine/edge/main\" | tee -a /etc/apk/repositories\n# Get the signing key\ncurl -JO https://git.froth.zone/api/packages/sam/alpine/key --output-dir /etc/apk/keys\n# Install\napk add awl-dns\n```\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003eArch\u003c/summary\u003e\n\nAUR package available as [awl-dns-git](https://aur.archlinux.org/packages/awl-dns-git/)\n\n```shell\nyay -S awl-dns-git ||\nparu -S awl-dns-git\n```\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003eDebian / Ubuntu\u003c/summary\u003e\n\nProvided by [Gitea packages](https://git.froth.zone/sam/-/packages/debian/awl-dns/) \\\n***Any distro that uses deb/dpkg should also work***\n\n```shell\n# Install the repository and GPG keys\ncurl -JO https://git.froth.zone/packaging/-/packages/debian/git-froth-zone-debian/1-0/files/5937\nsudo dpkg -i git-froth-zone-debian_1-0_all.deb\nrm git-froth-zone-debian_1-0_all.deb\n# Update and install\nsudo apt update\nsudo apt install awl-dns\n```\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003eFedora / RHEL / SUSE\u003c/summary\u003e\n\nProvided by [Gitea packages](https://git.froth.zone/sam/-/packages/rpm/awl-dns/) \\\n***Any distro that uses rpm/dnf might also work, I've never tried it***\n\n```shell\n# Add the repository\ndnf config-manager --add-repo https://git.froth.zone/api/packages/sam/rpm.repo ||\nzypper addrepo https://git.froth.zone/api/packages/sam/rpm.repo\n# Install\ndnf install awl-dns ||\nzypper install awl-dns\n```\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003eGentoo\u003c/summary\u003e\n\n```shell\n# Add the ebuild repository\neselect repository add froth-zone git https://git.froth.zone/packaging/portage.git\nemaint sync -r froth-zone\n# Install\nemerge -av net-dns/awl\n```\n\n\u003c/details\u003e\n\n#### Distro-agnostic\n\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003ca href=\"https://brew.sh\" nofollow\u003eHomebrew\u003c/a\u003e\u003c/summary\u003e\n\n```shell\nbrew install SamTherapy/tap/awl\n```\n\n\u003c/details\u003e\n\u003cdetails\u003e\n\u003csummary\u003eSnap\u003c/summary\u003e\n\nSnap package available as [awl-dns](https://snapcraft.io/awl-dns)\n\n```shell\nsnap install awl-dns ||\nsudo snap install awl-dns\n```\n\n\u003c/details\u003e\n\u003c/details\u003e\n\u003chr /\u003e\n\u003cdetails\u003e\n\u003csummary\u003emacOS\u003c/summary\u003e\n\n\u003cdetails open\u003e\n\u003csummary\u003e\u003ca href=\"https://brew.sh\" nofollow\u003eHomebrew\u003c/a\u003e\u003c/summary\u003e\n\n```shell\nbrew install SamTherapy/tap/awl\n```\n\n\u003c/details\u003e\n\u003c/details\u003e\n\u003chr /\u003e\n\u003cdetails\u003e\n\u003csummary\u003eWindows\u003c/summary\u003e\n\n\u003cdetails open\u003e\n\u003csummary\u003e\u003ca href=\"https://scoop.sh\" nofollow\u003eScoop\u003c/a\u003e\u003c/summary\u003e\n\n```pwsh\nscoop bucket add froth https://git.froth.zone/packages/scoop.git\nscoop install awl\n```\n\n\u003c/details\u003e\n\u003c/details\u003e\n\n## Contributing\n\nPlease see the [CONTRIBUTING.md](./docs/CONTRIBUTING.md) file for more information.\n\nTL;DR: If you like the project, spread the word! If you want to contribute, [use the issue tracker](https://git.froth.zone/sam/awl/issues) or [open a pull request](https://git.froth.zone/sam/awl/pulls).\nWant to use email instead? Use our [mailing list](https://lists.sr.ht/~sammefishe/awl-devel)!\n\n### Mirrors\n\nThe canonical repository is located on [my personal Forgejo instance](https://git.froth.zone/sam/awl). \\\nOfficial mirrors are located on [GitHub](https://github.com/SamTherapy/awl), [GitLab](https://gitlab.com/SamTherapy/awl) and [SourceHut](https://git.sr.ht/~sammefishe/awl).\nContributions are accepted on all mirrors, but the Forgejo instance is preferred.\n\n## License\n\n[BSD-3-Clause](https://spdx.org/licenses/BSD-3-Clause.html)\n\n### Credits\n\n- Awl image taken from [Wikimedia Commons](https://commons.wikimedia.org/wiki/File:Awl.tif), imaged is licensed CC0.\n","funding_links":["https://donate.hsi.org/page/119584/donate/","https://liberapay.com/samme"],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsamtherapy%2Fawl","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsamtherapy%2Fawl","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsamtherapy%2Fawl/lists"}