View source for Manual:Huggle/Installation

<languages />
{{Huggle/DocHeader}}
<translate>
<!--T:3-->
*'''Step 1:''' Go to the [[m:Huggle/Download|download page]] and download the latest stable version for your operating system.</translate>
<translate>
<!--T:4-->
*'''Step 2:''' Follow the instructions on download page in order to install Huggle

<!--T:5-->
That's it! Huggle should be fully operational.

== Instructions per OS == <!--T:6-->
</translate>

=== Windows ===
<translate>
<!--T:7-->
Huggle is distributed in 3 flavors for Windows:
</translate>

* MSVC-32: <translate><!--T:8--> Windows Vista and newer for 32-bit CPU</translate>
* MSVC-64: <translate><!--T:9--> Windows Vista and newer for 64-bit CPU</translate>
* MinGW-32: <translate><!--T:10--> All Windows versions for 32-bit CPU, may run slower than the MSVC versions</translate>

{{Note|1=<translate><!--T:11--> If you are switching between MinGW and MSVC versions, you may need to purge your current Huggle (uninstall and delete all leftovers from Program Files) prior to re-installation of Huggle.</translate>}}

=== macOS ===
<translate>
<!--T:12-->
Download the .dmg file from download page, open it and copy huggle to your Applications folder. Huggle should appear in the Launchpad immediately.
</translate>

== Linux ==
<translate>
<!--T:21-->
First, verify that Canonical's Snap is installed by typing snap in a terminal window. Then, follow the instructions below.

=== Debian distributions without snap === <!--T:22-->

<!--T:23-->
If your Linux distro does not come with snap or if you prefer to build it manually, then you can compile it manually.

<!--T:24-->
First, install the required packages with APT.
</translate>

<syntaxhighlight lang="bash">
sudo apt update && sudo apt install git build-essential gcc cmake qt5-default qtmultimedia5-dev qtwebengine5-dev
</syntaxhighlight>

<translate>
<!--T:25-->
Next, clone the repository with Git:
</translate>

<syntaxhighlight lang="bash">
git clone https://github.com/huggle/huggle3-qt-lx.git && cd huggle3-qt-lx && git submodule init && git submodule update && git checkout tags/3.4.10
</syntaxhighlight>

<translate>
<!--T:26-->
Finally, to build and install Huggle, run this script:
</translate>

<syntaxhighlight lang="bash">
 ./configure --extension --web-engine
cd release
make
sudo make install
sudo ldconfig
cd
</syntaxhighlight>

<translate><!--T:27--> If you did this correctly, you should have a working install of Huggle!</translate>
<translate><!--T:16--> To start Huggle, type:</translate>

<syntaxhighlight lang="bash">
huggle
</syntaxhighlight>

<translate>
=== Arch distributions without snap === <!--T:28-->
</translate>
<translate><!--T:29--> Huggle is available in the Arch User Repository.</translate>
<translate><!--T:30--> You can install it with yay/yaourt/pacaur/any other AUR helper, e.g.</translate>
<syntaxhighlight lang="bash">
yay -S huggle
</syntaxhighlight>

<translate>
<!--T:31-->
There is also the huggle-git package for the development version.

=== Ubuntu and Linux distributions with snap === <!--T:18-->

<!--T:19-->
On all linux distributions with snap preinstalled (such as Ubuntu 16.04 and newer), Huggle can be installed as easily as this:
</translate>

<pre>
sudo snap install huggle
</pre>

<translate>
<!--T:20-->
It can also installed from [[w:Ubuntu Software|Ubuntu software]] which is preinstalled in Ubuntu 16.04 and newer.
</translate>

{{Huggle/Manual/DocFooter|Quick start|Uninstalling|3=<translate><!--T:15--> Quick start</translate>|4=<translate><!--T:14--> Uninstalling</translate>}}

[[Category:Huggle{{#translation:}}]]