fgmembers wiki article

'''FGMEMBERS''' is ...

* A Git repo of aircraft for FlightGear from various sources, using git sub modules
* A group of aircraft and scenery developers and contributors on github
* A fork of [[FGAddon]], which may also contain aircraft without explicit permission/support and collaboration from its original developers. An aircraft showing up in FGMEMBERS doesn't necessarily mean that the original developers endorse this.<ref>{{cite web |url=http://forum.flightgear.org/viewtopic.php?f=42&t=26043&hilit=parasitic&start=135#p241138 |title=Re: FGAddon vs. FGMEMBERS, bus factors etc. |author=IAHM-COL |date=Thu Apr 30, 2015 |publisher=FlightGear forum |accessdate=Fri Jun 12, 2015 }}</ref>
* Initiated by a single contributor, [https://github.com/IAHM-COL IAHM-COL].

== Repositories ==
The repositories are actually several repositories arranged under five groups.  The groups split content into aircraft, scenery and other data as well as content published under the [[GNU General Public License]] (GNU GPL) or under other licenses.<ref>{{cite web |url=http://forum.flightgear.org/viewtopic.php?p=231382#p231382 |title=Cloning fgdata with GIT submodules |author=IAHM-COL |date=Thu Feb 05, 2015 |publisher=FlightGear forum |accessdate=Fri Jun 12, 2015 }}</ref><ref>{{cite web |url=https://forum.flightgear.org/viewtopic.php?p=246659#p246659 |title=FGMEMBERS: The Family |author=IAHM-COL |date=Thu Jun 11, 2015 |publisher=FlightGear forum |accessdate=Fri Jun 12, 2015 }}</ref>  Common other licenses are the Creative Commons licenses.

{| class="wikitable"
! Group !! Location !! Content !! Remarks
|-
| FGDATA || https://sourceforge.net/p/fgdata/submodules/ci/next/tree/
| Fork of the FGDATA repository
| Is this a part of FGMEMBERS?  Group maintained by IAHM-COL alone (Jun 2015).
|-
| FGMEMBERS || https://github.com/FGMEMBERS
| GPL licensed aircraft
|
|-
| FGMEMBERS-NONGPL || https://github.com/FGMEMBERS-NONGPL
| Non-GPL licensed aircraft.
| Group maintained by IAHM-COL alone (Jun 2015).
|-
| FGMEMBERS-SCENERY || https://github.com/FGMEMBERS-SCENERY
| GPL licensed scenery.
| Group maintained by IAHM-COL alone (Jun 2015).
|-
| FGMEMBERS-SCENERY-NONGPL || https://github.com/FGMEMBERS-SCENERY-NONGPL
| Non-GPL licensed scenery.
| Group maintained by IAHM-COL alone (Jun 2015).
|}

== How to use ==
=== Preparation ===
(Do this only once)

Clone the "submodules" fork of fgdata (1.3 GB):

<syntaxhighlight lang="bash">
git clone http://git.code.sf.net/p/fgdata/submodules fgdata
</syntaxhighlight>

{{Note|You need to redirect your fligthgear launcher to use the new fgdata directory obtained, as the $FG_ROOT. You will also need to match the version file with the version you are running. FGDATA with submodules is available for FG3.4 or later}}

==Init the submodules==

You can initialize only a few desired Aircraft [Really, as many as you want]. The update step will only install/update those submodules initialized. per example

<syntaxhighlight lang="bash">
cd fgdata
git submodule init Aircraft/777
git submodule init Aircraft/A320neo
git submodule init Aircraft/A330-200
git submodule init Aircraft/{767,Comet-J,Jumbolino,b1900d}  # Initializes a comma separated list of aircraft
git submodule init Aircraft/L*     #Initializes any aircraft with a name beginning with Capital L
git submodule init Aircraft/[Aa]*  #Initializes any aircraft with a name beginning with A or a
</syntaxhighlight>

=== Download or update Initialized aircraft ===

The command update will now allow you to either 1) Install, or 2) Update already installed aircraft on the fly. This command only fetches submodules already initialized, and thus allowing you to control very finely, which aircraft you are interested in obtaining for testing/flying purposes.

<syntaxhighlight lang="bash">
git submodule update
</syntaxhighlight>

Alternatively, you can specify which particular submdodule you want to update. Notice that this needs to be initialized previously

<syntaxhighlight lang="bash">
git submodule update Aircraft/767
</syntaxhighlight>

Everyonce in a while, (some of) the aircraft undergo updates, you can fastly update your installed aircraft, by simply doing

<syntaxhighlight lang="bash">
git pull
git submodule update
</syntaxhighlight>

=== Download/update ALL aircraft ===
{{Note|More than 700 aircraft or about 25 GB!}}

(At a speed of ~100kb/s, the entire collection of planes, from 14bis to 787-8 took about 6-7 hours!)

To obtain all the Aircraft hosted and developed in FGMEMBERS, simply initialize all the package and update.  To initialize all the Aircraft, and thus enabling installing all of them, use init command without a parameter.

<syntaxhighlight lang="bash">
cd fgdata
git submodule init
</syntaxhighlight>

Then, you can update the Initialized aircraf (which in this case means all)

<syntaxhighlight lang="bash">
git submodule update
</syntaxhighlight>

Importantly, once you have successfully obtained all the aircraft, fetching the newest code by the developers is very easy, fast, and efficient. You do not need to download the complete aircraft(s) again, since git will only download the newest code/changes, which is very convenient manner to maintain yourself updated

<syntaxhighlight lang="bash">
cd fgdata
git pull
git submodule update
</syntaxhighlight>

== Deinitialize/Deinstall an Aircraft ==

To deinstall any Aircraft, simply deinit the respective submodule. This will clear your disk space as well, but you will still be able to reinitialize at a later time

Example, deleting the Antonov-An-12 (if previously initialized/updated)

<syntaxhighlight lang="bash">
cd fgdata
git submodule deinit Aircraft/Antonov-An-12
</syntaxhighlight>

== Footnotes ==
{{appendix}}

== Related content ==
* http://forum.flightgear.org/viewtopic.php?f=28&t=25314&start=45#p234592

[[Category:Community]]

-->