diff --git a/CODE_OF_CONDUCT.md b/CODE_OF_CONDUCT.md index 88262a1b..a1f03167 100644 --- a/CODE_OF_CONDUCT.md +++ b/CODE_OF_CONDUCT.md @@ -1,6 +1,6 @@ -# Thorium Code of Conduct +# Thorium Code of Conduct - + The Thorium Authors and the Chromium team are committed to preserving and fostering a diverse, welcoming community. Below is our community code of conduct, which diff --git a/README.md b/README.md index 26d87a51..0c8899e0 100644 --- a/README.md +++ b/README.md @@ -1,14 +1,14 @@ ![GitHub tag (latest SemVer)](https://img.shields.io/github/v/tag/alex313031/thorium?label=Version%3A)  ![GitHub](https://img.shields.io/github/license/alex313031/thorium?color=green&label=License%3A)  ![GitHub commit activity](https://img.shields.io/github/commit-activity/w/alex313031/thorium?color=blueviolet&label=Commit%20Activity%3A)  ![Subreddit subscribers](https://img.shields.io/reddit/subreddit-subscribers/ChromiumBrowser?style=social) # Thorium - + ## Chromium fork for linux named after [radioactive element No. 90](https://en.wikipedia.org/wiki/Thorium). Windows/MacOS/RasPi/Android/Other builds see below. - Always built with the latest stable version of [Chromium](https://www.chromium.org/). - Intended to behave like and have the featureset of Google Chrome, with differences/patches/enhancements listed below. - Includes [Widevine](https://www.widevine.com/), [All Codecs](https://tools.woolyss.com/html5-audio-video-tester/), Chrome Plugins, as well as thinLTO, CFlag, LDFlag, LLVM Loop, and PGO compiler optimizations. It is built with [SSE4](https://en.wikipedia.org/wiki/SSE4), [AVX](https://en.wikipedia.org/wiki/Advanced_Vector_Extensions), and [AES](https://en.wikipedia.org/wiki/AES_instruction_set), so it won't launch on CPU's below 2nd gen Core or AMD FX, but benefits from Advanced Vector EXtensions. If your CPU lacks AVX, you can use builds from [Thorium Special](https://github.com/Alex313031/Thorium-Special). -### Other Builds             +### Other Builds              – Windows builds are here > [Thorium Win](https://github.com/Alex313031/Thorium-Win) \  – AVX2 Builds for Windows and Linux > [Thorium AVX2](https://github.com/Alex313031/Thorium-AVX2) \  – MacOS (M1 and X64) builds are located at > [Thorium Mac](https://github.com/Alex313031/Thorium-Mac) \ @@ -18,8 +18,8 @@  – Thorium Website with deb repo for auto-updating on Linux > https://thorium.rocks/ \  – __NEW__: Windows 7 / 8 / 8.1 / Server 2012 builds in > [Thorium Win7](https://github.com/Alex313031/thorium-win7) -### FEATURES & DIFFERENCES BETWEEN CHROMIUM AND THORIUM -> - Various compiler flags that improve performance and target [AVX](https://en.wikipedia.org/wiki/Advanced_Vector_Extensions) CPU's (read [PATCHES.md](https://github.com/Alex313031/Thorium/blob/main/infra/PATCHES.md)) +### FEATURES & DIFFERENCES BETWEEN CHROMIUM AND THORIUM +> - Various compiler flags that improve performance and target [AVX](https://en.wikipedia.org/wiki/Advanced_Vector_Extensions) CPU's (read [PATCHES.md](https://github.com/Alex313031/thorium/blob/main/infra/PATCHES.md)) > - Experimental [MPEG-DASH](https://en.wikipedia.org/wiki/Dynamic_Adaptive_Streaming_over_HTTP) support. > - HEVC/H.265 support on Linux and Windows. > - [JPEG XL](https://jpeg.org/jpegxl/) Image File Format turned on by default. @@ -44,22 +44,22 @@ > - Remove the addition of the Chrome APT sources.list during installation. > - Widevine CDM Patch for Linux. > - GTK auto dark mode patch -> - Various new flags either developed from scratch, or added from Ungoogled Chromium. See [PATCHES.md](https://github.com/Alex313031/Thorium/blob/main/infra/PATCHES.md) +> - Various new flags either developed from scratch, or added from Ungoogled Chromium. See [PATCHES.md](https://github.com/Alex313031/thorium/blob/main/infra/PATCHES.md) > - Enable Parallel Downloading by Default. -> - Inclusion of [pak](https://github.com/Alex313031/Thorium/tree/main/pak_src#readme) (Linux) and [pak_mingw](https://github.com/Alex313031/Thorium/tree/main/pak_src/bin/pak-win) (Windows), a utility for packing and unpacking the [*.pak](https://textslashplain.com/2022/05/03/chromium-internals-pak-files/) files in Thorium or any other Chromium based browser. +> - Inclusion of [pak](https://github.com/Alex313031/thorium/tree/main/pak_src#readme) (Linux) and [pak_mingw](https://github.com/Alex313031/thorium/tree/main/pak_src/bin/pak-win) (Windows), a utility for packing and unpacking the [*.pak](https://textslashplain.com/2022/05/03/chromium-internals-pak-files/) files in Thorium or 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. (See [PATCHES.md](https://github.com/Alex313031/Thorium/blob/main/infra/PATCHES.md)) +> - .desktop file includes useful cmdline flags that enable experimental or useful features. (See [PATCHES.md](https://github.com/Alex313031/thorium/blob/main/infra/PATCHES.md)) > - Includes installer patches and files to include [ChromeDriver](https://chromedriver.chromium.org/home) and *thorium_shell* [(content_shell)](https://chromium.googlesource.com/chromium/src/+/HEAD/docs/testing/web_tests_in_content_shell.md), with a .desktop file being provided for thorium_shell (named thorium-shell.desktop and shows in desktop environments as Thorium Content Shell). These are also included in the Windows releases, but it doesn't make a shorcut, although a .png and .ico is in the install directory for you to make your own shortcut with an icon. 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 or chromedriver.exe on Windows. Also, patches for abseil library and mini_installer when building with 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](https://github.com/Alex313031/Thorium/blob/main/infra/PATCHES.md) file. -- Known bugs are in the [BUGS.md](https://github.com/Alex313031/Thorium/blob/main/infra/BUGS.md) file. +- For more info, read the [PATCHES.md](https://github.com/Alex313031/thorium/blob/main/infra/PATCHES.md) file. +- Known bugs are in the [BUGS.md](https://github.com/Alex313031/thorium/blob/main/infra/BUGS.md) file. - A list of Chromium command line flags can be found at > https://peter.sh/experiments/chromium-command-line-switches -## Building -See > https://github.com/Alex313031/Thorium/blob/main/docs/BUILDING.md +## Building +See > https://github.com/Alex313031/thorium/blob/main/docs/BUILDING.md -## Debugging -See > https://github.com/Alex313031/Thorium/tree/main/infra/DEBUG#readme +## Debugging +See > https://github.com/Alex313031/thorium/tree/main/infra/DEBUG#readme -------  − https://www.reddit.com/r/ChromiumBrowser/ is a subreddit I made for Thorium and general Thorium/Chromium discussion, https://thorium.rocks/ is the website I made for it, and https://alex313031.blogspot.com/ is a blog I made relating to Thorium/ThoriumOS. \ @@ -70,10 +70,10 @@ See > https://github.com/Alex313031/Thorium/tree/main/infra/DEBUG#readme  − 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*](https://github.com/Alex313031/Thorium/blob/main/infra/libpepflashplayer.so) is included for posterity and can be used to enable Adobe Flash on older Chromium releases. ʘ‿ʘ +   __NOTE:__ [*libpepflashplayer.so*](https://github.com/Alex313031/thorium/blob/main/infra/libpepflashplayer.so) is included for posterity and can be used to enable Adobe Flash on older Chromium releases. ʘ‿ʘ *Thanks for using Thorium!* - + - + diff --git a/arm/README.md b/arm/README.md index d3273052..b93a1195 100644 --- a/arm/README.md +++ b/arm/README.md @@ -1,10 +1,10 @@ -## Thorium for ARM CPUs -This contains a special [*BUILD.gn*](https://github.com/Alex313031/Thorium/blob/main/arm/config/compiler/BUILD.gn) file for making an ARM32/ARM64 build of Thorium for Raspberry Pi or Windows. Just run `setup_arm.sh` in here after running the normal `setup.sh` that's in the root of this repo. +## Thorium for ARM CPUs +This contains a special [*BUILD.gn*](https://github.com/Alex313031/thorium/blob/main/arm/config/compiler/BUILD.gn) file for making an ARM32/ARM64 build of Thorium for Raspberry Pi or Windows. Just run `setup_arm.sh` in here after running the normal `setup.sh` that's in the root of this repo. __NOTE:__ This dir is only for Raspberry Pi and Windows On ARM. For regular Linux ARM builds, and MacOS ARM builds, you can just use the regular files in the repo. - - Windows On ARM (WoA) Builds: Use the [win_ARM_args.gn](https://github.com/Alex313031/Thorium/blob/main/arm/win_ARM_args.gn) file for your *args.gn*. + - Windows On ARM (WoA) Builds: Use the [win_ARM_args.gn](https://github.com/Alex313031/thorium/blob/main/arm/win_ARM_args.gn) file for your *args.gn*. -## Raspberry Pi Builds   -__IMPORTANT:__ For a [Raspberry Pi](https://www.raspberrypi.org/) build (ARM64), the contents of [raspi_arm.gni](https://github.com/Alex313031/Thorium/blob/main/arm/raspi_arm.gni) should be manually copied and used in *//chromium/src/build/config/arm.gni*, AND the contents of [raspi_args.gn](https://github.com/Alex313031/Thorium/blob/main/arm/raspi_args.gn) should be used for your *args.gn*. \ +## Raspberry Pi Builds   +__IMPORTANT:__ For a [Raspberry Pi](https://www.raspberrypi.org/) build (ARM64), the contents of [raspi_arm.gni](https://github.com/Alex313031/thorium/blob/main/arm/raspi_arm.gni) should be manually copied and used in *//chromium/src/build/config/arm.gni*, AND the contents of [raspi_args.gn](https://github.com/Alex313031/thorium/blob/main/arm/raspi_args.gn) should be used for your *args.gn*. \ __– Note that ARM32 Raspberry Pi builds of Thorium are not supported.__ They should only be used on Raspi 3B, 3B+, 4, and 400 models with a 64 Bit OS. For more info, see > [Here](https://www.raspberrypi.com/news/raspberry-pi-os-64-bit/). diff --git a/docs/WIN_CROSS_BUILD_INSTRUCTIONS.txt b/docs/WIN_CROSS_BUILD_INSTRUCTIONS.txt index 52c2bf49..744856dd 100644 --- a/docs/WIN_CROSS_BUILD_INSTRUCTIONS.txt +++ b/docs/WIN_CROSS_BUILD_INSTRUCTIONS.txt @@ -60,9 +60,9 @@ And place it in ~/chromium/win Now, lets download the Thorium tree, so run (in $HOME) -git clone --recursive https://github.com/Alex313031/Thorium.git OR +git clone --recursive https://github.com/Alex313031/thorium.git OR -Download the latest .zip > https://github.com/Alex313031/Thorium/archive/refs/heads/main.zip +Download the latest .zip > https://github.com/Alex313031/thorium/archive/refs/heads/main.zip Then cd ~/Thorium, and we need to make some files executable. So run diff --git a/docs/WIN_INSTRUCTIONS.txt b/docs/WIN_INSTRUCTIONS.txt index 641428b7..96a343ef 100644 --- a/docs/WIN_INSTRUCTIONS.txt +++ b/docs/WIN_INSTRUCTIONS.txt @@ -71,7 +71,7 @@ Good, now we have a full Chromium checkout ready to be built, but to turn it int ## Thorium Setup So, lets download Thorium in C:\src -git clone --recursive https://github.com/Alex313031/Thorium.git or download the .zip and unpack it there > https://github.com/Alex313031/Thorium/archive/refs/heads/main.zip +git clone --recursive https://github.com/Alex313031/thorium.git or download the .zip and unpack it there > https://github.com/Alex313031/Thorium/archive/refs/heads/main.zip Now, go back to C:\chromium\src diff --git a/infra/APPIMAGE/README.md b/infra/APPIMAGE/README.md index 9c013f7c..f385a0e1 100644 --- a/infra/APPIMAGE/README.md +++ b/infra/APPIMAGE/README.md @@ -14,6 +14,6 @@ You can use it standalone, after making it executable with `sudo chmod +x Thoriu - *See also:* [About AppImages](https://appimage.org/) -### About +### About – This infra project uses [*pkg2appimage*](https://github.com/AppImage/pkg2appimage/blob/master/pkg2appimage) from here > https://github.com/AppImage/pkg2appimage \ -– The [*Thorium.yml*](https://github.com/Alex313031/Thorium/blob/main/infra/APPIMAGE/Thorium.yml) file was modeled after the official Chromium one from here > https://github.com/AppImage/pkg2appimage/blob/master/recipes/Chromium.yml +– The [*Thorium.yml*](https://github.com/Alex313031/thorium/blob/main/infra/APPIMAGE/Thorium.yml) file was modeled after the official Chromium one from here > https://github.com/AppImage/pkg2appimage/blob/master/recipes/Chromium.yml diff --git a/infra/APPIMAGE/Thorium.yml b/infra/APPIMAGE/Thorium.yml index a756ea76..3ae581f6 100644 --- a/infra/APPIMAGE/Thorium.yml +++ b/infra/APPIMAGE/Thorium.yml @@ -1,5 +1,5 @@ # Copyright (c) 2023 Alex313031 -# Official Thorium builds can be downloaded from https://github.com/Alex313031/Thorium/releases +# Official Thorium builds can be downloaded from https://github.com/Alex313031/thorium/releases app: Thorium appId: "org.chromium.Thorium" diff --git a/infra/Arch_Linux/.SRCINFO b/infra/Arch_Linux/.SRCINFO index f7178665..37b907dd 100644 --- a/infra/Arch_Linux/.SRCINFO +++ b/infra/Arch_Linux/.SRCINFO @@ -2,7 +2,7 @@ pkgbase = thorium-browser-bin pkgdesc = Chromium fork focused on high performance and security. pkgver = 111.0.5563.111 pkgrel = 2 - url = https://github.com/Alex313031/Thorium + url = https://github.com/Alex313031/thorium install = thorium-browser.install arch = x86_64 license = GPLv3 @@ -20,7 +20,7 @@ pkgbase = thorium-browser-bin optdepends = kwallet: for storing passwords in KWallet options = !emptydirs options = !strip - source = https://github.com/Alex313031/Thorium/releases/download/M111.0.5563.111/thorium-browser_111.0.5563.111-1_amd64.deb + source = https://github.com/Alex313031/thorium/releases/download/M111.0.5563.111/thorium-browser_111.0.5563.111-1_amd64.deb source = thorium-browser.sh sha512sums = b91554cc990241ed632c4a4abb14181b1598018716794ccf251d6baf77bca691722558cdcdbc5f88087ceb356a6cdfbf9095038189ecb7fa0777975a1ae13b4f sha512sums = 91a532fde9e6e87d65b909a170d32808f1c05367104cdaab07043fef0de66bdfc307a4138584cd1eedc169a03207372df39c09268ab1ec741432e79e0dcc2dfb diff --git a/infra/Arch_Linux/PKGBUILD b/infra/Arch_Linux/PKGBUILD index dd7191e0..16984695 100644 --- a/infra/Arch_Linux/PKGBUILD +++ b/infra/Arch_Linux/PKGBUILD @@ -8,7 +8,7 @@ pkgver=111.0.5563.111 pkgrel=2 pkgdesc="Chromium fork focused on high performance and security." arch=('x86_64') -url="https://github.com/Alex313031/Thorium" +url="https://github.com/Alex313031/thorium" license=('GPLv3') depends=( 'alsa-lib' @@ -28,7 +28,7 @@ optdepends=( ) options=('!emptydirs' '!strip') install=$_pkgname.install -source=("https://github.com/Alex313031/Thorium/releases/download/M${pkgver}/${_pkgname}_${pkgver}-1_amd64.deb" +source=("https://github.com/Alex313031/thorium/releases/download/M${pkgver}/${_pkgname}_${pkgver}-1_amd64.deb" "$_pkgname.sh") sha512sums=('b91554cc990241ed632c4a4abb14181b1598018716794ccf251d6baf77bca691722558cdcdbc5f88087ceb356a6cdfbf9095038189ecb7fa0777975a1ae13b4f' '91a532fde9e6e87d65b909a170d32808f1c05367104cdaab07043fef0de66bdfc307a4138584cd1eedc169a03207372df39c09268ab1ec741432e79e0dcc2dfb') diff --git a/infra/BUGS.md b/infra/BUGS.md index ee626e3b..0189c077 100644 --- a/infra/BUGS.md +++ b/infra/BUGS.md @@ -1,6 +1,6 @@ -## BUGS.md +## BUGS.md - + ## Document listing known bugs in Thorium or Chromium that will affect usability. Fixed bugs will have a FIXED tag with the date it was fixed at the end. Discoverers/Fixers will have their name at the end. **2021** diff --git a/infra/BUILDING_OLD.md b/infra/BUILDING_OLD.md index 4ab8c3e3..cf0f8aa3 100644 --- a/infra/BUILDING_OLD.md +++ b/infra/BUILDING_OLD.md @@ -1,20 +1,20 @@ > __*NOTE: This document is out of date, and kept for historical purposes only. You should follow the docs located [HERE](https://github.com/Alex313031/thorium/tree/main/docs#readme)*__ -## Building +## 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](https://en.wikipedia.org/wiki/Advanced_Vector_Extensions#Advanced_Vector_Extensions_2), I made new dedicated instructions. If you are building on Windows use > [WIN_INSTRUCTIONS.txt](https://github.com/Alex313031/Thorium/blob/main/misc/WIN_INSTRUCTIONS.txt) and if you are building for Windows on Linux, use > [WIN_CROSS_BUILD_INSTRUCTIONS.txt](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 +- __UPDATE:__ For Windows and Windows [AVX2](https://en.wikipedia.org/wiki/Advanced_Vector_Extensions#Advanced_Vector_Extensions_2), I made new dedicated instructions. If you are building on Windows use > [WIN_INSTRUCTIONS.txt](https://github.com/Alex313031/thorium/blob/main/misc/WIN_INSTRUCTIONS.txt) and if you are building for Windows on Linux, use > [WIN_CROSS_BUILD_INSTRUCTIONS.txt](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](https://github.com/Alex313031/Thorium/blob/main/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'* -- For more info about args.gn, read the [ABOUT_GN_ARGS.md](https://github.com/Alex313031/Thorium/blob/main/infra/DEBUG/ABOUT_GN_ARGS.md) file. -- '[infra/args.list](https://github.com/Alex313031/Thorium/blob/main/infra/args.list)' contains an alphabetical list with descriptions of all possible build arguments; [gn_args.list](https://github.com/Alex313031/Thorium/blob/main/infra/gn_args.list) gives a similar list but with the flags in args.gn added. +- Run `gn args out/thorium` and the contents of '[args.gn](https://github.com/Alex313031/thorium/blob/main/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'* +- For more info about args.gn, read the [ABOUT_GN_ARGS.md](https://github.com/Alex313031/thorium/blob/main/infra/DEBUG/ABOUT_GN_ARGS.md) file. +- '[infra/args.list](https://github.com/Alex313031/thorium/blob/main/infra/args.list)' contains an alphabetical list with descriptions of all possible build arguments; [gn_args.list](https://github.com/Alex313031/thorium/blob/main/infra/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 `build_win.sh` or `autoninja -C out\thorium chrome chromedriver thorium_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](https://github.com/Alex313031/Thorium/blob/main/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/thorium_shell`, or chromedriver with `~/bin/thorium/chromedriver`. +- 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](https://github.com/Alex313031/thorium/blob/main/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/thorium_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-stable_$VERSIONNUMBER_amd64.deb', and will be installed to */opt/chromium.org/thorium/*. For Windows, just run the mini_installer.exe. \ -- **Appimage:** You can also make an [Appimage](https://appimage.org/) of Thorium after making the .deb. See > [Appimage README.md](https://github.com/Alex313031/Thorium/tree/main/infra/APPIMAGE#readme) +- **Appimage:** You can also make an [Appimage](https://appimage.org/) of Thorium after making the .deb. See > [Appimage README.md](https://github.com/Alex313031/thorium/tree/main/infra/APPIMAGE#readme)    __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 *avx*, and replace *avx* with *sse3* or *sse4*. \ @@ -22,4 +22,4 @@ _**The scripts assume the Chromium source is at $HOME/chromiums/src/ and Thorium *Happy Thorium Building!* - + diff --git a/infra/DEBUG/DEBUG_SHELL_README.md b/infra/DEBUG/DEBUG_SHELL_README.md index f37ecfec..a4521a31 100644 --- a/infra/DEBUG/DEBUG_SHELL_README.md +++ b/infra/DEBUG/DEBUG_SHELL_README.md @@ -23,7 +23,7 @@ These files are in: *More info can be found at > https://chromium.googlesource.com/chromium/src.git/+/refs/heads/main/components/vector_icons/README.md* -## Building +## Building To build, use: autoninja -C out/thorium chrome chromedriver thorium_shell setup mini_installer thorium_ui_debug_shell or just autoninja -C out/thorium thorium_ui_debug_shell to exclude building the rest of Thorium. diff --git a/infra/DEBUG/README.md b/infra/DEBUG/README.md index 50834d39..44f90230 100644 --- a/infra/DEBUG/README.md +++ b/infra/DEBUG/README.md @@ -1,15 +1,15 @@ -## Thorium Debugging Infra +## Thorium Debugging Infra - This contains [*.gn files*](https://gn.googlesource.com/gn/) and scripts for generating DEBUG builds of Thorium for debugging, testing, and inspection. - - The [ABOUT_GN_ARGS.md](https://github.com/Alex313031/Thorium/blob/main/infra/DEBUG/ABOUT_GN_ARGS.md) describes what each line in the args *.gn files do, also useful for the regular build args *.gn files. \ -   __NOTE:__ You cannot build installers for any platform with a debug build. Running the [clean.sh](https://github.com/Alex313031/Thorium/blob/main/clean.sh) script in the root of the repo is highly reccomended to get your //out/thorium dir from ~6-7 GB to something reasonable, like ~1-2 GB. + - The [ABOUT_GN_ARGS.md](https://github.com/Alex313031/thorium/blob/main/infra/DEBUG/ABOUT_GN_ARGS.md) describes what each line in the args *.gn files do, also useful for the regular build args *.gn files. \ +   __NOTE:__ You cannot build installers for any platform with a debug build. Running the [clean.sh](https://github.com/Alex313031/thorium/blob/main/clean.sh) script in the root of the repo is highly reccomended to get your //out/thorium dir from ~6-7 GB to something reasonable, like ~1-2 GB. - Running the `build_debug.sh` or `build_win_debug.sh` will build the *Thorium UI Debug Shell (views_examples_with_content)* target as well as the rest of Thorium. - Running `build_debug_shell.sh` can be used for any platform, and will build the standalone Thorium UI Debug Shell. \    __NOTE:__ Running either of the above will make a directory in //out/thorium called Thorium_UI_Debug_Shell with all the artifacts and Readme inside, suitable for zipping up and distributing to users. - - For more information, read the [DEBUG_SHELL_README.md](https://github.com/Alex313031/Thorium/blob/main/infra/DEBUG/DEBUG_SHELL_README.md) file). + - For more information, read the [DEBUG_SHELL_README.md](https://github.com/Alex313031/thorium/blob/main/infra/DEBUG/DEBUG_SHELL_README.md) file). ### More Info -__The [*DEBUGGING.md*](https://github.com/Alex313031/Thorium/blob/main/infra/DEBUG/DEBUGGING.md) file is a slightly modified version of the upstream Chromium one.__ \ +__The [*DEBUGGING.md*](https://github.com/Alex313031/thorium/blob/main/infra/DEBUG/DEBUGGING.md) file is a slightly modified version of the upstream Chromium one.__ \ __**For more information about debugging,* See > [Logging](https://www.chromium.org/for-testers/enable-logging/),  [Network Logging](https://www.chromium.org/for-testers/providing-network-details/),  [Linux](https://chromium.googlesource.com/chromium/src/+/HEAD/docs/linux/debugging.md),  [MacOS](https://chromium.googlesource.com/chromium/src/+/HEAD/docs/mac/debugging.md),  [Android](https://chromium.googlesource.com/chromium/src/+/HEAD/docs/android_debugging_instructions.md),  [ChromiumOS](https://www.chromium.org/chromium-os/how-tos-and-troubleshooting/debugging-features/),  and [Windows](https://chromium.googlesource.com/playground/chromium-org-site/+/refs/heads/main/developers/how-tos/debugging-on-windows/index.md),  including [WinDBG Help](https://chromium.googlesource.com/playground/chromium-org-site/+/refs/heads/main/developers/how-tos/debugging-on-windows/windbg-help.md),  and [Dump Example](https://chromium.googlesource.com/playground/chromium-org-site/+/refs/heads/main/developers/how-tos/debugging-on-windows/example-of-working-with-a-dump.md).__ - + diff --git a/infra/README.md b/infra/README.md index 6489e3a1..adedb189 100644 --- a/infra/README.md +++ b/infra/README.md @@ -1,19 +1,19 @@ -## Thorium Infrastructure (Infra) +## Thorium Infrastructure (Infra) -  This dir contains [*.gn files*](https://gn.googlesource.com/gn/), scripts, and other artifacts like vdpau-va-driver and flash player and the BUILDER file which contains notes (generally only usable by me, but feel free to ask what the info inside is for). \ -  The [args.list](https://github.com/Alex313031/Thorium/blob/main/infra/args.list) file shows all possible build arguments, and the [gn_args.list](https://github.com/Alex313031/Thorium/blob/main/infra/gn_args.list) shows all possible build args after the Thorium args have been added, and the [win_args.list](https://github.com/Alex313031/Thorium/blob/main/infra/win_args.list) shows all possible build arguments for Windows builds. \ -  The *.gn files contain what you should use in the args.gn for platforms other than the normal Linux release (which is [here](https://github.com/Alex313031/Thorium/blob/main/args.gn) in the root of this repo.) +  This dir contains [*.gn files*](https://gn.googlesource.com/gn/), scripts, and other artifacts like vdpau-va-driver and flash player and the BUILDER file which contains notes (generally only usable by me, but feel free to ask what the info inside is for). \ +  The [args.list](https://github.com/Alex313031/thorium/blob/main/infra/args.list) file shows all possible build arguments, and the [gn_args.list](https://github.com/Alex313031/thorium/blob/main/infra/gn_args.list) shows all possible build args after the Thorium args have been added, and the [win_args.list](https://github.com/Alex313031/thorium/blob/main/infra/win_args.list) shows all possible build arguments for Windows builds. \ +  The *.gn files contain what you should use in the args.gn for platforms other than the normal Linux release (which is [here](https://github.com/Alex313031/thorium/blob/main/args.gn) in the root of this repo.) - - The [69_release_args.gn](https://github.com/Alex313031/Thorium/blob/main/infra/69_release_args.gn) is for Chromium 60-70 versions. - - The [android_args.gn](https://github.com/Alex313031/Thorium/blob/main/infra/android_args.gn) is for Android ARM64. > https://chromium.googlesource.com/chromium/src/+/main/docs/android_build_instructions.md - - The [cros_args.gn](https://github.com/Alex313031/Thorium/blob/main/infra/cros_args.gn) is for ChromiumOS on Linux. > https://chromium.googlesource.com/chromium/src/+/main/docs/chromeos_build_instructions.md#Chromium-OS-on-Linux-linux_chromeos - - The [mac_args.gn](https://github.com/Alex313031/Thorium/blob/main/infra/mac_args.gn) is for x64 macs. (See [Thorium Special](https://github.com/Alex313031/Thorium-Special) for ARM64 M1 args.gn.) - - The [win_args.gn](https://github.com/Alex313031/Thorium/blob/main/infra/win_args.gn) is for Windows x64 \ - - The [cgpt](https://github.com/Alex313031/Thorium/blob/main/infra/cgpt) file is a compiler optimized build of cgpt for Linux/ChromiumOS, you can put anywhere in your $PATH. See > https://chromium.googlesource.com/chromiumos/platform/vboot_reference/+/refs/heads/main/README - - The DEBUG dir is for DEBUGGING, see the [README.md](https://github.com/Alex313031/Thorium/tree/main/infra/DEBUG#readme) inside it. + - The [69_release_args.gn](https://github.com/Alex313031/thorium/blob/main/infra/69_release_args.gn) is for Chromium 60-70 versions. + - The [android_args.gn](https://github.com/Alex313031/thorium/blob/main/infra/android_args.gn) is for Android ARM64. > https://chromium.googlesource.com/chromium/src/+/main/docs/android_build_instructions.md + - The [cros_args.gn](https://github.com/Alex313031/thorium/blob/main/infra/cros_args.gn) is for ChromiumOS on Linux. > https://chromium.googlesource.com/chromium/src/+/main/docs/chromeos_build_instructions.md#Chromium-OS-on-Linux-linux_chromeos + - The [mac_args.gn](https://github.com/Alex313031/thorium/blob/main/infra/mac_args.gn) is for x64 macs. (See [Thorium Special](https://github.com/Alex313031/Thorium-Special) for ARM64 M1 args.gn.) + - The [win_args.gn](https://github.com/Alex313031/thorium/blob/main/infra/win_args.gn) is for Windows x64 \ + - The [cgpt](https://github.com/Alex313031/thorium/blob/main/infra/cgpt) file is a compiler optimized build of cgpt for Linux/ChromiumOS, you can put anywhere in your $PATH. See > https://chromium.googlesource.com/chromiumos/platform/vboot_reference/+/refs/heads/main/README + - The DEBUG dir is for DEBUGGING, see the [README.md](https://github.com/Alex313031/thorium/tree/main/infra/DEBUG#readme) inside it. - – The [WIN_INSTRUCTIONS.txt](https://github.com/Alex313031/Thorium/blob/main/infra/WIN_INSTRUCTIONS.txt) and [WIN_CROSS_BUILD_INSTRUCTIONS.txt](https://github.com/Alex313031/Thorium/blob/main/infra/WIN_CROSS_BUILD_INSTRUCTIONS.txt) are for how to build Thorium for Windows natively and on Linux, respectively. \ - – The [DEV_CMDLINE_FLAGS.txt](https://github.com/Alex313031/Thorium/blob/main/infra/DEV_CMDLINE_FLAGS.txt) has usefule command line flags for Debugging, Web Development, and Thorium development. The [CMDLINE_FLAGS_LIST.md](https://github.com/Alex313031/Thorium/blob/main/infra/CMDLINE_FLAGS_LIST.md) contains a list of all possible cmdline flags for Chromium. It is borrowed from > https://peter.sh/experiments/chromium-command-line-switches/ \ - – The [thorium_devel_bookmarks.html](https://github.com/Alex313031/Thorium/blob/main/infra/thorium_devel_bookmarks.html) file contain the bookmarks I use for Thorium development and rebasing the files it uses. + – The [WIN_INSTRUCTIONS.txt](https://github.com/Alex313031/thorium/blob/main/infra/WIN_INSTRUCTIONS.txt) and [WIN_CROSS_BUILD_INSTRUCTIONS.txt](https://github.com/Alex313031/thorium/blob/main/infra/WIN_CROSS_BUILD_INSTRUCTIONS.txt) are for how to build Thorium for Windows natively and on Linux, respectively. \ + – The [DEV_CMDLINE_FLAGS.txt](https://github.com/Alex313031/thorium/blob/main/infra/DEV_CMDLINE_FLAGS.txt) has usefule command line flags for Debugging, Web Development, and Thorium development. The [CMDLINE_FLAGS_LIST.md](https://github.com/Alex313031/thorium/blob/main/infra/CMDLINE_FLAGS_LIST.md) contains a list of all possible cmdline flags for Chromium. It is borrowed from > https://peter.sh/experiments/chromium-command-line-switches/ \ + – The [thorium_devel_bookmarks.html](https://github.com/Alex313031/thorium/blob/main/infra/thorium_devel_bookmarks.html) file contain the bookmarks I use for Thorium development and rebasing the files it uses. - + diff --git a/infra/install_deps.sh b/infra/install_deps.sh index 58216de9..5d465203 100755 --- a/infra/install_deps.sh +++ b/infra/install_deps.sh @@ -32,7 +32,7 @@ cd && # Clone repos git clone https://chromium.googlesource.com/chromium/tools/depot_tools.git && printf "\n" && -git clone --recursive https://github.com/Alex313031/Thorium.git && +git clone --recursive https://github.com/Alex313031/thorium.git && # Make Chromium dirs printf "\n" && diff --git a/infra/portable/make_portable_linux.sh b/infra/portable/make_portable_linux.sh index d24e808b..e670582f 100755 --- a/infra/portable/make_portable_linux.sh +++ b/infra/portable/make_portable_linux.sh @@ -30,7 +30,7 @@ printf "\n" && printf "${bold}${RED}NOTE: You must place the Thorium .deb file in this directory before running.${c0}\n" && printf "${bold}${RED} AND you must have p7zip-full and zip installed.${c0}\n" && printf "\n" && -printf "${bold}${RED} - Make sure to rename the .zip properly as per https://github.com/Alex313031/Thorium/discussions/28#discussioncomment-3031799 ${c0}\n" && +printf "${bold}${RED} - Make sure to rename the .zip properly as per https://github.com/Alex313031/thorium/discussions/28#discussioncomment-3031799 ${c0}\n" && printf "${YEL}\n" && read -p "Press Enter to continue or Ctrl + C to abort." diff --git a/infra/portable/make_portable_win.sh b/infra/portable/make_portable_win.sh index ad33fc17..96a33212 100755 --- a/infra/portable/make_portable_win.sh +++ b/infra/portable/make_portable_win.sh @@ -30,7 +30,7 @@ printf "\n" && printf "${bold}${RED}NOTE: You must place the Thorium .exe file in this directory before running.${c0}\n" && printf "${bold}${RED} AND you must have p7zip-full and zip installed.${c0}\n" && printf "\n" && -printf "${bold}${RED} - Make sure to rename the .zip properly as per https://github.com/Alex313031/Thorium/discussions/28#discussioncomment-3031799 ${c0}\n" && +printf "${bold}${RED} - Make sure to rename the .zip properly as per https://github.com/Alex313031/thorium/discussions/28#discussioncomment-3031799 ${c0}\n" && printf "${bold}${RED} AND make sure to edit the THORIUM_SHELL.BAT to match the version number of this release.${c0}\n" && printf "${YEL}\n" && diff --git a/logos/NEW/mac/gen/README.md b/logos/NEW/mac/gen/README.md index 3f03bd0b..8990d12c 100644 --- a/logos/NEW/mac/gen/README.md +++ b/logos/NEW/mac/gen/README.md @@ -1,4 +1,4 @@ -## ICNS generation directory. +## ICNS generation directory. This directory contains files/scripts for generating an .icns (IconSet) file for MacOS from predefined icon .PNGs from 16px to 1024px. @@ -7,4 +7,4 @@ They will generate `Thorium.icns` and `ThoriumDocument.icns`, which should both They will then be renamed to app.icns and document.icns and copied to //thorium/chrome/app/theme/chromium/mac/ for proper Thorium branding on MacOS. - + diff --git a/logos/README.md b/logos/README.md index 89c5a2b9..917c204d 100644 --- a/logos/README.md +++ b/logos/README.md @@ -1,6 +1,6 @@ ## Thorium Logos - + ### Synopsis    This contains the iconset and logos for Thorium, Thorium Shell, Thorium UI icons, and Thorium Infrastructure, as well as the Chromium logo, Chromium Infrastructure logo, and other logos such as the GitHub logo used in the Readme.md and various images used in the .md files in this repo. @@ -10,6 +10,6 @@ __IMPORTANT:__ The 'NEW' directory is where the new logos that are used since M1 - The 'STAGING' dir is for test icons, scratch space, uploading temporary things, icons that don't fit anywhere else, etc. - This project also for a small time was called "[Technetium](https://github.com/Alex313031/Technetium)", and I experimented with different logo designs; some are lost, but one of them is in the 'OLD' directory. These extra things are in the 'OLD' directory along with the Thorium logos used since the beginning up until M100. -*LICENSING*: The Chromium Logo is licensed under Chromium's BSD-Style [License](https://github.com/Alex313031/Thorium/blob/main/infra/CHROMIUM_LICENSE.txt), and some logos like the "bulb" and "build" logos are under Apache's License, which can be found here. The Thorium Logo is licensed under the GPL-3.0 License, however if you are going to use the logo in a derivative project, I would prefer if you let me know first. +*LICENSING*: The Chromium Logo is licensed under Chromium's BSD-Style [License](https://github.com/Alex313031/thorium/blob/main/infra/CHROMIUM_LICENSE.txt), and some logos like the "bulb" and "build" logos are under Apache's License, which can be found here. The Thorium Logo is licensed under the GPL-3.0 License, however if you are going to use the logo in a derivative project, I would prefer if you let me know first. - + diff --git a/other/WIN7/about_version.html b/other/WIN7/about_version.html index 93285c3b..f89fbf12 100644 --- a/other/WIN7/about_version.html +++ b/other/WIN7/about_version.html @@ -63,7 +63,7 @@ about:version template page $i18n{logo_alt_text} -
$i18n{company}
+
$i18n{company}
diff --git a/pak_src/README.md b/pak_src/README.md index 6c77a69f..8e3d2291 100644 --- a/pak_src/README.md +++ b/pak_src/README.md @@ -1,6 +1,6 @@ ## Thorium Pak Customizer - + This contains the source code for pak. diff --git a/src/ash/webui/help_app_ui/resources/app.html b/src/ash/webui/help_app_ui/resources/app.html index 1bfe0a41..c90b0f78 100644 --- a/src/ash/webui/help_app_ui/resources/app.html +++ b/src/ash/webui/help_app_ui/resources/app.html @@ -55,7 +55,7 @@
ThoriumOS aims to produce a ChromiumOS image similar to CloudReady (now ChromeOS Flex), with extra stuff including: diff --git a/src/chrome/app/resources/manpage.1.in b/src/chrome/app/resources/manpage.1.in index 31038151..fbb5bbd9 100644 --- a/src/chrome/app/resources/manpage.1.in +++ b/src/chrome/app/resources/manpage.1.in @@ -12,7 +12,7 @@ .SH DESCRIPTION See the Thorium Repository for help on using the browser. .IP - + .PP This manpage only describes invocation, environment, and arguments. @@ -156,7 +156,7 @@ Default directory for cache data. (Why? See .SH BUGS Bug tracker: .IP -http://code.google.com/p/chromium/issues/list & https://github.com/Alex313031/Thorium/issues +http://code.google.com/p/chromium/issues/list & https://github.com/Alex313031/thorium/issues .PP Be sure to do your search within "All Issues" before reporting bugs, and be sure to pick the "Defect on Linux" template when filing a new one. diff --git a/src/chrome/installer/linux/common/chromium-browser/chromium-browser.appdata.xml b/src/chrome/installer/linux/common/chromium-browser/chromium-browser.appdata.xml index f59f43f8..7865921c 100644 --- a/src/chrome/installer/linux/common/chromium-browser/chromium-browser.appdata.xml +++ b/src/chrome/installer/linux/common/chromium-browser/chromium-browser.appdata.xml @@ -20,15 +20,15 @@ Thorium supports Vorbis, Theora, WebM, AAC, H.264, MP3, and HTML5 audio and video standards.

- https://github.com/Alex313031/Thorium + https://github.com/Alex313031/thorium - https://github.com/Alex313031/Thorium/blob/main/logos/STAGING/Thorium_Screenshot.png + https://github.com/Alex313031/thorium/blob/main/logos/STAGING/Thorium_Screenshot.png The Chromium Authors and Alex313031 - https://github.com/Alex313031/Thorium/issues + https://github.com/Alex313031/thorium/issues https://chromium.googlesource.com/chromium/src/+/main/docs/linux/debugging.md diff --git a/src/chrome/installer/linux/common/chromium-browser/chromium-browser.info b/src/chrome/installer/linux/common/chromium-browser/chromium-browser.info index 4ffa3d1c..bc514665 100644 --- a/src/chrome/installer/linux/common/chromium-browser/chromium-browser.info +++ b/src/chrome/installer/linux/common/chromium-browser/chromium-browser.info @@ -36,4 +36,4 @@ FULLDESC="Thorium is a browser that combines a minimal design with sophisticated # TODO(mmoss) Setup a mailbox for this address MAINTNAME="Thorium Linux Maintainers" MAINTMAIL="alex313031@gmail.com" -PRODUCTURL="https://github.com/Alex313031/Thorium" +PRODUCTURL="https://github.com/Alex313031/thorium" diff --git a/src/components/neterror/README.md b/src/components/neterror/README.md index 14f5f9cb..f08e9044 100644 --- a/src/components/neterror/README.md +++ b/src/components/neterror/README.md @@ -1,4 +1,4 @@ -## Thorium Network Error Interstitial Resources   +## Thorium Network Error Interstitial Resources   This directory contains the HTML template and resources displayed in the case of network errors received when fetching the root document or iframes. These error @@ -7,7 +7,7 @@ pages can be previewed by following the links listed in chrome://network-errors. The same template is used across all desktop and mobile platforms and for main frames and iframes. -This dir also includes the scripts and images for the Thorium Dino game.   +This dir also includes the scripts and images for the Thorium Dino game.   --- See also: diff --git a/src/components/version_ui/resources/about_version.html b/src/components/version_ui/resources/about_version.html index 4b704b72..a8e6472d 100644 --- a/src/components/version_ui/resources/about_version.html +++ b/src/components/version_ui/resources/about_version.html @@ -63,7 +63,7 @@ about:version template page $i18n{logo_alt_text} -
$i18n{company}
+
$i18n{company}

diff --git a/src/third_party/pak/README.chromium b/src/third_party/pak/README.chromium index 879ffa1e..5d2a4949 100644 --- a/src/third_party/pak/README.chromium +++ b/src/third_party/pak/README.chromium @@ -1,6 +1,6 @@ Name: pak Short Name: pak -URL: https://github.com/Alex313031/Thorium/tree/main/pak_src +URL: https://github.com/Alex313031/thorium/tree/main/pak_src Version: 2.0.2 Date: 08/02/22 Revision: 2.0.2 diff --git a/win_scripts/README.md b/win_scripts/README.md index 372a59af..28d9d398 100644 --- a/win_scripts/README.md +++ b/win_scripts/README.md @@ -1,4 +1,4 @@ -## Windows Build Scripts +## Windows Build Scripts