csete / gpredict

Gpredict satellite tracking application
http://gpredict.oz9aec.net/
GNU General Public License v2.0
880 stars 250 forks source link
amsat c gtk3 ham-radio linux satellite space tracking

Gpredict is a real time satellite tracking and orbit prediction program for the Linux desktop. It uses the SGP4/SDP4 propagation algorithms together with NORAD two-line element sets (TLE).

Some core features of Gpredict include:

Visit the gpredict homepage at http://gpredict.oz9aec.net/ for more info.

Requirements

Gpredict is written using the Gtk+ 3 widget set, which is available for most Unix like operating systems, Mac and Windows. Following libraries are required for successful compilation of Gpredict:

If you compile Gpredict from source you will also need the development packages often with -dev or -devel in the package name, e.g. libgtk-3-dev. On Debian and Ubuntu systems you can install the build dependencies using:

sudo apt install libtool intltool autoconf automake libcurl4-openssl-dev sudo apt install pkg-config libglib2.0-dev libgtk-3-dev libgoocanvas-2.0-dev

To build and install gpredict from source, first unpack the source package:

tar -xvf gpredict-x.y.z.tar.gz

Then change to the gpredict-x.y.z directory and build gpredict:

./configure make make install

The last step usually requires you to become root, otherwise you may not have the required permissions to install gpredict. If you can not or do not want to install gpredict as root, you can install gpredict into a custom directory by adding --prefix=somedir to the ./configure step. For example

./configure --prefix=/home/user/predict

will configure the build to install the files into /home/user/gpredict folder.

If you are building directly from the git repository, you have to run ./autogen.sh instead of of configure. You can pass the same options to the autogen.sh script as you would to the configure script.

If you want to know more about installation options refer to the INSTALL file (not for beginners).

Using Gpredict

Gpredict comes bundled with some example data and will run "out of the box". Once you got the idea of the UI, you can either modify the settings of the default module (click on the small down-arrow in the top right corner), or create a new module through File -> New Module.

You are highly encouraged to have a look at the user manual available at http://gpredict.oz9aec.net/documents.php

User support

User support is provided through the Gpredict forum hosted by the Libre Space Foundation: https://community.libre.space/c/gpredict

Terms and conditions

Gpredict is released under the GNU General Public License and comes with NO WARRANTY whatsoever. If you have problems installing or using Gpredict, feel free to ask for support for example on the Gpredict forum hosted by the Libre Space Foundation https://community.libre.space/c/gpredict

Note that the development environment is being migrated from Sourceforge to Github: https://github.com/csete/gpredict

Mailing lists, old bug trackers, etc, are still available on Sourceforge: http://sourceforge.net/projects/gpredict

Happy Tracking!

Alexandru Csete OZ9AEC