Welcome to Floorp Browser GitHub Repository 👋

Floorp Browser

A Browser build for keeping the Open, Private and Sustainable Web alive. Based on Mozilla Firefox.

Official Site ・ Download ・ Blog & Release Notes ・ Official Support Site & Send feedback

⚡ Get Started

💻 Supoorted Operating Systems & Requirements

Floorp Browser is available for Windows, macOS and Linux. You can install it by running the installer or by extracting the archive.

Windows

• Windows 10 or later. (Windows 7 and 8 are not supported)

• x86_64 CPU architecture. AArch64 are not supported.

macOS

• macOS 10.12 or later.

• x86_64 CPU & ARM64 CPU architecture. Floorp provides a Universal build for both architectures.

Note: Floorp Browser is not signed for macOS. because of this, you will need to allow Floorp to run in your Security & Privacy settings.

Linux

• Debian-based distributions (Ubuntu, Linux Mint, etc.) & Arch-based distributions (Manjaro, etc.) are supported.

• x86_64 & AAarch64 CPU architecture.

• Floorp needs package or library see: "Firefox Linux Requirements"

• List of Package manager are supported

1. PPA (Ubuntu, Linux Mint, etc.)       "https://ppa.ablaze.one"

2. Flatpak (All Linux Distributions)    "https://flathub.org/apps/one.ablaze.floorp"

3. tarball (All Linux Distributions)    "https://GitHub.com/Floorp-Projects/Floorp/releases/latest"

4. AUR (Arch-based distributions)        "https://aur.archlinux.org/packages/floorp/" **Unofficial**

📥 Download & 📦 Install

You can download the latest version of Floorp Browser from the official website: Floorp.app ...or from the GitHub Releases page.

If you are using Linux, please show the Linux section.

---

📖 Documentation

📝 License

Mozilla Public License 2.0

• Floorp's name is a registered trademark of Floorp's developer. & Floorp's logo is protected by Copyright.

• Floorp Browser is based on Mozilla Firefox. Floorp Browser is not affiliated with Mozilla & Mozilla Firefox.

📧 Contact

• Official Support Site

• Official Floorp Twitter or Official Ablaze Twitter

• Official Ablaze Community Discord Server

📜 Privacy Policy

• Ablaze Privacy Policy

• Floorp Privacy Policy

---

🌟 Contributing

🧰 Writing Code

• We welcome contributions from everyone. First of all, you need to fork this repository and clone it to your local machine.

• You can use any IDE or text editor you want. We recommend using Visual Studio Code.

• We use "JavaScript", "XHTML" & "CSS" for writing code. If you want to know about these languages, please see the following links.

  • JavaScript

  • XHTML

  • CSS

• Firefox uses legacy technologies. Mozilla call it "XUL". If you want to know about XUL, please see the following links.

  • XUL

• If you want to know about Floorp's code, please see the following links.

  • Firefox Source Docs

  • Firefox Source Code

  • Searchfox

• If you want to build Floorp Browser, please see the Building section.

📝 Translating

• We want to support as many languages as possible. If you want to translate Floorp Browser, please clone this repository.

• Floorp l10n-Central

• Floorp's language files is located in the browser/browser/floorp.ftl only.

• English is the source language. If you want to translate Floorp Browser, please translate from English (en-US)

• Floorp's English file is here: floorp.ftl

🐛 Reporting Bugs

• If you find a bug, please report it to the Issues page. or... you can report it to the Official Support Site.

---

🗜️ Building

📦 Requirements

• Windows:

  • Mozilla Build Shell
  • git

• macOS:

  • Xcode
  • git

• Linux:

  • git
  • curl sudo apt install curl
  • python3 sudo apt install python3
  • pip3 sudo apt install python3-pip
  • Mercurial python3 -m pip install --user mercurial

🧨 Bootstrap, Build & run

• Windows (on Mozilla Build Shell: C:\mozilla-build\start-shell.bat)
• macOS & Linux (on Terminal)

$ cd /path/to/your/Floorp/repository

**set mozconfig**
$ echo 'ac_add_options --with-app-name=floorp' >> mozconfig
$ echo 'ac_add_options --with-app-basename=Floorp' >> mozconfig
$ echo 'ac_add_options --with-branding=browser/branding/official' >> mozconfig


** Bootstrap Source code**
$ ./mach bootstrap

** Build Floorp Browser **
$ ./mach build

** Run Floorp Browser **
$ ./mach run