# uchromium/cfg - "Build" settings for package

#---------------------------------------------------------------------

[technotes]

1. "uchromium" is one of only a few online-build packages supported by
Laclin.  I.e.: This package can't be built offline,  it can't be built
reproducibly, and it might not build at all.

Example[s] of online-build package[s] in Laclin:

      docker librewolf pleroma rustc uchromium

#---------------------------------------------------------------------

2. This  "cfg"  file  installs  dependencies for  "uchromium"  but  it
doesn't build the package.  The package needs to be built manually us-
ing  a "build" script named:

      laclin-build-uchromium.sh

The script is  provided in the  "special" subdirectory  that goes with
this "cfg" file.

The script might take 12 to 28 hours or longer to run.  The time might
be shorter on high-end hardware.

A typical run in  September 2025  on a  ThinkPad W530 i7 4x2 with 32GB
RAM took very close to 27 hours.

#---------------------------------------------------------------------

3. "build"-script requirements include:

* Internet access.

* Ideally, high-end hardware.  On older or more limited hardware,  the
script might take a long time to run.

* "docker" and "dockerd" plus compatible versions of  "runc" and "con-
tainerd".

* For "docker" and "dockerd" to work,  "cgroup" v1 or v2 support to be
# set up. This might or might not be automatic.

* The script needs to be executed as "root".

* Plenty of free disk space is needed in the following three directory
trees:

      /opt  /root  /var

* In general,  the script  can't be used in a container or  a "chroot"
session.

* The script  might work in a  container or a  "chroot" session if the
host and guest are running exactly the same Linux distro.

#---------------------------------------------------------------------

4. If  the "build" script succeeds,  it leaves "build" results  in the
directory:

      /opt/uchromium/

This should include a "bin" subdirectory and a "program" subdirectory.

The "bin" directory includes a wrapper script named "uchromium".  That
script may be used  to start the program or to bring it to the current
desktop and forward.

The  directory  "/opt/uchromium/" may be  tarballed and  unpacked on a
different box  to install  UChromium there -- provided  that the Linux
distros on the  build box and  the  target box are  either the same or
close enough.
 
#---------------------------------------------------------------------

5. To set up and/or  tweak  a new copy of  UChromium and/or  UChromium
with a fresh profile:

chrome://extensions/
-> Turn on Developer mode

Execute  "Load unpacked"  for each extension of  that type  that you'd
like to use.

Install extensions of other types that you'd like to use, if any.

* Import passwords from Firefox, if you have Firefox and it has all of
your passwords.

* Or restore passwords from a backup, if you have one:

chrome://password-manager/passwords

* If  you're going from one copy of UChromium to another of an identi-
cal or highly compatible release,  you can transfer the old history as
follows:

tarball $HOME/.config/chromium/Default/History*
substitute appropriate directory path for ".../chromium/"
unpack  the files in the tarball into the "Default" directory  for the
new copy of UChromium

* Restore extension setting backups, if you have any. These extensions
and possibly others support that:

PopUpOFF
Proxy SwitchySharp
User-Agent Switcher

* Bookmarks

* Pin the extensions that you'd like to be pinned.
* Set Proxy SS appropriately.
* Set User Agent Switcher.
* Configure Delete browsing data feature

* Set these UChromium as desired:

Settings -> Appearance  -> Show Home button
Settings -> Performance -> Memory Saver
Settings -> Appearance  -> Font size -> Medium
Set fonts to Liberation Serif, Serif, and Sans

Search Engine
On startup -> Continue where you left off

#---------------------------------------------------------------------

[buildtimes]

22.88 hours (or 1,373 minutes)  - 2023 dedi Xeon E3-1200 v3  4x2  32GB
                                  RAM

#---------------------------------------------------------------------

[settings]
build      = none
configure  = none
defer      = glibc64
exepack    = no
license    = tbd
nosyslinks = yes
proddir    = none
unpack     = none

#---------------------------------------------------------------------

# Some of  the dependencies listed here are  not used by this package.
# However, in some cases, they may pull in dependencies that are need-
# ed.

[depends]
alsa
bzip2
cairo
cups
elfutils
eudev
expat
ffmpeg
flac
fontconfig
freetype2
fribidi
gnutls3
graphite2
gtkcore
jpeg
libbsd
libcap
libffi
libgmp
libidn2
libogg
libpng
libsndfile
libunistring
libva
libvorbis
ncurses
nettle3
nodejs
nspr
nss
openssl
p11kit
pciutils
pulseaudio
python
sqlite3
tcp-wrappers
util-linux
wayland
xorg
zlib

#---------------------------------------------------------------------

# Original URLs. These URLs were valid at one point, but may have died
# since then. If you download newer versions of tarballs [etc.], don't
# delete  the  original versions,  as you may not  be able  to replace
# them.

[urls]
url_debian  = n/a
url_home    = tbd
url_lfs     = n/a
url_tarball = n/a               # See "technotes" in "cfg" file

#---------------------------------------------------------------------

[history]
250901 Added package
250901 Started with 139.0.7258.154
250913 Updated to 140.0.7339.127
251010 Updated to 141.0.7390.54