====== Sources ======

Hyperbola Project offers several sources services for users who wish build Hyperbola from scratch.

===== Package Sources Repositories =====

Hyperbola source tarballs contain everything that is used to build a complete package. This includes the PKGBUILD, patches, files and upstream sources tarballs. If an upstream tarballs contain nonfree media, they are deblobbed prior to being placed in these tarballs to respect your freedom. These tarballs can be downloaded directly via HTTPS from the mirror sites listed below.

==== Stable ====

{| border="1" style="border-collapse:collapse; width: 100%; text-align: center; color:#262627; background-color:#f8f9fa;"
! style="background-color:#eaecf0"  colspan="2" | Information
|-
! colspan="2" align="center" style="text-align: left" |
{| border="0" style="border-collapse:collapse; width: 100%; text-align: center; color:#262627; background-color:#f8f9fa;"
! style="background-color:#eaecf0"  colspan="1" |
! style="background-color:#eaecf0"  colspan="1" | Country
! style="background-color:#eaecf0"  colspan="1" | Mirror
|-
| {{:flag_of_ecuador.png|}}
| Ecuador
| [[https://mirror.cedia.org.ec/hyperbola/gnu-plus-linux-libre/stable/sources/ | Red Cedia]]
|-
| {{:flag_of_the_netherlands.png|}}
| Netherlands
| [[https://ftp.nluug.nl/os/Linux/distr/hyperbola/gnu-plus-linux-libre/stable/sources/ | Vereniging NLUUG]]
|-
| {{:flag_of_the_united_states_of_america.png|}}
| USA
| [[https://mirror.fsf.org/hyperbola/gnu-plus-linux-libre/stable/sources/ | Free Software Foundation]]
|-
| {{:flag_of_the_netherlands.png|}}
| Netherlands
| [[https://hyperbola.isacdaavid.info/gnu-plus-linux-libre/stable/sources/ | Isaac David's mirror]]
|-
| {{:flag_of_lithuania.png|}}
| Lithuania
| [[https://repo.hyperbola.info:50012/gnu-plus-linux-libre/stable/sources/ | Hyperbola Project]]
|}
|}

==== Testing ====

{| border="1" style="border-collapse:collapse; width: 100%; text-align: center; color:#262627; background-color:#f8f9fa;"
! style="background-color:#eaecf0"  colspan="2" | Information
|-
! colspan="2" align="center" style="text-align: left" |
{| border="0" style="border-collapse:collapse; width: 100%; text-align: center; color:#262627; background-color:#f8f9fa;"
! style="background-color:#eaecf0"  colspan="1" |
! style="background-color:#eaecf0"  colspan="1" | Country
! style="background-color:#eaecf0"  colspan="1" | Mirror
|-
| {{:flag_of_ecuador.png|}}
| Ecuador
| [[https://mirror.cedia.org.ec/hyperbola/gnu-plus-linux-libre/testing/sources/ | Red Cedia]]
|-
| {{:flag_of_the_netherlands.png|}}
| Netherlands
| [[https://ftp.nluug.nl/os/Linux/distr/hyperbola/gnu-plus-linux-libre/testing/sources/ | Vereniging NLUUG]]
|-
| {{:flag_of_the_united_states_of_america.png|}}
| USA
| [[https://mirror.fsf.org/hyperbola/gnu-plus-linux-libre/testing/sources/ | Free Software Foundation]]
|-
| {{:flag_of_lithuania.png|}}
| Lithuania
| [[https://repo.hyperbola.info:50011/gnu-plus-linux-libre/testing/sources/ | Hyperbola Project]]
|}
|}

==== Build procedure ====

It is recommended to use libretools to compile these sources from a clean chroot environment.

<code bash>
# pacman -S libretools
</code>

<note tip>
See the [[https://wiki.parabola.nu/Package_maintainer_guide|Parabola's Package Maintainer Guide]] for further details about libretools.
</note>

Download manually the source tarball and signature from [[en:project:sources#stable|stable]] or [[en:project:sources#testing|testing]] version.

<code bash>
$ wget "https://repo.hyperbola.info:50012/gnu-plus-linux-libre/stable/sources/hyperbola/[package_name]-[version]-[release].src.tar.gz"
</code>

<code bash>
$ wget "https://repo.hyperbola.info:50012/gnu-plus-linux-libre/stable/sources/hyperbola/[package_name]-[version]-[release].src.tar.gz.sig"
</code>

Verify the authenticity of the source tarball.

<code bash>
$ gpg --verify [package_name]-[version]-[release].src.tar.gz.sig
</code>

<note tip>
If gpg complains about the key ID, try the following commands instead:

<code bash>
$ gpg --keyserver pgp.mit.edu --recv-key [key ID]
</code>

<code bash>
$ gpg --list-key --with-fingerprint [key ID]
</code>

Check the output of the last command, to make sure the fingerprint is correct. 
</note>

Extract and navigate to your desired extracted source tarball.

<code bash>
$ mkdir foo
</code>

<code bash>
$ bsdtar xpf [package_name]-[version]-[release].src.tar.gz -C foo
</code>

<code bash>
$ cd foo
</code>

Build the desired extracted source tarball

<code bash>
$ doas libremakepkg
</code>

<note warning>
Using su would not work with libremakepkg.
</note>

Install the compiled package when build is completed

<code bash>
# pacman -U [package_name]-[version]-[release]-[architecture].pkg.tar.xz
</code>

===== Other Sources =====

In addition to the package sources repositories, Hyperbola Project offers live images, deblobbed source codes/tarballs, logos, Kodi addons repo. These miscellaneous files can be downloaded directly via HTTPS from the mirror sites listed below.

{| border="1" style="border-collapse:collapse; width: 100%; text-align: center; color:#262627; background-color:#f8f9fa;"
! style="background-color:#eaecf0"  colspan="2" | Information
|-
! colspan="2" align="center" style="text-align: left" |
{| border="0" style="border-collapse:collapse; width: 100%; text-align: center; color:#262627; background-color:#f8f9fa;"
! style="background-color:#eaecf0"  colspan="1" |
! style="background-color:#eaecf0"  colspan="1" | Country
! style="background-color:#eaecf0"  colspan="1" | Mirror
|-
| {{:flag_of_ecuador.png|}}
| Ecuador
| [[https://mirror.cedia.org.ec/hyperbola/sources/ | Red Cedia]]
|-
| {{:flag_of_the_netherlands.png|}}
| Netherlands
| [[https://ftp.nluug.nl/os/Linux/distr/hyperbola/sources/ | Vereniging NLUUG]]
|-
| {{:flag_of_the_united_states_of_america.png|}}
| USA
| [[https://mirror.fsf.org/hyperbola/sources/ | Free Software Foundation]]
|-
| {{:flag_of_lithuania.png|}}
| Lithuania
| [[https://repo.hyperbola.info/ | Hyperbola Project]]
|}
|}