kismet_to_kml 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 3f540fcf28b8a98c43eff929f14c25ada6130e9c5c42158df3bb9b47aa0449f6
+  data.tar.gz: ea132196932b1ffc258cd0380e7bcfd6b1f1c8b48a2ff2d50709c8f443951294
+SHA512:
+  metadata.gz: 863e413e9ecf79bad149b50f871caa1acf52d2bd4de270f2328402d807a88daa113e41b6c21a487e280bc9582d9e6325cad805f865ef2f49309c8f7f5efc06eb
+  data.tar.gz: aa64e94b477f0c51a27c457e8b76370324e6a395b04b305cf26a6b206bc0bed91d93083b7cdf5a18767f2f6d71b5d626b2ff8ec28edcce0e0bd63d4c89b857c6

data/bin/kismet_to_kml

@@ -0,0 +1,34 @@
+#!/usr/bin/env ruby
+
+require "optparse"
+
+require 'kismet_to_kml'
+
+
+prog = File.basename(__FILE__)
+
+options = {}
+option_parser = OptionParser.new do |opts|
+  opts.banner = "Usage: #{prog} [options]"
+
+  opts.on("-n", "--netxml NETXML", "Netxml file (required)") do |v|
+    options[:netxml] = v
+  end
+
+  opts.on("-g", "--gpsxml GPSXML", "Gpsxml file (required)") do |v| options[:gpsxml] = v
+  end
+
+  opts.on("-o", "--output OUTPUT", "Output kml file (required)") do |v|
+    options[:output] = v
+  end
+end
+
+option_parser.parse!
+ 
+if !(options[:netxml] && options[:gpsxml] && options[:output])
+  puts option_parser.help
+  exit 1
+end
+
+KismetToKml.run!(options[:gpsxml], options[:netxml], options[:output])
+

data/lib/kismet_to_kml/consts.rb

@@ -0,0 +1,13 @@
+module KismetToKml
+  module Consts
+    BSSID               = "BSSID"
+    DATA_TYPE           = "data"
+    ESSID               = "essid"
+    GPSD_TRACKLOG_BSSID = "GP:SD:TR:AC:KL:OG"
+    NULL_BSSID          = "00:00:00:00:00:00"
+    PROBE_RESPONSE      = "Probe Response"
+    SSID                = "SSID"
+    TYPE_ATTRIBUTE      = "type"
+    UNKNOWN_SSID        = "Unknown"
+  end
+end

data/lib/kismet_to_kml/converter.rb

@@ -0,0 +1,102 @@
+require "nokogiri"
+require "optparse"
+
+require_relative "consts"
+require_relative "wifi_network"
+
+module KismetToKml
+  class Converter
+    attr_accessor :gpsxml, :netxml, :wifi_networks, :kml_file
+
+    def initialize(gpsxml_file, netxml_file, output_file)
+      @kml_file = output_file
+      @gpsxml = Nokogiri::XML(File.read(gpsxml_file))
+      @netxml = Nokogiri::XML(File.read(netxml_file))
+      @wifi_networks = {}
+    end
+
+    def convert!
+      extract_networks
+      extract_points
+      generate_kml
+    end
+
+    private
+
+    def extract_points
+      gps_points = gpsxml.xpath("//gps-point").to_a.each do |point|
+        next if useless_point(point)
+        add_point(point)
+      end
+    end
+
+    def useless_point(point)
+      point.attributes[Consts::BSSID.downcase].value == Consts::GPSD_TRACKLOG_BSSID
+    end
+
+    def add_point(point)
+      wifi_networks[point.attributes[Consts::BSSID.downcase].value]&.add_point(point)
+    end
+
+    def extract_networks
+      netxml.xpath("//wireless-network").to_a.map do |node|
+        next if node_has_useless_bssid(node)
+        next if node_is_data_type(node)
+        next if node_is_probe_response(node)
+        next unless node_has_bssid(node)
+
+        wifi_network = WifiNetwork.new(node)
+        wifi_networks[wifi_network.bssid] = wifi_network
+
+      end
+    end
+
+    def node_has_useless_bssid(node)
+      node.children.search(Consts::BSSID).first.text == Consts::NULL_BSSID
+    end
+
+    def node_is_data_type(node)
+      node.attributes[Consts::TYPE_ATTRIBUTE].value == Consts::DATA_TYPE
+    end
+
+    def node_is_probe_response(node)
+      ssid = node
+              .children
+              .search(Consts::SSID)
+              .search(Consts::TYPE_ATTRIBUTE)
+              .first
+
+      ssid && ssid.text == Consts::PROBE_RESPONSE
+    end
+
+    def node_has_bssid(node)
+      node.search(Consts::BSSID).first
+    end
+
+    def generate_kml
+      arbitrary_id = 0
+      builder = Nokogiri::XML::Builder.new(encoding: "UTF-8") do |xml|
+        xml.kml(
+          "xmlns" => "http://www.opengis.net/kml/2.2",
+          "xmlns:gx" =>"http://www.google.com/kml/ext/2.2"
+        ) do
+          xml.Document(id: arbitrary_id) do
+            arbitrary_id += 1
+            wifi_networks.values.map do |net|
+              xml.Placemark(id: arbitrary_id) do
+                arbitrary_id += 1
+                xml.name net.kml_name
+                xml.Point(id: arbitrary_id) do
+                  arbitrary_id += 1
+                  xml.coordinates net.kml_placement
+                end
+              end
+            end
+          end
+        end
+      end
+
+      File.write(kml_file, builder.to_xml)
+    end
+  end
+end

data/lib/kismet_to_kml/version.rb

@@ -0,0 +1,3 @@
+module KismetToKml
+  VERSION = "0.0.1"
+end

data/lib/kismet_to_kml/wifi_network.rb

@@ -0,0 +1,62 @@
+require_relative "consts"
+
+module KismetToKml
+  class WifiNetwork
+    def initialize(network_node)
+      @network_node = network_node
+      @gps_points = []
+    end
+
+    def add_point(gps_point_node)
+      @gps_points << gps_point_node.attributes.values.map do |attr|
+        [
+          attr.name.gsub("-", "_").to_sym,
+          attr.value
+        ]
+      end.to_h
+    end
+
+    def bssid
+      @network_node.search(Consts::BSSID).first.text
+    end
+
+    def ssid
+      begin
+        @network_node.search(Consts::SSID).first&.search(Consts::ESSID).first&.text || Consts::UNKNOWN_SSID
+      rescue
+        Consts::UNKNOWN_SSID
+      end
+    end
+
+    def kml_name
+      "#{ssid} (#{bssid})"
+    end
+
+    def kml_placement
+      total_weight = 0
+      lat_sum = 0
+      lon_sum = 0
+      alt_sum = 0
+
+      @gps_points.each do |point|
+        lat = point[:lat].to_f
+        lon = point[:lon].to_f
+        dbm = point[:signal_dbm].to_i
+        alt = point[:alt].to_f
+        weight = 10 ** ( dbm / 10 )
+
+        lat_sum += lat * weight
+        lon_sum += lon * weight
+        alt_sum += alt
+
+        total_weight += weight
+      end
+
+      center_lat = (lat_sum / total_weight).round(6)
+      center_lon = (lon_sum / total_weight).round(6)
+      avg_alt = (alt_sum / @gps_points.count).round(3)
+
+      [center_lon, center_lat, avg_alt].join(",")
+    end
+  end
+end

data/lib/kismet_to_kml.rb

@@ -0,0 +1,8 @@
+require_relative "kismet_to_kml/converter"
+
+module KismetToKml
+  def self.run!(gpsxml, netxml, output_path)
+    converter = Converter.new( gpsxml, netxml, output_path)
+    converter.convert!
+  end
+end

metadata

@@ -0,0 +1,79 @@
+--- !ruby/object:Gem::Specification
+name: kismet_to_kml
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Gabe Koss
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2024-01-24 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: nokogiri
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.14.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.14.0
+- !ruby/object:Gem::Dependency
+  name: optparse
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.3.1
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.3.1
+description: Converter utility to convert Gpsxml and Netxml files produced by kismet
+  to KML
+email: gabe@vermont.dev
+executables:
+- kismet_to_kml
+extensions: []
+extra_rdoc_files: []
+files:
+- bin/kismet_to_kml
+- lib/kismet_to_kml.rb
+- lib/kismet_to_kml/consts.rb
+- lib/kismet_to_kml/converter.rb
+- lib/kismet_to_kml/version.rb
+- lib/kismet_to_kml/wifi_network.rb
+homepage: https://github.com/granolocks/kismet_to_kml
+licenses:
+- MIT
+metadata:
+  source_code_uri: https://github.com/granolocks/kismet_to_kml
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.2.22
+signing_key: 
+specification_version: 4
+summary: Convert Kismet GPS data to KML
+test_files: []