omegafox/README.md
2025-04-21 21:38:23 -07:00

82 lines
2 KiB
Markdown

<img src="https://forge.fsky.io/oneflux/omegafox/raw/branch/main/additions/browser/branding/omegafox/default256.png" align="center">
# Omegafox
General-use browser based on [Camoufox] (https://github.com/daijro/camoufox)
---
## Features
- Reversions of Camoufox defaults for general-purpose use:
- Re-enabled CSS animations
- Removed cursor highlighter
- Re-enabled stock Firefox features that do not make outside connections
- Search engine usage allowed
- etc.
- Security enhancements:
- Improved process isolation
- Weak ciphers and outdated TLS versions disabled by default
- Hardened compilation configuration
- Bundled with [hardened_malloc] (https://github.com/GrapheneOS/hardened_malloc)
- More to come
---
## Building
First, clone this repository with Git:
```bash
git clone --depth 1 https://forge.fsky.io/oneflux/omegafox
cd omegafox
```
Next, build the Omegafox source code with the following command:
```bash
make dir
```
After that, you have to bootstrap your system to be able to build Omegafox. You only have to do this one time. It is done by running the following command:
```bash
make bootstrap
```
Finally you can build and package Omegafox the following command:
```bash
python3 multibuild.py --target linux --arch x86_64 arm64 i686
```
<details>
<summary>
CLI Parameters
</summary>
```bash
Options:
-h, --help show this help message and exit
--target {linux} [{linux} ...]
Target platform to build (Linux only)
--arch {x86_64,arm64,i686} [{x86_64,arm64,i686} ...]
Target architectures to build for each platform
--bootstrap Bootstrap the build system
--clean Clean the build directory before starting
Example:
$ python3 multibuild.py --target linux windows macos --arch x86_64 arm64
```
</details>
---
## Thanks
- [Camoufox] (https://github.com/daijro/camoufox) - For inspiring this project
- [GrapheneOS] (https://github.com/GrapheneOS) - Hardened memory allocator