You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
 
 
 
Go to file
Adam Novak a53a9a55a5 Update all the README URLs for new repo location 4 years ago
.github Create github actions for Continuous Integration! (#116) 4 years ago
app Rebrand README and app strings to Iceraven Browser 4 years ago
automation Simplify build variants to just: debug, nightly, beta and release. 4 years ago
buildSrc Merge remote-tracking branch 'mozilla/master' into fork 4 years ago
certificates Adds certificates to repository 5 years ago
config For #13424 - Fix detekt config and warnings. 4 years ago
docs For #13926 - MP migration 4 years ago
fastlane For #8081 - UI screenshots tests update (#10023) 4 years ago
fork-asset-sources Update wordmark banner for Iceraven branding (#110) 4 years ago
gradle/wrapper For #13262: Update gradle (#13263) 4 years ago
mozilla-detekt-rules Suppress YamlConfig deprecation 4 years ago
mozilla-lint-rules Update mozilla-lint-rules/src/main/java/org/mozilla/fenix/lintrules/TextViewAndroidSrcXmlDetector.kt 4 years ago
taskcluster Fix decision task that does not schedule anything on release builds (#14006) 4 years ago
.adjust_token Fixes #675: Integrate Adjust SDK (for Greenfield flavor) 5 years ago
.cron.yml cron-job-ui-screenshots (#12423) 4 years ago
.editorconfig For #4326 - Updates codebase to support latest version of ktlint 5 years ago
.gitattributes Adds a gitattribute file to manage changelog merges 5 years ago
.gitignore For #12871 - Use local TWA DAL API (#12872) 4 years ago
.taskcluster.yml Bug 1631839 - part 3: Remove "project.mobile" routes (#12821) 4 years ago
.travis.yml Fix the 5 failing tests (#109) 4 years ago
CODE_OF_CONDUCT.md Add Mozilla Code of Conduct file 5 years ago
Gemfile Adding l10n screenshot tests for Fenix (#3562) 5 years ago
Jenkinsfile For #9076 - Upddate pipenv to run without error. (#9077) 4 years ago
LICENSE Fixes #163: Add LICENSE 5 years ago
README.md Update all the README URLs for new repo location 4 years ago
build.gradle Put the (not itself OSS?) license plugin back so we can keep the license screen 4 years ago
codecov.yml No issue: Add threshold to codecov (#4751) 5 years ago
gradle.properties Configure either geckoview beta or nightly at compile-time (#4851) 5 years ago
gradlew For #7483: upgrade gradle to v5.6.4. 4 years ago
gradlew.bat For #7483: upgrade gradle to v5.6.4. 4 years ago
l10n-release.toml Move release locales to a separate config file. 4 years ago
l10n-uplift.py Port l10n uplift script from AC (#14904) 4 years ago
l10n.toml Import l10n. 4 years ago
org.mozilla.fenix_fdroid.yml Add files via upload 4 years ago
settings.gradle Cleanup locall publish flows for application-services 4 years ago
version.txt Bug 1612540 - part 1: Move Fennec Beta to GitHub releases and a to a dedicated hook (#8270) 4 years ago

README.md

Iceraven Browser! Build Status Android build

Definitely not brought to you by Mozilla!

Iceraven Browser is a web browser for Android, based on Mozilla's Fenix version of Firefox, GeckoView and Mozilla Android Components.

Our goal is to be a close fork of the new Firefox for Android that seeks to provide users with more options, more opportunities to customize (including a broad extension library), and more information about the pages they visit and how their browsers are interacting with those pages.

Notable features include:

  • about:config support
  • The ability to attempt to install a much longer list of add-ons than Mozilla's Fenix version of Firefox accepts. Currently the browser queries this AMO collection Most of them will not work, because they depend on code that Mozilla is still working on writing in android-components, but you may attempt to install them. If you don't see an add-on you want, you can request it.
  • No warranties or guarantee of security or updates. Binaries are currently are manually built and are not meaningfully signed. Why should you trust random people on the Internet to provide your web browser, one of the most important pieces of software you use? Iceraven Browser could not exist without the hardworking folks at the Mozilla Corporation who work on the Mozilla Android Components and Firefox projects, but it is not a Mozilla product, and is not provided, endorsed, vetted, approved, or secured by Mozilla.

In addition, we intend to try to cut down on telemetry and proprietary code to as great of an extent as possible as long as doing so does not compromise the user experience or make the fork too hard to maintain. Right now, webelieve that no telemetry should be being sent to Mozilla anymore, but we cannot guarantee this; data may still be sent. If you catch the app sending data to Mozilla, Adjust, Leanplum, Firebase, or any other such service, please open an issue! Presumably data that reaches Mozilla is governed by Mozilla's privacy policy, but as Iceraven Browser is, again not a Mozilla product, we can make no promises.

Iceraven Browser combines the power of Fenix (of which we are a fork) and the spirit of Fennec, with a respectful nod toward the grand tradition of Netscape Navigator, from which all Gecko-based projects came, including the earliest of our predecessors, the old Mozilla Phoenix and Mozilla Firefox desktop browsers.

That said, Iceraven Browser is an independent all-volunteer project, and has no affiliation with Netscape, Netscape Navigator, Mozilla, Mozilla Firefox, Mozila Phoenix, Debian, Debian Iceraven, Parabola GNU/Linux-libre Iceraven, America Online, or Verizon, among others. :) Basically, if you don't like the browser, it's not their fault. :)

Installation

Download APKs from the Releases Page

Building

  1. Set up the environment. We need the Android SDK at $ANDROID_SDK_ROOT and a Java JDK at $JAVA_HOME that isn't the Ubuntu Java 8 one. We want environment variables that look something like:
# Where does our system install the JDK? This is the right path for the Ubuntu Java 11 JDK, if it is installed.
export JAVA_HOME=/usr/lib/jvm/java-11-openjdk-amd64
# Where did we install the Android SDK?
export ANDROID_SDK_ROOT=$HOME/android-sdk/android-sdk-linux/

If we don't have the Android SDK, we can install it thusly on Linux:

mkdir -p $HOME/android-sdk/android-sdk-linux
cd $HOME/android-sdk/android-sdk-linux
mkdir -p licenses
echo "8933bad161af4178b1185d1a37fbf41ea5269c55" >> licenses/android-sdk-license
echo "d56f5187479451eabf01fb78af6dfcb131a6481e" >> licenses/android-sdk-license
echo "24333f8a63b6825ea9c5514f83c2829b004d1fee" >> licenses/android-sdk-license
mkdir cmdline-tools
cd cmdline-tools
wget "$(curl -s https://developer.android.com/studio | grep -oP "https://dl.google.com/android/repository/commandlinetools-linux-[0-9]+_latest.zip")"
unzip commandlinetools-linux-*_latest.zip
cd ..
  1. Clone the project.
git clone https://github.com/fork-maintainers/iceraven-browser
  1. Go inside iceraven-browser. That's where the build is coordinated from.
cd iceraven-browser
  1. Configure the project. We need to set the release builds to be signed with the debug key, because proper code signing isn't set up yet and the completely unsigned APKs that are produced by default cannot be installed.
echo "autosignReleaseWithDebugKey=" >>local.properties
  1. Build the project. To build the Iceraven-branded release APKs, you can do:
./gradlew assembleForkRelease -PversionName="$(git describe --tags HEAD)"

The APKs will show up in app/build/outputs/apk/forkRelease/.

Getting Involved

This is an all-volunteer project. No one is getting paid (at least not by the project itself.).

Therefore, everyone should feel free to open issues and pull requests. Join the club!

Developers are especially welcome, wanted, and needed.

I want to open a Pull Request!

We encourage you to participate in this open source project. We love Pull Requests, Bug Reports, ideas, (security) code reviews or any other kind of positive contribution.

I want to file an issue!

Great! We encourage you to participate in this open source project. We love Pull Requests, Bug Reports, ideas, (security) code reviews or any other kind of positive contribution.

To make it easier to triage, we have these issue requirements:

  • Please do your best to search for duplicate issues before filing a new issue so we can keep our issue board clean.
  • Every issue should have exactly one bug/feature request described in it. Please do not file meta feedback list tickets as it is difficult to parse them and address their individual points.
  • Feature Requests are better when theyre open-ended instead of demanding a specific solution -ie “I want an easier way to do X” instead of “add Y”
  • Issues are not the place to go off topic or debate.
  • While we do not yet have Community Participation Guidelines of our own, we ask that you show respect to everyone and treat others as you would like to be treated. Behavior that would violate Mozilla's Community Participation Guidelines is almost certainly unwelcome. However, as a small project without community managers, we cannot promise prompt and consistent enforcement.

Please keep in mind that even though a feature you have in mind may seem like a small ask, as a small team, we have to prioritize our planned work and every new feature adds complexity and maintenance and may take up design, research, product, and engineering time. We appreciate everyones passion but we will not be able to incorporate every feature request or even fix every bug. That being said, just because we haven't replied, doesn't mean we don't care about the issue, please be patient with our response times as we're very busy.

This Source Code Form is subject to the terms of the Mozilla Public
License, v. 2.0. If a copy of the MPL was not distributed with this
file, You can obtain one at http://mozilla.org/MPL/2.0/