FFGo: Difference between revisions

Jump to navigation Jump to search
423 bytes removed ,  30 April 2016
Update for release 1.11.3 and new home page (proof: OpenPGP-signed tarballs and zip files at http://frougon.net/projects/FFGo/dist/ and https://pypi.python.org/pypi/FFGo)
m (Update Infobox for FFGo 1.11.2)
(Update for release 1.11.3 and new home page (proof: OpenPGP-signed tarballs and zip files at http://frougon.net/projects/FFGo/dist/ and https://pypi.python.org/pypi/FFGo))
Line 7: Line 7:
| type                  = Graphical launcher for FlightGear
| type                  = Graphical launcher for FlightGear
| initialrelease        = 1.0.0 (Aug 21, 2015)
| initialrelease        = 1.0.0 (Aug 21, 2015)
| latestrelease          = 1.11.2 (Mar 27, 2016)
| latestrelease          = 1.11.3 (Apr 30, 2016)
| writtenin              = Python 3
| writtenin              = Python 3
| os                    = Unix-like (incl. Linux), Windows, MacOS X
| os                    = Unix-like (incl. Linux), Windows, MacOS X
| developmentstatus      = Active (as of March 2016)
| developmentstatus      = Active (as of April 2016)
| website                = http://people.via.ecp.fr/~flo/projects/FFGo/
| website                = http://frougon.net/projects/FFGo/
| license                = {{wikipedia|WTFPL#Version 2|WTFPL version 2|noicon=1}}
| license                = {{wikipedia|WTFPL#Version 2|WTFPL version 2|noicon=1}}
}}
}}
Line 19: Line 19:
== Features ==
== Features ==


One of the things that distinguish FFGo from other FlightGear launchers is the text window allowing one to write any (possibly advanced) [[Command_line_options|command line options]] that will be passed to FlightGear. This is similar, but more convenient and powerful, to editing the [[Fgfsrc|.fgfsrc]] configuration file. The main difference in power compared to editing .fgfsrc or using FGo! comes from FFGo's use of [http://people.via.ecp.fr/~flo/projects/CondConfigParser/ CondConfigParser] to process the user's configuration. See [https://people.via.ecp.fr/~flo/projects/FFGo/doc/README-conditional-config/ FFGo conditional config documentation] for more information on this aspect of FFGo.
One of the things that distinguish FFGo from other FlightGear launchers is the text window allowing one to write any (possibly advanced) [[Command_line_options|command line options]] that will be passed to FlightGear. This is similar, but more convenient and powerful, to editing the [[Fgfsrc|.fgfsrc]] configuration file. The main difference in power compared to editing .fgfsrc or using FGo! comes from FFGo's use of [http://frougon.net/projects/CondConfigParser/ CondConfigParser] to process the user's configuration. See [http://frougon.net/projects/FFGo/doc/README-conditional-config/ FFGo conditional config documentation] for more information on this aspect of FFGo.


In addition to this, FFGo offers:
In addition to this, FFGo offers:
Line 150: Line 150:
== Installation tips ==
== Installation tips ==
=== Instructions — Read this first! ===
=== Instructions — Read this first! ===
Since installation instructions may in general depend on the particular FFGo version you want to install, they are always included in release tarballs and zip files, precisely in the <tt>docs/INSTALL</tt> folder. Such tarballs and zip files can be downloaded from [http://people.via.ecp.fr/~flo/projects/FFGo/ FFGo's home page] as well as from [https://pypi.python.org/pypi/FFGo FFGo's page on PyPI] (PyPI being [https://pypi.python.org/pypi the Python Package Index]). However, apart from the addition of a small number of optional dependencies, the installation method hasn't changed since FFGo 1.0.0, therefore there is little risk for now using the online [https://github.com/frougon/FFGo/blob/master/docs/INSTALL/INSTALL_en Git version of the installation guide].
Since installation instructions may in general depend on the particular FFGo version you want to install, they are always included in release tarballs and zip files, precisely in the <tt>docs/INSTALL</tt> folder. Such tarballs and zip files can be downloaded from [http://frougon.net/projects/FFGo/ FFGo's home page] as well as from [https://pypi.python.org/pypi/FFGo FFGo's page on PyPI] (PyPI being [https://pypi.python.org/pypi the Python Package Index]). However, apart from the addition of a small number of optional dependencies, the installation method hasn't changed since FFGo 1.0.0, therefore there is little risk for now using the online [https://github.com/frougon/FFGo/blob/master/docs/INSTALL/INSTALL_en Git version of the installation guide].


The guide mentioned in the previous paragraph is rather detailed, because it explains a few concepts that may be new to users who are not Python developers, and tries to give general instructions covering all common cases, which is not very easy given that Python may or may not be shipped depending on the particular operation system in use (Windows, Linux, MacOS X, etc.). To the contrary, the following sections give specific instructions applicable in the most common cases on each OS where I know a working procedure. They are more practical, probably easier to follow than the installation guide, at the expense of being less generic.
The guide mentioned in the previous paragraph is rather detailed, because it explains a few concepts that may be new to users who are not Python developers, and tries to give general instructions covering all common cases, which is not very easy given that Python may or may not be shipped depending on the particular operation system in use (Windows, Linux, MacOS X, etc.). To the contrary, the following sections give specific instructions applicable in the most common cases on each OS where I know a working procedure. They are more practical, probably easier to follow than the installation guide, at the expense of being less generic.
Line 470: Line 470:
Florent Rougon. They can be downloaded and installed normally using
Florent Rougon. They can be downloaded and installed normally using
''apt-get'', ''aptitude'', etc. provided you have installed
''apt-get'', ''aptitude'', etc. provided you have installed
[https://people.via.ecp.fr/~flo/OpenPGP-key.asc Florent's OpenPGP key].
[http://frougon.net/OpenPGP-key.asc Florent's OpenPGP key].


<ul>
<ul>
Line 486: Line 486:
</syntaxhighlight>
</syntaxhighlight>


the output of which should show the [https://people.via.ecp.fr/~flo/keys.html correct fingerprint]:
the output of which should show the [http://frougon.net/keys.html correct fingerprint]:


<pre>pub  rsa4096/0xC785B90B5053A3A2 2010-03-17 [expires: 2016-10-19]
<pre>pub  rsa4096/0xC785B90B5053A3A2 2010-03-17 [expires: 2016-10-19]
Line 505: Line 505:
attacks—using <tt>/tmp</tt> instead of <tt>~/tmp</tt> wouldn't be a great idea).</li></ol>
attacks—using <tt>/tmp</tt> instead of <tt>~/tmp</tt> wouldn't be a great idea).</li></ol>
</li>
</li>
<li>The other way is getting [https://people.via.ecp.fr/~flo/OpenPGP-key.asc the key] via HTTPS from [https://people.via.ecp.fr/~flo/ Florent's home page] (it is linked from [https://people.via.ecp.fr/~flo/keys.html that page] on Florent's site). HTTPS uses TLS which is kind of
<li>The other way is getting [http://frougon.net/OpenPGP-key.asc the key] from [http://frougon.net/ Florent's home page] (it is linked from [http://frougon.net/keys.html that page] on Florent's site). In short, assuming you have the <tt>wget</tt> package installed, you can get the key with:
crap, but it is not worse than when you check your bank accounts online or
purchase something online, or download most programs without <tt>apt</tt>
(which relies on GnuPG, not HTTPS). In short, assuming you have the <tt>wget</tt> package installed, you can get the key with:


<syntaxhighlight lang="shell" enclose="div">
<syntaxhighlight lang="shell" enclose="div">
wget -O ~/tmp/flo-key https://people.via.ecp.fr/~flo/OpenPGP-key.asc
wget -O ~/tmp/flo-key http://frougon.net/OpenPGP-key.asc
</syntaxhighlight></li>
</syntaxhighlight></li>
Once you have that key in the file <tt>flo-key</tt>, you can install it for <tt>apt</tt> by running, <i>as root</i>:
Once you have that key in the file <tt>flo-key</tt>, you can install it for <tt>apt</tt> by running, <i>as root</i>:
Line 522: Line 519:


<syntaxhighlight lang="shell" enclose="div">
<syntaxhighlight lang="shell" enclose="div">
wget -O- https://people.via.ecp.fr/~flo/OpenPGP-key.asc | apt-key add -
wget -O- http://frougon.net/OpenPGP-key.asc | apt-key add -
</syntaxhighlight>
</syntaxhighlight>


Line 535: Line 532:
<p>Add the following lines to your <tt>/etc/apt/sources.list</tt>:</p>
<p>Add the following lines to your <tt>/etc/apt/sources.list</tt>:</p>


<pre>deb http://people.via.ecp.fr/~flo/debian-ffgo unstable main
<pre>deb http://frougon.net/debian-ffgo unstable main
deb-src http://people.via.ecp.fr/~flo/debian-ffgo unstable main</pre>
deb-src http://frougon.net/debian-ffgo unstable main</pre>


<p>(replace <tt>unstable</tt> with <tt>jessie</tt> if you are using <i>jessie</i>)</p>
<p>(replace <tt>unstable</tt> with <tt>jessie</tt> if you are using <i>jessie</i>)</p>
Line 672: Line 669:
<p><em><strong>First session:</strong> installing FFGo (and some of its
<p><em><strong>First session:</strong> installing FFGo (and some of its
dependencies, such as
dependencies, such as
[http://people.via.ecp.fr/~flo/projects/CondConfigParser/ CondConfigParser])
[http://frougon.net/projects/CondConfigParser/ CondConfigParser])
using <tt>pip</tt> in a virtual environment.</em></p>
using <tt>pip</tt> in a virtual environment.</em></p>


Line 793: Line 790:
<li><p><em><strong>Second session:</strong> installing some of FFGo's
<li><p><em><strong>Second session:</strong> installing some of FFGo's
dependencies (such as
dependencies (such as
[http://people.via.ecp.fr/~flo/projects/CondConfigParser/ CondConfigParser])
[http://frougon.net/projects/CondConfigParser/ CondConfigParser])
using <tt>pip</tt> in a virtual environment, while using FFGo directly from a
using <tt>pip</tt> in a virtual environment, while using FFGo directly from a
clone of its [https://github.com/frougon/FFGo Git repository].</em></p>
clone of its [https://github.com/frougon/FFGo Git repository].</em></p>
Line 1,112: Line 1,109:


== Related content ==
== Related content ==
* [http://people.via.ecp.fr/~flo/projects/FFGo/ FFGo's home page]
* [http://frougon.net/projects/FFGo/ FFGo's home page]
* [https://people.via.ecp.fr/~flo/projects/FFGo/doc/README-conditional-config/ FFGo conditional config documentation]
* [http://frougon.net/projects/FFGo/doc/README-conditional-config/ FFGo conditional config documentation]
* [http://forum.flightgear.org/viewtopic.php?f=18&t=27054 FFGo's thread on the FlightGear forum]
* [http://forum.flightgear.org/viewtopic.php?f=18&t=27054 FFGo's thread on the FlightGear forum]
* [[FGo!]] — ''predecessor to FFGo''
* [[FGo!]] — ''predecessor to FFGo''
377

edits

Navigation menu