Skip to content
Switch branches/tags
This branch is up to date with master.

Latest commit

Prefix URLs to Google services with trk: so that whenever something
tries to load them, the developer will be informed via printf and
dialog (extra info bar between URLbar and content window) about this.

If you see such dialog, we know that (a) either the URL needs to be
whitelisted, or (b) the feature that triggered it needs to be disabled
by default.


Failed to load latest commit information.
Latest commit message
Commit time

Iridium Browser

Iridium is an open modification of the Chromium code base, with privacy being enhanced in several key areas. Automatic transmission of partial queries, keywords, metrics to central services is inhibited and only occurs with consent.

Some more information and binary downloads can be found at .


The repository is at git:// and .

The easy way to build from source is to re-use the mechanisms of one's Linux distribution, that is, their build environment and description for chromium, and replacing the source tarball by the one from .

Reporting bugs and issues

Use the Iridium Browser issue tracker on GitHub to report your findings.

Build steps

The following is a collection of steps, saved here primarily as a note for ourselves. When starting off with the Git repository, the following preparatory steps may be needed:

  1. Download depot_tools and add it to your $PATH environment variable.
  1. Issue command: gclient sync (this utility comes from depot_tools). For gclient, you need to have python 2(!) and python2-virtualenv. The sync command will not necessary complete successfully due to webrtc.

  2. Download WebRTC if gclient did not do it for you. Google populates the Chromium DEPS file with a commit hash for WebRTC, and if there is no branch head which is exactly equal to the hash, gclient sync barfs about it. Then, you have to fetch the data manually:

    ` pushd third_party/webrtc/ git ls-remote origin | grep 0b2302e5e0418b6716fbc0b3927874fd3a842caf abcdef... refs/branch-heads/m78 git fetch origin refs/branch-heads/m78 git reset --hard FETCH_HEAD popd `

  3. Undo the PATH change from 1, since depot_tools ships an untrusted copy of ninja.

From here on, steps apply to source builds of any kind:

  1. The gn files in Iridium are edited to respect the $CC etc. environment variables. These env vars _must_ always be set, so issue export CC=gcc CXX=g++ AR=ar NM=nm or export CC=clang CXX=clang++ AR=llvm-ar NM=llvm-nm (can pick any preferred toolchain, though).

  2. Link up nodejs:

    ` mkdir -p third_party/node/linux/node-linux-x64/bin ln -s /usr/bin/node third_party/node/linux/node-linux-x64/bin/ `

  3. Because chromium is too stupid to use pkg-config for wayland and xkbcommon, it needs to be manually specified. Issue

    ` export CFLAGS="-O2 -Wall $(pkg-config wayland-client xkbcommon --cflags)" export CXXFLAGS="$CFLAGS" gn gen '--args= custom_toolchain="//build/toolchain/linux/unbundle:default" host_toolchain="//build/toolchain/linux/unbundle:default" use_custom_libcxx=false host_cpu="x64" host_os="linux" is_debug=false dcheck_always_on=false enable_nacl=false use_swiftshader_with_subzero=true is_component_ffmpeg=true use_cups=true use_aura=true symbol_level=1 blink_symbol_level=0 use_kerberos=true enable_vr=false optimize_webui=false enable_reading_list=false use_pulseaudio=true link_pulseaudio=true is_component_build=false use_sysroot=false fatal_linker_warnings=false use_allocator="partition" use_allocator_shim=true use_partition_alloc=true disable_fieldtrial_testing_config=true use_gnome_keyring=false use_unofficial_version_number=false use_vaapi=true use_sysroot=false treat_warnings_as_errors=false enable_widevine=false use_dbus=true media_use_openh264=false rtc_use_h264=false use_v8_context_snapshot=true v8_use_external_startup_data=true use_system_harfbuzz=true enable_hangout_services_extension=true enable_vulkan=true rtc_use_pipewire=true rtc_link_pipewire=true is_clang=true clang_base_path="/usr" clang_use_chrome_plugins=false use_thin_lto=true use_lld=true icu_use_data_file=false proprietary_codecs=true ffmpeg_branding="Chrome"' out/Release `

    Note that gn embodies the environment variables' values (CC, CFLAGS, etc.) into Makefiles, so upon change of any of those variables, gn needs to be re-run.

  4. There are a number of dependencies, and they may vary across operating systems. The gn command fails if there are unmet dependencies, and it will tell you which. Install and repeat the gn command as needed. Consult your distribution's package manager. On openSUSE, it is possible to use zypper si -d chromium to do that in a single shot.

  5. Issue LD_LIBRARY_PATH=$PWD/out/Release ninja -C out/Release chrome chromedriver.


Iridium Browser source code



Code of conduct


No packages published