Skip to content

tobagin/digger

BranchesTags

Repository files navigation

Digger - Advanced DNS Lookup Tool

A powerful and modern DNS lookup tool built with Vala, GTK4, and libadwaita. Digger provides an intuitive interface for performing DNS queries with advanced features including batch lookups, server comparison, DNSSEC validation, and DNS-over-HTTPS support.

Digger Application

🎉 Version 2.6.0 - DNSBL & Performance Monitoring

Digger 2.6.0 brings powerful network analysis tools: DNS Blacklist checking and real-time performance monitoring.

✨ Key Features

  • 🔍 Advanced DNS Queries: Support for all major DNS record types with DNSSEC validation
  • 🛡️ DNS Blacklist Checking: Multi-provider RBL compliance tool with parallel query execution
  • 📊 Performance Monitor: Real-time DNS latency visualization for Google, Cloudflare, and Quad9
  • 🌐 WHOIS Integration: Domain registration lookup with intelligent caching
  • 💻 Command Export: Generate dig and curl commands from your GUI state
  • 📱 Responsive Design: Full adaptive layout for desktop, tablet, and mobile

🆕 What's New in 2.6.0

  • ✨ New Icons: Fresh new application icons (Thanks to @oiimrosabel).
  • 🛡️ DNS Blacklist Checking: Check IPs against Spamhaus, SpamCop, Barracuda, and more.
  • 📊 Performance Monitor: Real-time graphs and health statistics for DNS servers.
  • ⌨️ Keyboard Shortcuts: Quick access via Ctrl+Shift+B (DNSBL) and Ctrl+Shift+P (Monitor).

✨ Features

Core DNS Features

  • 🔍 Comprehensive DNS Queries: Support for all major DNS record types (A, AAAA, CNAME, MX, NS, PTR, TXT, SOA, SRV, DNSKEY, DS, RRSIG, ANY)
  • ⚙️ Advanced Query Options: Reverse DNS lookup, trace queries, custom DNS servers, and short output format
  • 🔒 DNS-over-HTTPS (DoH): Secure DNS queries with support for Cloudflare, Google, Quad9, and custom endpoints
  • 🛡️ DNSSEC Validation: Verify DNSSEC chain of trust with DNSKEY, DS, and RRSIG record validation
  • 🔄 Server Comparison: Compare DNS responses across multiple servers with automatic discrepancy detection
  • 📋 WHOIS Integration: Automatic domain registration information lookup with caching and comprehensive details

Productivity Features

  • ⭐ Favorites System: Star and save frequently queried domains with their record types
  • 📦 Batch Lookup: Import and query multiple domains from CSV/TXT files with progress tracking
  • 📤 Export Manager: Export query results to JSON, CSV, plain text, or DNS zone file formats
  • 📝 Enhanced Query History: Persistent history with advanced search, filtering, and management
  • 🔄 Smart Autocomplete: Intelligent domain suggestions with usage tracking and quick selection

User Experience

  • 📋 Clipboard Integration: One-click copying of DNS record values and raw dig output
  • ⌨️ Keyboard Shortcuts: Comprehensive keyboard shortcuts for efficient navigation
  • 🎨 Modern Interface: Clean, adaptive UI built with libadwaita 1.6+ and blueprint templates
  • 📱 Responsive Design: Fully adaptive layout supporting desktop (>1024px), tablet (768-1024px), and mobile (<768px) form factors
  • 🌐 Network Diagnostics: Detailed error handling with NXDOMAIN, SERVFAIL, and timeout detection
  • ⚙️ Comprehensive Preferences: Multi-page preferences with DNS defaults, DoH configuration, and DNSSEC settings
  • 🚀 Native Performance: Vala implementation for optimal speed and resource usage

Installation

Flatpak (Recommended)

Get it on Flathub

From Source

# Install dependencies
flatpak remote-add --if-not-exists flathub https://flathub.org/repo/flathub.flatpakrepo

# Build and install
./scripts/build.sh --dev

Usage

Basic DNS Lookup

  1. Enter a domain name (e.g., example.com)
  2. Select the DNS record type
  3. Click "Look up DNS records" or press Enter
  4. Click the star icon to add to favorites

Batch Lookup

  1. Click the menu button → "Batch Lookup" (or press Ctrl+B)
  2. Import domains from CSV/TXT file or enter manually
  3. Select record type and DNS server
  4. Choose parallel or sequential execution
  5. Monitor progress and export results

Server Comparison

  1. Click the menu button → "Tools" → "Compare DNS Servers" (or press Ctrl+M)
  2. Enter domain and select record type on the Setup page
  3. Choose DNS servers to compare (Google, Cloudflare, Quad9, OpenDNS, System)
  4. Click "Compare DNS Servers" to begin comparison
  5. View response times, statistics, and detect discrepancies on the Results page
  6. Export comparison results to JSON, CSV, or TXT format

DNS-over-HTTPS (DoH)

  1. Open Preferences → Advanced
  2. Enable "DNS-over-HTTPS"
  3. Select provider (Cloudflare, Google, Quad9) or enter custom endpoint
  4. All queries will now use encrypted DNS

DNSSEC Validation

  1. Open Preferences → Advanced
  2. Enable "DNSSEC Validation"
  3. Optionally enable "Show DNSSEC Details"
  4. Query results will show DNSSEC validation status

Export Results

  1. Perform a DNS query
  2. Click "Export" button in results view
  3. Choose format (JSON, CSV, Plain Text, DNS Zone File)
  4. Select save location

Advanced Options

Expand the "Advanced Options" section to access:

  • Reverse DNS Lookup: Check for IP address reverse resolution
  • Trace Query Path: See the full resolution path from root servers
  • Short Output: Get minimal, essential output only
  • Custom DNS Server: Specify a custom DNS server (e.g., 8.8.8.8)

Keyboard Shortcuts

  • Ctrl+L: Focus the domain entry field
  • Ctrl+R: Repeat the last query
  • Ctrl+B: Open batch lookup dialog
  • Ctrl+M: Open server comparison dialog
  • Ctrl+,: Open preferences
  • Ctrl+?: Show keyboard shortcuts
  • F1: Show about dialog
  • Escape: Clear results
  • Enter: Submit query

Architecture

Digger follows a clean, modular architecture with organized source code:

Digger/
├── src/
│   ├── Main.vala                           # Application entry point
│   ├── Application.vala                    # Main application class
│   ├── Config.vala.in                      # Configuration template
│   ├── dialogs/                            # Dialog windows
│   │   ├── Window.vala                     # Main window
│   │   ├── AboutDialog.vala                # About dialog with release notes
│   │   ├── PreferencesDialog.vala          # Multi-page preferences
│   │   ├── ShortcutsDialog.vala            # Keyboard shortcuts
│   │   ├── BatchLookupDialog.vala          # Batch DNS lookup
│   │   └── ComparisonDialog.vala           # Server comparison
│   ├── models/                             # Data models
│   │   └── DnsRecord.vala                  # DNS record data structures
│   ├── services/                           # Business logic services
│   │   ├── DnsQuery.vala                   # DNS query execution
│   │   ├── QueryHistory.vala               # History management
│   │   ├── SecureDns.vala                  # DNS-over-HTTPS implementation
│   │   └── DnssecValidator.vala            # DNSSEC validation logic
│   ├── managers/                           # Feature managers
│   │   ├── ExportManager.vala              # Export to various formats
│   │   ├── FavoritesManager.vala           # Favorites persistence
│   │   ├── BatchLookupManager.vala         # Batch operation orchestration
│   │   └── ComparisonManager.vala          # Multi-server comparison
│   ├── widgets/                            # UI components
│   │   ├── EnhancedQueryForm.vala          # Modern query input
│   │   ├── EnhancedResultView.vala         # Results display with export
│   │   ├── QueryResultView.vala            # Legacy results view
│   │   ├── AdvancedOptions.vala            # Advanced options panel
│   │   ├── AutocompleteDropdown.vala       # Smart autocomplete widget
│   │   └── EnhancedHistorySearch.vala      # Advanced history search
│   └── utils/                              # Utility classes
│       ├── ThemeManager.vala               # Theme management
│       ├── DnsPresets.vala                 # DNS server presets
│       └── DomainSuggestions.vala          # Autocomplete engine
├── data/
│   ├── ui/                                 # Blueprint UI templates
│   │   ├── window.blp                      # Main window UI
│   │   ├── dialogs/                        # Dialog UI files
│   │   │   ├── preferences-dialog.blp
│   │   │   ├── shortcuts-dialog.blp
│   │   │   ├── batch-lookup-dialog.blp
│   │   │   └── comparison-dialog.blp
│   │   └── widgets/                        # Widget UI files
│   │       ├── enhanced-query-form.blp
│   │       ├── enhanced-result-view.blp
│   │       ├── advanced-options.blp
│   │       ├── autocomplete-dropdown.blp
│   │       ├── enhanced-history-search.blp
│   │       └── history-popover.blp
│   ├── io.github.tobagin.digger.gschema.xml      # GSettings schemas
│   ├── io.github.tobagin.digger.metainfo.xml.in  # AppStream metadata
│   ├── io.github.tobagin.digger.desktop.in       # Desktop entry
│   ├── icons/                              # Application icons (SVG scalable)
│   │   └── hicolor/scalable/apps/
│   │       ├── io.github.tobagin.digger.svg                        # Main app icon
│   │       ├── io.github.tobagin.digger-history-symbolic.svg
│   │       ├── io.github.tobagin.digger-copy-symbolic.svg
│   │       ├── io.github.tobagin.digger-error-symbolic.svg
│   │       ├── io.github.tobagin.digger-success-symbolic.svg
│   │       ├── io.github.tobagin.digger-fastest-server-symbolic.svg
│   │       ├── io.github.tobagin.digger-slowest-server-symbolic.svg
│   │       ├── io.github.tobagin.digger-average-query-time-symbolic.svg
│   │       └── io.github.tobagin.digger-query-time-symbolic.svg
│   ├── screenshots/                        # Application screenshots
│   └── presets/                            # DNS server presets
├── packaging/                              # Flatpak manifests
│   ├── io.github.tobagin.digger.yml        # Production manifest
│   └── io.github.tobagin.digger.Devel.yml  # Development manifest
├── scripts/                                # Build and utility scripts
│   └── build.sh                            # Unified build script
└── po/                                     # Translations

DNS Integration

Digger uses the embedded dig command (BIND 9.16.48) for DNS resolution, providing:

  • Enhanced Error Handling: Proper parsing of NXDOMAIN, SERVFAIL, REFUSED, and other DNS status codes
  • Comprehensive Record Support: All standard DNS record types with proper parsing
  • Advanced Query Options: Tracing, custom servers, reverse lookups, and short output
  • DNSSEC Support: Full DNSSEC validation with DNSKEY, DS, and RRSIG records
  • DoH Integration: DNS-over-HTTPS using libsoup-3.0 with RFC 1035 wire format
  • Detailed Diagnostics: Query timing, server information, and comprehensive status reporting
  • Self-Contained: Embedded dig command in Flatpak builds eliminates external dependencies

Contributing

Contributions are welcome! Please feel free to submit issues and pull requests.

Development Setup

  1. Fork the repository
  2. Create a feature branch
  3. Make your changes following the coding guidelines
  4. Test thoroughly with various DNS queries
  5. Submit a pull request

Coding Guidelines

  • Follow PascalCase naming for Vala files (e.g., DnsQuery.vala)
  • Organize code into appropriate folders (dialogs, models, services, managers, widgets, utils)
  • Add appropriate error handling with null checks
  • Use Blueprint for UI definitions
  • Include descriptive commit messages
  • Test changes with various DNS record types and scenarios

Project Structure

  • Place dialogs in src/dialogs/
  • Place data models in src/models/
  • Place business logic in src/services/
  • Place feature managers in src/managers/
  • Place UI components in src/widgets/
  • Place utility classes in src/utils/
  • Place Blueprint UI files in data/ui/dialogs/ or data/ui/widgets/

License

This project is licensed under the GNU General Public License v3.0 - see the LICENSE file for details.

Acknowledgments

  • Built with Vala and GTK4
  • UI components from libadwaita 1.8
  • DNS resolution powered by BIND dig
  • Inspired by the classic dig command-line tool
  • Thanks to the GNOME and GTK communities for excellent documentation

Screenshots

Main Window Query Results Query History
Main Window Query Results History
Autocomplete Preferences About Dialog
Autocomplete Preferences About

Made with ❤️ using Vala, GTK4, and libadwaita

About

A simple, clean DNS lookup utility.

Resources

Readme

License

GPL-3.0 license

Contributing

Contributing
Activity

Stars

11 stars

Watchers

0 watching

Forks

3 forks
Report repository

Releases

26 tags

Sponsor this project

  •  
Learn more about GitHub Sponsors

Packages

No packages published

Contributors 5

Languages