From b297df8dd2b574206e0706134c5ff2a0803b2f5d Mon Sep 17 00:00:00 2001
From: ed <eddavies95@gmail.com>
Date: Tue, 1 Dec 2020 11:29:00 +0000
Subject: [PATCH] Added Linux Dependencies.md to docs

---
 README.md                  |  3 +-
 docs/Linux Dependencies.md | 58 ++++++++++++++++++++++++++++++++++++++
 2 files changed, 60 insertions(+), 1 deletion(-)
 create mode 100644 docs/Linux Dependencies.md

diff --git a/README.md b/README.md
index 60af0f08d7..e6db7b946c 100644
--- a/README.md
+++ b/README.md
@@ -60,7 +60,8 @@ of the target you wish to build.
 
 - __macOS/iOS__: macOS 10.11 and Xcode 7.3.1
 - __Windows__: Windows 8.1 and Visual Studio 2015 64-bit
-- __Linux__: GCC 4.8
+- __Linux__: GCC 4.8 (for a full list of dependencies, see
+[here](/docs/Linux Dependencies.md)).
 - __Android__: Android Studio on Windows, macOS or Linux
 
 #### Deployment Targets
diff --git a/docs/Linux Dependencies.md b/docs/Linux Dependencies.md
new file mode 100644
index 0000000000..107bce18b1
--- /dev/null
+++ b/docs/Linux Dependencies.md	
@@ -0,0 +1,58 @@
+# JUCE Dependencies on Linux
+
+Below is a list of the current dependencies required to build JUCE projects on
+Ubuntu, separated by module. Where the dependency is optional, the preprocessor
+flag used to disable it is noted.
+
+This has been tested on Ubuntu 16.04 LTS (Xenial Xerus), 18.04 LTS (Bionic
+Beaver), and 20.04 LTS (Focal Fossa). Packages may differ in name or not be
+available on other distrubutions.
+
+## Compiler
+A C++ compiler is required. JUCE has been tested thoroughly with Clang and GCC:
+
+    sudo apt update
+    sudo apt install clang
+
+or
+
+    sudo apt update
+    sudo apt install g++
+
+## Packages
+
+#### juce_audio_devices
+- libasound2-dev
+- libjack-jackd2-dev (unless `JUCE_JACK=0`)
+
+#### juce_core
+- libcurl4-openssl-dev (unless `JUCE_USE_CURL=0`)
+
+#### juce_graphics
+- libfreetype6-dev (unless `JUCE_USE_FREETYPE=0`)
+
+#### juce_gui_basics
+- libx11-dev
+- libxcomposite-dev
+- libxcursor-dev (unless `JUCE_USE_XCURSOR=0`)
+- libxext-dev
+- libxinerama-dev (unless `JUCE_USE_XINERAMA=0`)
+- libxrandr-dev (unless `JUCE_USE_XRANDR=0`)
+- libxrender-dev (unless `JUCE_USE_XRENDER=0`)
+
+#### juce_gui_extra
+- webkit2gtk-4.0 (unless `JUCE_WEB_BROWSER=0`)
+
+#### juce_opengl
+- libglu1-mesa-dev
+- mesa-common-dev
+
+The full command is as follows:
+
+    sudo apt update
+    sudo apt install libasound2-dev libjack-jackd2-dev \
+        libcurl4-openssl-dev  \
+        libfreetype6-dev \
+        libx11-dev libxcomposite-dev libxcursor-dev libxcursor-dev libxext-dev libxinerama-dev libxrandr-dev libxrender-dev \
+        libwebkit2gtk-4.0-dev \
+        libglu1-mesa-dev mesa-common-dev