Thorium_Archive/thorium-mirror
1
0
Fork 0
mirror of https://github.com/Alex313031/thorium.git synced 2025-01-09 19:37:30 -03:00
Code Issues Projects Releases Packages Wiki Activity
thorium-mirror/README.md
Alexander David Frick 90cfb07aa8
Update README.md
2022-05-24 13:48:15 -05:00

10 KiB
Raw Blame History

GitHub tag (latest SemVer)  GitHub  GitHub commit activity  Subreddit subscribers

Thorium

Chromium fork for linux named after radioactive element No. 90. Windows/MacOS/RasPi/Other builds see below. NEW: New builds for different architectures in Thorium-Special!

  • Always built with the latest x64 tip-o-tree "Trunk" build of Chromium.
  • Intended to behave like and have the featureset of Google Chrome, with differences/patches/enhancements listed below.
     – I also build for Windows > https://github.com/Alex313031/Thorium-Win
     – AVX2 Builds for Windows and Linux > https://github.com/Alex313031/Thorium-AVX2 (source files for AVX2 are in that repo.)
     – Special and Experimental builds, sometimes for other CPUs (read the readme), and MacOS/Raspi are located at > https://github.com/Alex313031/Thorium-Special You can find builds for Piledriver/Steamroller/Excavator CPUS, Haswell CPUs, as well as SSE4 builds.
     – NEW: Tigerlake (11th Gen) builds by @midzer
     – NEW: Thorium Special now also has ARM64 and x64 builds for MacOS.
     – NEW: Thorium Special now also has new ARM64 builds for things like the Raspberry Pi.
     – NEW: Thorium Special now also has experimental Android ARM32 & ARM64 builds.

  – Includes Widevine, All Codecs, Chrome Plugins, as well as thinLTO, CFlag, LDFlag, LLVM Loop, and PGO compiler optimizations. It is built with SSE4, AVX, and AES, so it won't launch on CPU's below 2nd gen Core or AMD FX, but benefits from Advanced Vector EXtensions. You can disable this and use regular SSE3 like Chromium and Chrome, or builds from Thorium special, some of which are SSE4. (See below.)

FEATURES & DIFFERENCES BETWEEN CHROMIUM AND THORIUM

  • Various compiler flags that improve performance and target AVX CPU's (read patches.md)
  • Experimental MPEG-DASH.
  • JPEG XL Image File Format support.
  • Enable Live Caption (SODA) on all builds.
  • Experimental PDF annotation support (called "Ink" on ChromiumOS). # DISABLED FOR NOW BECAUSE OF CRASHES.
  • Patches from Debian including font rendering patch, VAAPI Patch, Intel HD support patch, native notifications patch, title bar patch, and... the VDPAU Patch!! (Rejoice Nvidia users)
  • Audio Sandbox patch.
  • DoH (DNS over HTTPS) patches from Bromite.
  • Enable Do Not Track by default patch from Vanadium.
  • Show full URLs including trailing slashes in address bar by default.
  • Disable FLOC patch.
  • Disable annoying Google API Key Infobar warning (you can still use API Keys to enable sync) from Ungoogled Chromium.
  • Disable annoying Default Browser Infobar warning.
  • Adds DuckDuckGo, Ecosia, Ask.com, and Yandex.com in US and other locales, along with the normal search engines.
  • Always use the local NTP (New Tab Page) regardless of search engine.
  • Fix icons when distilling page content in Reader Mode.
  • Enable new Menu UI when right clicking the Reload button. (Adds 'Normal Reload', 'Hard Reload', and 'Clear Cache and Hard Reload')
  • Home button and Chrome Labs shown by Default.
  • Prefetch settings updated to respect privacy.
  • Patches for GN and chrome_sandbox when building.
  • Remove the addition of the Chrome APT sources.list during installation.
  • Widevine CDM Patch for Linux.
  • Enable Parallel Downloading by Default.
  • Inclusion of pak (linux) and pack_mingw (windows), a utility for packing and unpacking the *.pak files in Thorium and any other Chromium based browser.
  • Logo and Branding/Naming changed to the Thorium logo, Thorium name, and "Alex313031" being appended to "The Chromium Authors" in credits, etc.
  • .desktop file includes useful cmdline flags that enable experimental or useful features. (read PATCHES.md)
  • Includes installer patches and files to include ChromeDriver and content_shell, with a .desktop file being provided for content_shell (named thorium-shell.desktop and shows in desktop environments as Thorium Content Shell). You can also run content_shell with the command thorium-shell (custom wrapper for it, located in /usr/bin/). You can run ChromeDriver at /usr/bin/chromedriver. Also, patches for abseil library and mini_installer when building for AVX on Windows.
  • Right clicking the launcher after install gives three additional desktop actions, one to open thorium-shell, another to open in Safe Mode which disables any flags one has set in chrome://flags until the next launch, and lastly to open in Dark Mode which appends the --force-dark-mode flag.
  • For more info, read the PATCHES.md file.
  • Known bugs are in the BUGS.md file.

  – UPDATE: Thorium now has API Keys baked in but the instructions below are the same if you are building it yourself as I will not include the keys here. | args.gn exclude API Keys (you can get them yourself) and the PGO profile path is different for each Chromium version (only needed when building). (See below.)

Building

The scripts assume the Chromium source is at $HOME/chromiums/src/ and Thorium is at $HOME/thorium/. You may have to 'sudo chmod +x' the scripts to make them executable.

  • UPDATE: For Windows and Windows AVX2, I made new dedicated instructions. If you are building on Windows use > https://github.com/Alex313031/Thorium/blob/main/misc/WIN_INSTRUCTIONS.txt and if you are building for Windows on Linux, use > https://github.com/Alex313031/Thorium/blob/main/misc/WIN_CROSS_BUILD_INSTRUCTIONS.txt
  • In general we follow build instructions at https://chromium.googlesource.com/chromium/src/+/refs/heads/main/docs/linux/build_instructions.md and API Keys (if desired) at https://www.chromium.org/developers/how-tos/api-keys
  • Make sure dependencies are installed by running ./chromium/src/build/install-build-deps.sh.
  • After initial download of Chromium source code, run (from where you cloned this repo) ./trunk.sh. This will update and sync the sources and at the end it will download the PGO profile for Chromium for all platforms. The file will be downloaded to //chromium/src/chrome/build/pgo_profiles/*.profdata with the actual file name looking something like 'chrome-linux-main-1632505958-ddbb37bcdfa7dbd7b10cf3a9b6a5bc45e7a958a6.profdata', which should be added to the end of args.gn as per below.
  • Then, (from where you cloned this repo) run ./setup.sh. This will copy all the files and patches to the needed locations and drop you to //chromium/src.
  • Run gn args out/thorium and the contents of 'args.gn' in the root of this repo should be copy/pasted into the editor. Note that for Windows, Mac, ChromiumOS, or Android there are seperate *_args.gn files for those platforms. --Include your api keys here at the top or leave blank, and edit the last line to point to the actual path and file name of '*.profdata'
  • 'infra/args.list' contains an alphabetical list with descriptions of all possible build arguments; gn_args.list gives a similar list but with the flags in args.gn added.
  • To build, run ./build.sh (--help for help). For Windows, use autoninja -C out\thorium chrome chromedriver content_shell setup mini_installer -j8 The -j# can be changed to limit or increase the number of jobs (generally should be the number of CPU cores on your machine)
  • To install, copy/paste the contents of your out/thorium dir to a good location, i.e. $HOME/bin/thorium. RECOMMENDED - Copy and run clean.sh within this dir to clean up build artifacts. Then you can just run the browser with ~/bin/thorium/chrome, the content_shell with ~/bin/thorium/content_shell, or chromedriver with ~/bin/thorium/chromedriver.
  • Proper Install: To install with a .deb, dont copy the contents of out/thorium; instead run
    ./thordeb.sh (--help for help). A nice .deb file will now be in out/thorium and you can install it with sudo dpkg -i *.deb It will be called 'thorium-browser-unstable_$VERSIONNUMBER_amd64.deb', and will be installed to /opt/chromium.org/thorium-unstable/. For Windows, just run the mini_installer.exe.
       NOTE: To get back to "Trunk", i.e. to revert all changes in order to build vanilla Chromium or to update your checkout, just run ./trunk.sh again.
       NOTE: To compile without AVX, simply go to //chromium/src/build/config/compiler/BUILD.gn, search for mavx, and replace mavx with msse3.

https://www.reddit.com/r/ChromiumBrowser/ is a subreddit I made for Thorium and general Chromium discussion and https://alex313031.blogspot.com/ is a blog I made relating to Chromium/ChromiumOS.
I also build ChromiumOS with codecs, widevine, linux-firmware/modules, and added packages at > https://github.com/Alex313031/ChromiumOS/

− Thanks to https://github.com/robrich999/ for some info and fixes that went into this project.
− Thanks to https://github.com/midzer/ for support and helping with builds.
− Also thanks to https://github.com/bromite/bromite, https://github.com/saiarcot895/chromium-ubuntu-build, https://github.com/Eloston/ungoogled-chromium, https://github.com/GrapheneOS/Vanadium, and https://github.com/iridium-browser/iridium-browser for patch code.
− The pak_src dir, and the binaries in pack_src/bin are credited to @freeer https://github.com/myfreeer/chrome-pak-customizer/

   NOTE: libpepflashplayer.so is included for posterity and can be used to enable Adobe Flash on older Chromium releases. ʘ‿ʘ

Thanks for using Thorium!