Metadata-Version: 2.4
Name: satellite
Version: 0.9.2
Summary: Navigation satellite (GPS/GNSS) application
Author-email: Teemu Ikonen <tpikonen@mailbox.org>
License-Expression: GPL-3.0-only
Project-URL: Homepage, https://codeberg.org/tpikonen/satellite
Project-URL: Issues, https://codeberg.org/tpikonen/satellite/issues
Keywords: geolocation,gps,gnss,gpx
Classifier: Programming Language :: Python :: 3
Classifier: Operating System :: POSIX :: Linux
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: X11 Applications :: GTK
Classifier: Intended Audience :: End Users/Desktop
Classifier: Topic :: Desktop Environment :: Gnome
Classifier: Topic :: Scientific/Engineering :: GIS
Classifier: Topic :: Utilities
Requires-Python: >=3.11
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: gpxpy
Requires-Dist: pygobject
Requires-Dist: pynmea2
Dynamic: license-file

# Satellite

![Main view](https://tpikonen.codeberg.page/satellite/img/screenshot-default.png)
![Expanded view](https://tpikonen.codeberg.page/satellite/img/screenshot-expanded.png)
![Landscape view, dark mode](https://tpikonen.codeberg.page/satellite/img/screenshot-landscape-dark.png)

Satellite displays global navigation satellite system (GNSS: GPS et al.) data
obtained from an [NMEA](https://gpsd.gitlab.io/gpsd/NMEA.html#_gns_fix_data)
source in your Linux device. It can read data from
[ModemManager](https://www.freedesktop.org/wiki/Software/ModemManager/),
[gnss-share](https://gitlab.com/postmarketOS/gnss-share)
[gps-share](https://github.com/zeenix/gps-share) and
[gpsd](https://gpsd.gitlab.io/gpsd/). It can also save a track of your
movements to a GPX-file.

## License

GPL-3.0

## Dependencies:

    python 3.6+, PyGObject, GTK4, libadwaita, libmm-glib, pynmea2, gpxpy

## Installing and running

### Flathub

<a href='https://flathub.org/apps/details/page.codeberg.tpikonen.satellite'>
<img width='240' alt='Get it on Flathub' src='https://flathub.org/api/badge?locale=en'/>
</a>

Satellite is
[in flathub](https://flathub.org/apps/details/page.codeberg.tpikonen.satellite)
and can be installed from there, or from a software manager like Gnome software.
The direct install link is
[here](https://dl.flathub.org/repo/appstream/page.codeberg.tpikonen.satellite.flatpakref).

Run

    flatpak run page.codeberg.tpikonen.satellite

to execute from the command line.

### From source tree

Run the script `bin/satellite`.

### pipx install from source tree

Run

    pipx install --system-site-packages ./

in the source tree root.

The `--system-site-packages` option allows the created venv to use PyGObject from your distribution.

A link to an executable entry point script is created in `$HOME/.local/bin/satellite`.
Links to `.desktop` or icon files are not created by pipx, but you can create them manually:

    ln -s ~/.local/pipx/venvs/satellite/share/applications/satellite.desktop ~/.local/share/applications/satellite.desktop
    ln -s ~/.local/pipx/venvs/satellite/share/icons/hicolor/scalable/apps/page.codeberg.tpikonen.satellite.svg ~/.local/share/icons

### Flatpak from source tree

Run

    flatpak-builder --install --user build-dir flatpak/page.codeberg.tpikonen.satellite.yaml

in the source tree root to install a local build to the user flatpak repo.

## Hints

You can start recording a GPX track by selecting 'Record track' from the main
menu. The GPX file is saved in `$HOME/Documents/satellite-tracks`.
