LibreWolf/README.md

Building LibreWolf from source:

First, let's download the latest tarball. This tarball is the latest produced by the CI.

To download the latest from a script, use wget/curl like this:

export version=95.0.2 # example
wget -O librewolf-$(version).source.tar.gz https://gitlab.com/librewolf-community/browser/source/-/jobs/artifacts/main/raw/librewolf-$(version).source.tar.gz?job=build-job
curl -L -o librewolf-$(version).source.tar.gz https://gitlab.com/librewolf-community/browser/source/-/jobs/artifacts/main/raw/librewolf-$(version).source.tar.gz?job=build-job

Next, we create ourselves a build folder and extract the tarball.

mkdir build
cd build
tar xf ../librewolf-$(version).source.tar.gz

Next step, if you have not done so already, you must create the build environment:

librewolf-$(version)/lw/mozfetch.sh

It takes about an hour for me to complete, but it needs to be done only once. This step might fail and cause problems. Hack a bit, and if that fails you can ask on our Gitter/matrix channel.

Now we're ready to actually build LibreWolf:

cd librewolf-$(version)
./mach build

Also takes me an hour. Then, we can run it:

./mach run

Or make a package:

./mach package

[dev info] How to use this repo instead of Common:

Since the dawn of time, we have used Common to get patches, source_files, including source_files/{branding}

This source repo supports all that, because it uses the same things to produce the tarball. As far as I can tell, the mapping from Common to Source would be:

• patches -> patches
• source_files/search-config.json -> assets/search-config.json
• source_files/browser/branding/librewolf -> themes/browser/branding/librewolf

With this mapping, I hope that other builders that can't use our tarball (afterMozilla project, weird distro's), still use the same source/patches as the builders that do use it.

• Another feature: The file assets/patches.txt defines what patches go in. There might be other patches in the patches/ folder, for certain distro's or whatever reason.

[dev info] Building the LibreWolf source tarball:

Luckly, you don't need the build environment for this. If you don't have write access, just:

git clone https://gitlab.com/librewolf-community/browser/source.git
cd source
make all

If you do have write access, we're first gonna check for a newer version of Firefox:

git clone git@gitlab.com:librewolf-community/browser/source.git
cd source
make check

If there is a new version, it's a good time to git commit and trigger a CI build job.

git commit -am v$(cat version) && git push

To build the source archive:

make all

If you have a working build environment, you can build librewolf with:

make librewolf

This extracts the source, and then tries to ./mach build && ./mach package.