Skip to main content
Pre-release

This release is a pre-release and may not be stable for production use.

PHAL plugin - IPGeo

This plugin sets the default location for OpenVoiceOS based on the IP address of the device. It queries ip-api.com and stores the result in the local configuration.

The plugin does not overwrite a location that a user or a backend already set. It only fills in the location if the value is missing.

The City, regionName, and country fields are localized to the active language when possible. Supported languages are en, de, es, pt, fr, ja, zh, and ru.

Install

pip install ovos-phal-plugin-ipgeo

Usage

OVOS loads this plugin through the PHAL plugin manager. No manual setup is required.

The plugin geolocates the device on these bus messages:

  • mycroft.internet.connected: sent when the device gets an internet connection.
  • ovos.ipgeo.update: sent to request a location update. Send overwrite: true in the message data to replace an existing location.

Related projects

License

Apache-2.0

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

ovos_phal_plugin_ipgeo-0.1.9a2.tar.gz (7.3 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

ovos_phal_plugin_ipgeo-0.1.9a2-py3-none-any.whl (8.0 kB view details)

Uploaded Python 3

File details

Details for the file ovos_phal_plugin_ipgeo-0.1.9a2.tar.gz.

File metadata

  • Download URL: ovos_phal_plugin_ipgeo-0.1.9a2.tar.gz
  • Upload date:
  • Size: 7.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for ovos_phal_plugin_ipgeo-0.1.9a2.tar.gz
Algorithm Hash digest
SHA256 528e06d9a677a528e4d2c5625415baaaae2f98f18f490665f2b79be22978c80d
MD5 6218b0460b2ec28bf75c7229707af717
BLAKE2b-256 e284b1bcde247c3e7a48ba2d514063ed28600f06a12532a980265c9ddae6e7a0

See more details on using hashes here.

File details

Details for the file ovos_phal_plugin_ipgeo-0.1.9a2-py3-none-any.whl.

File metadata

File hashes

Hashes for ovos_phal_plugin_ipgeo-0.1.9a2-py3-none-any.whl
Algorithm Hash digest
SHA256 89112e30dd8251a9499dad928846045029a8333780d4135d2b48ea48549954eb
MD5 16473e24aed4b02426d3f04a538e7c60
BLAKE2b-256 eac49e0a246ff1bf45687a4bc2b28777105a3b5939d2156c6a4a11100b0ca42f

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page