How alb4k/iplist works
IPList builds IPv4/CIDR route lists for AmneziaVPN split tunneling. The main workflow refreshes service metadata and address sources, enriches services with DNS/ASN evidence, partitions routes, applies user selections, and produces validated exports or AmneziaWG configurations. The README documents the transaction and safety guarantees; sampled code confirms the refresh coordinator, catalog loader, enrichment, and export logic. App.swift is large and only partially excerpted, so UI-to-state details beyond visible calls are not expanded.
Main entry points: App.swift App interface · Core.swift Refresh coordinator · ServiceCatalogLoader.swift Catalog loader · EnrichmentLoader.swift DNS and ASN enrichment
Components 17
App and state
- App interface
Sources/IPList/App.swift - Saved state
Sources/IPList/App.swift - Update checker
Sources/IPList/AppUpdateChecker.swift
Catalog and routes
- Catalog models
Sources/IPList/CatalogModels.swift - Catalog loader
Sources/IPList/ServiceCatalogLoader.swift - IPv4 matcher
Sources/IPList/AddressMatcher.swift - Route selection
Sources/IPList/Core.swift
Refresh and enrichment
- Refresh coordinator
Sources/IPList/Core.swift - DNS and ASN enrichment
Sources/IPList/EnrichmentLoader.swift
Export and configuration
- Export formats
Sources/IPList/ExportFormats.swift - AmneziaWG config
Sources/IPList/AmneziaWGConfig.swift
Other components
- User
- Catalog metadata
- Address sources
- System DNS
- RIPEstat
- Export files
Connections 18
- User → App interface: uses
README.md - App interface → Saved state: persists
README.md - App interface → Refresh coordinator: refreshes
README.md - App interface → Update checker: checks updates
Sources/IPList/App.swift - Refresh coordinator → Catalog loader: loads catalog
Sources/IPList/Core.swift - Catalog loader → Catalog metadata: fetches metadata
README.md - Refresh coordinator → Address sources: loads sources
Sources/IPList/Core.swift - Refresh coordinator → DNS and ASN enrichment: enriches services
- DNS and ASN enrichment → System DNS: resolves domains
README.md - DNS and ASN enrichment → RIPEstat: queries prefixes
README.md - Catalog loader → Catalog models: parses into
Sources/IPList/ServiceCatalogLoader.swift - Refresh coordinator → Route selection: validates refresh
Sources/IPList/Core.swift - User → Route selection: chooses routes
README.md - Route selection → IPv4 matcher: normalizes routes
README.md - App interface → Export formats: exports routes
README.md - Export formats → Export files: writes JSON
README.md - App interface → AmneziaWG config: creates config
README.md - AmneziaWG config → Export files: writes config
README.md