0
Fork 0
mirror of https://codeberg.org/librewolf/source.git synced 2024-12-22 21:53:31 -05:00
LibreWolf/README.md.in

139 lines
5.7 KiB
Markdown
Raw Normal View History

2022-04-13 09:27:39 -05:00
# LibreWolf Source Repository
This repository contains all the patches and theming that make up LibreWolf, as well as scripts and a Makefile to build LibreWolf. There also is the [Settings repo](https://gitlab.com/librewolf-community/settings), which contains the LibreWolf prefs.
2022-03-08 08:37:52 -05:00
## Active repositories and projects
List of browser build sub projects. These are the locations where people have their repositories and build artifacts.
Currently active build repositories:
2022-03-09 07:16:06 -05:00
* [Arch](https://gitlab.com/librewolf-community/browser/arch): Arch Linux
* [Bsys5](https://gitlab.com/librewolf-community/browser/bsys5): deb/rpm for Mint,Fedora,Ubuntu; dmg for MacOS.
* [Debian](https://gitlab.com/librewolf-community/browser/debian): bgstack15 version
* [Fedora](https://gitlab.com/librewolf-community/browser/fedora): bgstack15 version
* [Flatpak](https://gitlab.com/librewolf-community/browser/flatpak): Flatpak
* [Gentoo](https://gitlab.com/librewolf-community/browser/gentoo): Gentoo
* [Linux](https://gitlab.com/librewolf-community/browser/linux): Flatpak, AppImage, Arch and other Linux builds of the LibreWolf browser.
* [MacOS](https://gitlab.com/librewolf-community/browser/macos): The macOS build of LibreWolf.
* [OpenBSD](https://librewolf.net/installation/openbsd/): OpenBSD page
* [Windows](https://gitlab.com/librewolf-community/browser/windows): LibreWolf builds for Windows.
2022-03-08 08:37:52 -05:00
2022-03-13 08:22:37 -05:00
Currently active forks:
* Cachy-Browser: https://github.com/cachyos/cachyos-browser-settings
2022-03-08 08:37:52 -05:00
* FireDragon: https://github.com/dr460nf1r3/firedragon-browser
2022-02-03 04:58:11 -05:00
## LibreWolf build instructions
2022-02-03 04:17:35 -05:00
2022-04-13 09:27:39 -05:00
There currently are two ways to build LibreWolf. You can either use the source tarball or compile directly with this repository.
### Building from the Tarball
2022-02-05 15:09:43 -05:00
First, let's **[download the latest tarball](https://gitlab.com/librewolf-community/browser/source/-/jobs/artifacts/main/raw/librewolf-__VERSION__-__RELEASE__.source.tar.gz?job=Build)**. This tarball is the latest produced by the [CI](https://gitlab.com/librewolf-community/browser/source/-/jobs). You can also check the sha256sum of the tarball there.
2022-02-09 07:10:41 -05:00
2022-02-03 04:57:05 -05:00
```
tar xf <tarball>
cd <folder>
```
2022-04-13 09:27:39 -05:00
Then, you have to bootstrap your system to be able to build LibreWolf. You only have to do this one time. It is done by running the following commands:
2022-02-03 04:57:05 -05:00
```
2022-04-13 09:27:39 -05:00
./mach --no-interactive bootstrap --application-choice=browser
./lw/setup-wasi-linux.sh
```
Finally you can build LibreWolf and then package or run it with the following commands:
```
./mach build
./mach package
# OR
./mach run
2022-02-03 04:57:05 -05:00
```
2022-04-13 09:27:39 -05:00
### Building with this Repository
First, clone this repository with Git:
2022-02-03 04:57:05 -05:00
2022-02-03 04:17:35 -05:00
```
2022-04-13 09:27:39 -05:00
git clone --recursive https://gitlab.com/librewolf-community/browser/source.git librewolf-source
cd librewolf-source
2022-02-03 04:17:35 -05:00
```
2022-04-13 09:27:39 -05:00
Next, build the LibreWolf source code with the following command:
2022-02-03 04:17:35 -05:00
```
2022-04-13 09:27:39 -05:00
make dir
2022-02-03 04:17:35 -05:00
```
2022-04-13 09:27:39 -05:00
After that, you have to bootstrap your system to be able to build LibreWolf. You only have to do this one time. It is done by running the following command:
2022-02-03 04:17:35 -05:00
```
make bootstrap
```
2022-04-13 09:27:39 -05:00
Finally you can build LibreWolf and then package or run it with the following commands:
2022-02-03 04:26:16 -05:00
```
2022-04-13 09:27:39 -05:00
make build
2022-02-03 04:26:16 -05:00
make package
2022-04-13 09:27:39 -05:00
# OR
2022-02-03 04:26:16 -05:00
make run
```
2022-04-13 09:27:39 -05:00
## Development Notes
### How to make a patch
The easiest way to make patches is to go to the LibreWolf source folder:
```
cd librewolf-$(cat version)
git init
git add <path_to_file_you_changed>
git commit -am initial-commit
git diff > ../mypatch.patch
```
We have Gitter / Matrix rooms, and on the website we have links to the various issue trackers.
### How to create a patch for problems in Mozilla's [Bugzilla](https://bugzilla.mozilla.org/).
2022-02-03 05:20:10 -05:00
Well, first of all:
* [Create an account](https://bugzilla.mozilla.org/createaccount.cgi).
* Handy link: [Bugs Filed Today](https://bugzilla.mozilla.org/buglist.cgi?cmdtype=dorem&remaction=run&namedcmd=Bugs%20Filed%20Today&sharer_id=1&list_id=15939480).
* The essential: [Firefox Source Tree Documentation](https://firefox-source-docs.mozilla.org/).
2022-02-03 05:54:09 -05:00
Now that you have a patch in LibreWolf, that's not enough to upload to Mozilla. See, Mozilla only accepts patches against Nightly. So here is how to do that:
2022-04-08 14:24:30 -05:00
If you have not done already, create the `mozilla-unified` folder and build Firefox with it:
2022-02-03 05:20:10 -05:00
```
hg clone https://hg.mozilla.org/mozilla-unified
cd mozilla-unified
hg update
MOZBUILD_STATE_PATH=$HOME/.mozbuild ./mach --no-interactive bootstrap --application-choice=browser
./mach build
./mach run
```
2022-04-08 14:24:30 -05:00
If you skipped the previous step, you could ensure that you're up to date with:
```
cd mozilla-unified
hg pull
hg update
```
2022-02-03 05:20:10 -05:00
Now you can apply your patch to Nightly:
```
patch -p1 -i ../mypatch.patch
```
Now you let Mercurial create the patch:
```
hg diff > ../my-nightly-patch.patch
```
2022-02-03 05:54:09 -05:00
And it can be uploaded to Bugzilla.
2022-02-03 05:25:38 -05:00
2022-02-03 05:32:28 -05:00
##### *(copy of Mozilla readme)* Now the fun starts
2022-02-03 05:25:38 -05:00
Time to start hacking! You should join us on [Matrix](https://chat.mozilla.org/), say hello in the [Introduction channel](https://chat.mozilla.org/#/room/#introduction:mozilla.org), and [find a bug to start working on](https://codetribute.mozilla.org/). See the [Firefox Contributors Quick Reference](https://firefox-source-docs.mozilla.org/contributing/contribution_quickref.html#firefox-contributors-quick-reference) to learn how to test your changes, send patches to Mozilla, update your source code locally, and more.
2022-02-03 06:34:45 -05:00
2022-04-13 09:27:39 -05:00
## Hey, I'm using a Mac or Windows :(
2022-02-28 18:18:27 -05:00
We understand, life isn't always fair 😺. The same steps as above do apply, you'll just have to walk through the beginning part of the guides for [MacOS](https://firefox-source-docs.mozilla.org/setup/macos_build.html), [Windows](https://firefox-source-docs.mozilla.org/setup/windows_build.html). To build on Windows is not very well tested. The cross-compiled Mac .dmg files are also relatively new. It should work, perhaps with the exception of the `make setup-wasi` step. Help testing with these targets is always welcome.