====== Building dl-fldigi Version 2.0+ (Github) on Ubuntu! ======

Building on Linux is quick and easy, on Ubuntu even more so! These instructions are known-working on Ubuntu karmic, lucid and oneiric and have been reported to work verbatim on other versions and even Debian squeeze too. The commands aptitude and apt-get are typical of Ubuntu and Debian distributions. To build on others, you may need to find out what the packages are called on those systems.

You may want to make a note of the packages that you install below, incase you want to clean up and purge them later.



===== Vanilla fldigi Dependencies =====

Open a terminal (Applications->Accessories) and then start by installing all of the build and runtime dependencies of vanilla fldigi.

<code>$ sudo apt-get update
$ sudo apt-get build-dep fldigi</code>

===== Other dependencies =====

dl-fldigi also requires a few other libraries. To build from scratch you will also need the git and autoconf utilities.

<code>$ sudo apt-get install git-core libcurl4-openssl-dev libjpeg62-dev autoconf</code>

===== Building =====
Note that this will provide the latest version from github rather than the current released version. This could have some new features and bug fixes as well as the potential for new bugs. You will also get a warning message saying there's a new version available which can be ignored (if you want the current stable version you can run ''git checkout DL3.1'' after the git clone command.

<code>$ git clone git://github.com/ukhas/dl-fldigi.git
$ cd dl-fldigi
$ git submodule init
$ git submodule update
$ autoreconf -vfi
$ ./configure --disable-flarq --enable-optimizations=native
$ make</code>

You will now have a copy of dl-fldigi at src/fldigi. dl-fldigi will run just fine without make installing, if you prefer.

To get started, run:
<code>$ ./src/dl-fldigi</code>

Or to use the new "HAB" slim interface (advised)
<code>$ ./src/dl-fldigi --hab</code>

===== Building on Ubuntu 20.04 =====

The steps as per 18.04 can be used with one change, adding //--disable-nls// on the line below to disable native language support and remove the dependency on gettext:
<code>
$ ./configure --disable-flarq --enable-optimizations=native --disable-nls
</code>

===== Building on Ubuntu 18.04 =====

Install the build dependencies:
<code>$ sudo apt update
$ sudo apt install build-essential libssl-dev libcurl4-openssl-dev libjpeg62-dev autoconf \
 portaudio19-dev libfltk1.3-compat-headers libpng-dev libsamplerate0-dev</code>

Grab the repository (with GCC 7.3 error fix), and compile for the target machine.
<code>$ git clone --recursive --depth 1 https://github.com/philcrump/dl-fldigi.git
$ cd dl-fldigi/
$ autoreconf -vfi
$ ./configure --disable-flarq --enable-optimizations=native
$ make
</code>

You will now have a copy of dl-fldigi at src/dl-fldigi. You can run it from this location without installing.
<code>$ ./src/dl-fldigi --hab</code>


===== Building (Stable version on Ubuntu 14.04) =====
To install the released version on ubuntu 14.04 as opposed to the bleeding edge version some additional steps are required. (Similar fixes to src/Makefile.am are needed for later versions of Fedora as well)

Install main dependencies (Same as listed above)

<code>$ sudo apt-get update
$ sudo apt-get build-dep fldigi
$ sudo apt-get install git-core libcurl4-openssl-dev libjpeg62-dev autoconf</code>

Install additional dependency
<code>
$ sudo apt-get install libxmlrpc-c++8-dev
</code>

<code>$ git clone git://github.com/ukhas/dl-fldigi.git
$ cd dl-fldigi
$ git checkout DL3.1
$ git submodule init
$ git submodule update
</code>

you now need to edit the file src/Makefile.am and comment out the line that starts "TESTS =" (line 229) by adding a # to the start of the line. You can now continue with the build process as before.

<code>
$ autoreconf -vfi
$ ./configure --disable-flarq
$ make</code>

You will now have a copy of dl-fldigi at src/fldigi. dl-fldigi will run just fine without make installing, if you prefer.

To get started, run:
<code>$ ./src/dl-fldigi</code>

Or to use the new "HAB" slim interface (advised)
<code>$ ./src/dl-fldigi --hab</code>

===== Notes: =====

  * Running "./src/dl-fldigi" starts dl-fldigi in 'offline' mode. It won't upload or phone home, won't download payload data and will use the cache if any. You have to use the config tab or the dl menu to go online.

  * Starting with --hab gets you a customised "HAB UI" and is automatically "online" - but not configured to receive. See the payload drop down box and "Autoconfigure" button

  * The DL3.1 version crashes when using the THOR Op Mode and receiving just noise. The bleeding edge version does not have this issue (but is said to be problematic in the RTTY Op Mode)

  * The Version 2.0 section on the [[projects:dl-fldigi]] page has more usage information.
  * The source code provided on git may be ahead of the released version. If this is the case you will see a warning stating there's a newer version available, This can be ignored if you are happy running the latest code base.