AutoEarthView

From FlightGear wiki
Jump to navigation Jump to search
AutoEarthView Add-on
AutoEarthView Add-on logo
AutoEarthView.png
Developed by flyer02@gitlab
Initial release June 21, 2026
Latest release 0.9.1, June 23, 2026
Written in Nasal
Platform Min FG version 2024.1
Development status Stable
Type Addon
License GNU General Public License v3
Website

AutoEarthView is a FlightGear addon that automatically enables/disables Earthview orbital rendering based on the altitude, making it no longer necessary to manually open the EarthView dialog. It automatically starts Earthview when you ascend above a configurable altitude threshold and stops it when you descend below another threshold.

Features

  • Automatic activation – Earthview starts when climbing above the start threshold
  • Automatic deactivation – Earthview stops when descending below the stop threshold
  • Persistent settings – All preferences are saved and restored between sessions
  • Real-time configuration – Adjust thresholds on the fly via a simple dialog
  • Toggle on/off – Enable or disable the automation at any time
  • Minimal performance impact – Altitude checks run every 0.5 seconds

Installation

1. Download the source code from the latest release and extract it to a directory on your computer. If you want to get the development version, you can run git clone https://gitlab.com/flyer02/AutoEarthView --depth 1.

2. In the launcher, select the Add-ons page from the icon bar on the left, then find the section Add-on Module folders and click the Add(+) button. Select the folder where you put the addon. Once the addon is shown in the list, make sure its check box is selected. The selected folder path should end with "AutoEarthView".

Usage

Accessing the Dialog

Navigate to the menu bar: AutoEarthView → Options

Configuration Options

Setting Description Default
Start threshold Altitude (in feet) at which Earthview automatically starts during climb 63,000 ft
Stop threshold Altitude (in feet) at which Earthview automatically stops during descent 30,000 ft
Enabled Master toggle to enable/disable the automation Enabled

Dialog Controls

  • Start threshold – Input field for the climb activation altitude
  • Stop threshold – Input field for the descent deactivation altitude
  • Enabled – Checkbox to turn automation on/off
  • Reset to defaults – Restores factory settings

Menu Bar

The addon adds a new menu: AutoEarthView with two items:

  • Options – Opens the configuration dialog
  • About – Displays addon information

How It Works

The addon monitors your aircraft's altitude in real-time. When you cross the start threshold during a climb, Earthview is automatically enabled. When you cross the stop threshold during a descent, Earthview is automatically disabled.

Climbing:  altitude ≥ 63,000 ft  → Earthview starts automatically
Descending: altitude ≤ 30,000 ft → Earthview stops automatically

Configuration File

Settings are stored in ~/.fgfs/Export/Addons/org.flightgear.addons.AutoEarthView/save.txt, or C:\Users\your username\AppData\Roaming\flightgear.org\Export\Addons\org.flightgear.addons.AutoEarthView\save.txt on Windows.

​ ​