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 https://iridiumbrowser.de/ .
The repository is at git://git.iridiumbrowser.de/iridium-browser and https://github.com/iridium-browser/iridium-browser/ .
To build from source, it is advised 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 https://dl.iridiumbrowser.de/source/ .
Be aware there are different types of source code collections:
- The "chromium-git state" where one needs to run gclient to download additional sourc code.
- The "tarball state" where we imported the source code from https://commondatastorage.googleapis.com/chromium-browser-official/ into Git. This has all source present.
The current Git branch you are looking at and reading this README.rst from is in the tarball state.
Reporting bugs and issues
Use the Iridium Browser issue tracker on GitHub to report your findings.
Build steps for chromium-git state
The following is a collection of steps, saved here primarily as a note for ourselves. When starting off with the chromium-git state, the following preparatory steps may be needed:
- Download depot_tools and add it to your
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.
Download WebRTC if gclient did not do it for you. Google populates the Chromium
DEPSfile with a commit hash for WebRTC, and if there is no branch head which is exactly equal to the hash,
gclient syncbarfs 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
Undo the PATH change from 1, since depot_tools ships an untrusted copy of ninja.
From here on, steps apply to both source builds of any kind, that is, chromium-git or tarball state.
Steps for tarball state
The gn files in Iridium are edited to respect the
$CCetc. environment variables. These env vars _must_ always be set, so issue
export CC=gcc CXX=g++ AR=ar NM=nm
export CC=clang CXX=clang++ AR=llvm-ar NM=llvm-nm
(can pick any preferred toolchain, though).
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/
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 gtk_version=4 use_system_harfbuzz=true use_system_freetype=true use_system_libwayland=true use_system_libwayland_server=true use_system_wayland_scanner=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
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.
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 chromiumto do that in a single shot. On Debian, there is something like
Execute this to build:
export PATH="$PATH:/usr/lib64/qt5/bin" LD_LIBRARY_PATH=$PWD/out ninja -C out chrome chromedriver
Because chromium is too ignorant to look for moc on its own, the patch to it needs to be manually specified.
The just-built executable can be run thus
cd out; LD_LIBRARY_PATH=$PWD ./chromium
There is no "install" target. Thanks, Google. Every distro has to roll their own install procedure. For example,
This is why it was mentioned in one of the previous sections that you will have to re-use/leverage/adapt the chromium build recipe that your distro had.