MCPcopy Index your code
hub / github.com/DanielLavrushin/GeodatExplorer

github.com/DanielLavrushin/GeodatExplorer @v1.1.1

Chat with this repo
repository ↗ · DeepWiki ↗ · release v1.1.1 ↗ · + Follow
51 symbols 101 edges 17 files 6 documented · 12%
What it actually does AI analysis from the code graph — generated when you open this
loading…
README

GeodatExplorer

GitHub Release GitHub Downloads

A cross-platform GUI application for browsing and exploring v2ray geosite and geoip DAT files.

image

Overview

GeodatExplorer provides a user-friendly interface to inspect the contents of v2ray/xray geodata files (geosite.dat and geoip.dat). These files contain domain and IP routing rules used by proxy tools like v2ray, xray, sing-box, and others.

Instead of manually parsing binary protobuf files or relying on command-line tools, GeodatExplorer lets you:

  • Browse all categories in a DAT file
  • View entries with type indicators (domain, full, keyword, regexp, CIDR, include)
  • Search globally across all categories to find which rules contain a specific domain or IP
  • Filter categories and entries in real-time

Features

  • Category browser — Lists all categories with filtering
  • Entry viewer — Shows entries with color-coded types
  • Reverse search — Find which categories contain a specific domain/IP pattern
  • Cross-platform — Runs on Linux, Windows, and macOS

Supported Platforms

Platform Architecture
Linux amd64, arm64
Windows amd64
macOS amd64, arm64

Installation

Download the latest release for your platform from the Releases page.

Linux

tar -xzf gde-linux-amd64.tar.gz
./gde-linux-amd64/gde

Windows

Extract gde-windows-amd64.zip and run gde.exe.

macOS

Extract gde-darwin-*.tar.gz and open gde.app.

Building from Source

Prerequisites

  • Go 1.23+
  • Node.js 22+
  • pnpm
  • Wails CLI v2

Build

# Install Wails CLI
go install github.com/wailsapp/wails/v2/cmd/wails@latest

# Clone and build
git clone https://github.com/DanielLavrushin/GeodatExplorer.git
cd GeodatExplorer/src
wails build

Development

cd src
wails dev -tags webkit2_41  # Linux requires webkit2_41 tag

License

MIT

Extension points exported contracts — how you extend this code

FileState (Interface)
(no doc)
src/ui/src/types/index.ts
Props (Interface)
(no doc)
src/ui/src/components/FileBrowser.tsx
Props (Interface)
(no doc)
src/ui/src/components/CategoryList.tsx
Props (Interface)
(no doc)
src/ui/src/components/EntryList.tsx
Props (Interface)
(no doc)
src/ui/src/components/GlobalSearch.tsx

Core symbols most depended-on inside this repo

readCountryCode
called by 2
src/geodat/geosite.go
streamGeoSite
called by 2
src/geodat/geosite.go
streamGeoIP
called by 2
src/geodat/geoip.go
prefixContains
called by 2
src/geodat/search.go
NewApp
called by 1
src/app.go
convertV2DomainToText
called by 1
src/geodat/geosite.go
DetectFileType
called by 1
src/geodat/geosite.go
isPrintableASCII
called by 1
src/geodat/geosite.go

Shape

Function 32
Method 9
Interface 6
Struct 4

Languages

Go63%
TypeScript37%

Modules by API surface

src/app.go11 symbols
src/geodat/geosite.go8 symbols
src/ui/src/components/GlobalSearch.tsx6 symbols
src/ui/src/components/FileBrowser.tsx3 symbols
src/ui/src/App.tsx3 symbols
src/geodat/types.go3 symbols
src/geodat/search.go3 symbols
src/geodat/geoip.go3 symbols
src/ui/src/components/WelcomeScreen.tsx2 symbols
src/ui/src/components/EntryList.tsx2 symbols
src/ui/src/components/CategoryList.tsx2 symbols
src/geodat/helpers.go2 symbols

For agents

$ claude mcp add GeodatExplorer \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact