tapyu · March 18, 2025 02:23
diff --git a/.unix_setup.md b/.unix_setup.md
diff --git a/_autoinstall_LTS.yaml b/_autoinstall_LTS.yaml
 autoinstall:
  version: 1

  packages:
    - vim
    - stow # a symlink farm manager
    - git
    - zsh
    - fzf # fuzzy finder CAVEAT: check if fzf version is greater than or equal to `0.48.0`, otherwise the `--zsh` option in this line https://github.com/tapyu/dotfiles/blob/4a3a599a8848a757ef6b972b65224b9678052612/zsh/.config/zsh/zshrc.sh#L73 will break. SEE: https://github.com/junegunn/fzf/issues/3703
    - apt-transport-https
    - curl        # deb-get dependencies
    - lsb-release #
    - wget        #
    - apt-file # search for a package that provides a specific file
    - ttf-mscorefonts-installer # Microsoft True Type Core Fonts for the Web including: Andale Mono, Arial Black, Arial (Bold, Italic, Bold Italic), Comic Sans MS (Bold), Courier New (Bold, Italic, Bold Italic), Georgia (Bold, Italic, Bold Italic), Impact, Times New Roman (Bold, Italic, Bold Italic), Trebuchet (Bold, Italic, Bold Italic), Verdana (Bold, Italic, Bold Italic), Webdings
    - libyaml-tiny-perl    # HACK: fix latexindent error (see https://stackoverflow.com/a/77425816/23333162)
    - libfile-homedir-perl #
    - moreutils # This is a growing collection of the Unix tools that nobody thought to write long ago, when Unix was young -> `combine`, `pee`, `sponge`, ...
    - rar
    - unrar
    - tree
    - ripgrep
    - pdfgrep
    - screenkey
    - nodejs # node.js: JavaScript runtime environment. When you install a npm package, that requires Node.js to run as it is a JavaScript-based program.
    - npm # npm: stands for "Node Package Manager." It is the default package manager for Node.js;npx: a package runner tool that comes with npm. It allows you to execute Node.js packages directly without having to install them globally or locally.
    - lua5.4   # install the Lua programming language and its package manager (LuaRocks). CAVEAT: This approach doesn't seem too consistent, 1: `lua5.4` pkg version will become absolete and there is no apprent way to install the latest lua version as there is no `lua` pkg in the `apt` command; 2- the `luarocks` pkg is compatible with `lua` of versions from 5.1 to 5.4, you must assure that `luarocks` you are using is compatible with the your `lua` version. See: https://www.reddit.com/r/lua/comments/1agh999/is_there_rustuplike_for_installing_and_managing/ https://luarocks.org/#quick-start https://www.lua.org/download.html
    - luarocks #
    - python-is-python3 # a mere symlink to /usr/bin/python
    - python3-pip # a mere symlink from `python3 -m pip` to `/usr/bin/pip`
    - rename # rename 's/search/replace/g' CLI command
    - xtrlock # keyboard locker (unlock it with the computer password)
    - cmake # C/C++: CMake
    - clang-format # C/C++: formatter
    - valgrind # C/C++: A memory profiler that can detect memory leaks, memory corruption, and other memory-related issues.
    - rclone # NOTE: for the first try, you must run `rclone config reconnect books:`
    - zoxide
    - cloc # count line of code (cloc): git utils to analyze the number lines in a repo (also see the online version: https://codetabs.com/count-loc/count-loc-online.html)
    - pipx # tool for installing and running Python applications in isolated environments, so it's particularly useful for command-line tools or applications you want to run independently, without interfering with other projects or system-wide Python installations.
    - pkg-config # HACK: fix "failed to compile cargo-update" SEE: https://github.com/sfackler/rust-openssl/issues/855
    - libssl-dev #
    # GUI
    - gnome-tweaks
    - gnuradio
    - gnome-clocks # timer, alarms, and stopwatch
    - gnome-shell-extensions
    - usb-creator-gtk # create bootable Linux USBs
    - thunderbird # an email client
    - obs-studio
    - diodon # GTK+ clipboad manager
    - nnn
  
  snaps: # TODO: avoid using snaps
    - name: helix # NOTE: at the moment, helix has no way to be installed on Ubuntu but via snap
      classic: true
    - name: telegram-desktop

  interactive-sections:
    - storage
    - identity

  storage:
    layout:
      name: direct

  identity:
    hostname: ${HOSTNAME}
    password: "${ADMIN_PASSWORD}"
    username: ${ADMIN_USER}
    realname: Rubem Vasconcelos Pacelli
    
  keyboard:
    layout: us
    toggle: null # lwin_toggle # TODO: add keyboard layout
    variant: '' # alt-intl # (?)
  
  locale: en_US.UTF-8 # broader configuration that defines various aspects of the system's behavior based on regional and linguistic preferences, such as language preferences, date/time formats, currency formats, and character encoding
  timezone: America/Recife

  source:
    search_drivers: true
  codecs:
    install: true
  drivers:
    install: true

 #   late-commands:
 #     - curtin in-target -- apt-get autoremove -y
 #     - |
 #       curtin in-target -- curl -sSL https://gist.githubusercontent.com/tapyu/3cbf2ed896c7cdd2a675bbe1a5e4c2e8/raw/initial_settings.sh | bash
 #     - |
 #       curtin in-target -- curl -sSL https://gist.githubusercontent.com/tapyu/3cbf2ed896c7cdd2a675bbe1a5e4c2e8/raw/python_packages_install.sh | bash
 #     - |
 #       curtin in-target -- curl -sSL https://gist.githubusercontent.com/tapyu/3cbf2ed896c7cdd2a675bbe1a5e4c2e8/raw/without_pkg_manager.sh | bash
    

  error-commands:
    - tail -200 /var/log/syslog
diff --git a/_autoinstall_missing.yaml b/_autoinstall_missing.yaml
 # This is a missing part that should be added to `autoinstall.yaml`
 autoinstall:
  
  early-commands:
    ### add non-official APT packages ###
    # helix SEE: https://docs.helix-editor.com/install.html#ubuntu
    - sudo add-apt-repository ppa:maveonair/helix-editor
  
  # Storage configuration
  storage:
    config:
      ## Define the main disk to partition
      - type: disk
        id: disk0 # label to identify and manage the disk, within the YAML configuration file, i.e., during the automated installation process
        ptable: gpt #  GUID Partition Table, the modern standard for partition tables. An alternative partitioning scheme is `mbr` (Master Boot Record), the older standard.
        wipe: superblock-recursive # Determines how the disk is wiped (erased) before new partitions are created. `superblock-recursive` wipes all partition tables and filesystem superblocks on the disk to ensure it’s completely clean.
        preserve: false # Deletes all existing partitions and data on the disk.
        grub_device: true # Installs GRUB on this disk, enabling it to boot the installed operating system.
        match:
          size: largest
      ## Partition
      # Boot EFI System partition
      - id: boot
        type: partition
        device: disk0
        size: 300MB
        flag: boot # `flag`'s value defines a disk-level attribute that defines how the partition should behave or be treated by the system.
      # swap partition
      - id: swap
        type: partition
        device: disk0
        size: 24GB
        flag: swap
      # root filesystem
      - id: root
        type: partition
        device: disk0
        size: 150GB
      # home directory
      - id: home
        type: partition
        device: disk0
        size: 200GB
      # leave leftover space as free
      - id: free-space
        type: partition
        device: disk0
        size: -1  # -1 uses remaining space, leaving it free
      
      ## Format
      # swap
      - id: swap-fs
        type: format
        volume: swap
        fstype: swap
        label: SWAP
      # /boot
      - id: boot-fs
        type: format
        volume: boot
        fstype: fat32 # FAT32 (File Allocation Table 32) is a legacy file system introduced by Microsoft in 1996. It’s simple and widely supported file system primarily used for compatibility purposes across different operating systems and devices, such as: USB drives, SD cards, System boot partitions (e.g., EFI System Partition). Characteristics of FAT32: Compatibility: Works across virtually all operating systems (Windows, macOS, Linux, etc.); Simple Structure: Based on a file allocation table (FAT) that maps file locations on the disk; No Journaling: FAT32 lacks any mechanism to log changes, making it less resilient to data corruption compared to modern file systems like EXT4 or NTFS; File Size Limitation: Individual files cannot exceed 4 GB; Partition Size Limitation: Maximum partition size is 32 GB (on Windows) or larger with third-party tools.
        label: BOOT
      # root /
      - id: root-fs
        type: format
        volume: root
        fstype: ext4 # a common journaling filesystem on Linux systems due to its reliability
        label: ROOT
      # /home
      - id: home-fs
        type: format
        volume: home
        fstype: ext4
        label: HOME
        
      ## Mount
      # /boot
      - id: boot-mnt
        type: mount
        device: boot-fs
        path: /boot
      # root /
      - id: root-mnt
        type: mount
        device: root-fs
        path: /
      # /home
      - id: home-mnt
        type: mount
        device: home-fs
        path: /home
diff --git a/_autoinstall_nightly.yaml b/_autoinstall_nightly.yaml
 autoinstall:
  version: 1

  packages:
    - vim
    - stow # a symlink farm manager
    - pass # uses GPG keys to encrypt passwords, which are stored in `$PASSWORD_STORE_DIR` or ~/.password-store by default
    - htop
    - git
    - zsh
    - fzf # fuzzy finder CAVEAT: check if fzf version is greater than or equal to `0.48.0`, otherwise the `--zsh` option in this line https://github.com/tapyu/dotfiles/blob/4a3a599a8848a757ef6b972b65224b9678052612/zsh/.config/zsh/zshrc.sh#L73 will break. SEE: https://github.com/junegunn/fzf/issues/3703
    - apt-transport-https
    - curl        # deb-get dependencies
    - lsb-release #
    - wget        #
    - apt-file # search for a package that provides a specific file
    - ttf-mscorefonts-installer # Microsoft True Type Core Fonts for the Web including: Andale Mono, Arial Black, Arial (Bold, Italic, Bold Italic), Comic Sans MS (Bold), Courier New (Bold, Italic, Bold Italic), Georgia (Bold, Italic, Bold Italic), Impact, Times New Roman (Bold, Italic, Bold Italic), Trebuchet (Bold, Italic, Bold Italic), Verdana (Bold, Italic, Bold Italic), Webdings
    - libyaml-tiny-perl    # HACK: fix latexindent error (see https://stackoverflow.com/a/77425816/23333162)
    - libfile-homedir-perl #
    - moreutils # This is a growing collection of the Unix tools that nobody thought to write long ago, when Unix was young -> `combine`, `pee`, `sponge`, ...
    - gawk # Full-featured GNU implementation of `awk`. The default `awk` implementation is `mawk`, which is a lightweight and fast implementation of `awk` focused on speed and minimalism. CAVEAT: `awk` should symlink to `gawk` as soon as it is installed. If it is not, run `sudo update-alternatives --config awk`
    - gh # github-cli # CAVEAT: you should run `gh auth login` before
    - rar
    - unrar
    - tree
    - tesseract-ocr     # required for `ocrmypdf` % SEE: https://ocrmypdf.readthedocs.io/en/latest/languages.html#installing-additional-language-packs
    - tesseract-ocr-por # to OCR in pt-br, run `ocrmypdf -l por in.pdf -o out.pdf`
    - ripgrep
    - pdfgrep
    - screenkey
    - nodejs # node.js: JavaScript runtime environment. When you install a npm package, that requires Node.js to run as it is a JavaScript-based program.
    - npm # npm: stands for "Node Package Manager." It is the default package manager for Node.js;npx: a package runner tool that comes with npm. It allows you to execute Node.js packages directly without having to install them globally or locally.
    - lua5.4   # install the Lua programming language and its package manager (LuaRocks). CAVEAT: This approach doesn't seem too consistent, 1: `lua5.4` pkg version will become absolete and there is no apprent way to install the latest lua version as there is no `lua` pkg in the `apt` command; 2- the `luarocks` pkg is compatible with `lua` of versions from 5.1 to 5.4, you must assure that `luarocks` you are using is compatible with the your `lua` version. See: https://www.reddit.com/r/lua/comments/1agh999/is_there_rustuplike_for_installing_and_managing/ https://luarocks.org/#quick-start https://www.lua.org/download.html
    - luarocks #
    - python-is-python3 # a mere symlink to /usr/bin/python
    - python3-pip # a mere symlink from `python3 -m pip` to `/usr/bin/pip`
    - rename # rename 's/search/replace/g' CLI command
    - xtrlock # keyboard locker (unlock it with the computer password)
    - cmake # C/C++: CMake
    - clang-format # C/C++: formatter
    - valgrind # C/C++: A memory profiler that can detect memory leaks, memory corruption, and other memory-related issues.
    - rclone # NOTE: for the first try, you must run `rclone config reconnect books:; rclone sync --verbose books:/books ~/books`
    - zoxide
    - cloc # count line of code (cloc): git utils to analyze the number lines in a repo (also see the online version: https://codetabs.com/count-loc/count-loc-online.html)
    - pipx # tool for installing and running Python applications in isolated environments, so it's particularly useful for command-line tools or applications you want to run independently, without interfering with other projects or system-wide Python installations.
    - pkg-config # HACK: fix "failed to compile cargo-update" SEE: https://github.com/sfackler/rust-openssl/issues/855
    - libssl-dev #
    # GUI
    - gnome-tweaks
    - gnuradio
    - gnome-clocks # timer, alarms, and stopwatch
    - gnome-shell-extensions
    - usb-creator-gtk # create bootable Linux USBs
    - thunderbird # an email client
    - obs-studio
    - diodon # GTK+ clipboad manager
    - nnn
  
  snaps: # TODO: avoid using snaps
    - name: helix # NOTE: at the moment, helix has no way to be installed on Ubuntu but via snap
      classic: true
    - name: telegram-desktop
    - name: thunderbird # NOTE: running thunderbird from the apt install prompts "Command '/usr/bin/thunderbird' requires the thunderbird snap to be installed."

  interactive-sections:
    - storage
    - identity

  storage:
    layout:
      name: direct

  identity:
    hostname: ${HOSTNAME}
    password: "${ADMIN_PASSWORD}"
    username: ${ADMIN_USER}
    realname: Rubem Vasconcelos Pacelli
    
  keyboard:
    layout: us
    toggle: null # lwin_toggle # TODO: add keyboard layout
    variant: '' # alt-intl # (?)
  
  locale: en_US.UTF-8 # broader configuration that defines various aspects of the system's behavior based on regional and linguistic preferences, such as language preferences, date/time formats, currency formats, and character encoding
  timezone: America/Recife

  source:
    search_drivers: true
  codecs:
    install: true
  drivers:
    install: true

 #   late-commands:
 #     - curtin in-target -- apt-get autoremove -y
 #     - |
 #       curtin in-target -- curl -sSL https://gist.githubusercontent.com/tapyu/3cbf2ed896c7cdd2a675bbe1a5e4c2e8/raw/initial_settings.sh | bash
 #     - |
 #       curtin in-target -- curl -sSL https://gist.githubusercontent.com/tapyu/3cbf2ed896c7cdd2a675bbe1a5e4c2e8/raw/without_pkg_manager.sh | bash
 #     - |
 #       curtin in-target -- curl -sSL https://gist.githubusercontent.com/tapyu/3cbf2ed896c7cdd2a675bbe1a5e4c2e8/raw/python_packages_install.sh | bash
 #     - |
 #       curtin in-target -- curl -sSL https://gist.githubusercontent.com/tapyu/3cbf2ed896c7cdd2a675bbe1a5e4c2e8/raw/deb_get_install.sh | bash
 #     - |
 #       curtin in-target -- curl -sSL https://gist.githubusercontent.com/tapyu/3cbf2ed896c7cdd2a675bbe1a5e4c2e8/raw/cargo_install_crates.sh | bash
 #     - |
 #       curtin in-target -- curl -sSL https://gist.githubusercontent.com/tapyu/3cbf2ed896c7cdd2a675bbe1a5e4c2e8/raw/npm_install.sh | bash
 #     - |
 #       curtin in-target -- curl -sSL https://gist.githubusercontent.com/tapyu/3cbf2ed896c7cdd2a675bbe1a5e4c2e8/raw/gnome_setup.sh | bash
    

  error-commands:
    - tail -200 /var/log/syslog
diff --git a/cargo_install_crates.sh b/cargo_install_crates.sh
 #!/usr/bin/env bash
 # intall Rust and its crates

 # install crates
 cargo install cargo-update # a 3th party crate to upgrade all crates (see https://stackoverflow.com/questions/34484361/does-cargo-install-have-an-equivalent-update-command)
 cargo install lsd # the next gen ls command
 cargo install bat # a cat clone with wings
 cargo install --locked typst-cli # the next LaTeX replacement (latest release)
 cargo install just # # the next Makefile replacement
 cargo install git-delta # a syntax-highlighting pager for git, diff, and grep output
 cargo install --locked navi
 cargo install juliaup # Julia installer and version multiplexer

 exit 0
diff --git a/deb_get_install.sh b/deb_get_install.sh
 #!/usr/bin/env bash
 # install deb-get packages

 # deb-get packages
 deb-get install docker-ce
 deb-get install code
 deb-get install sublime-text
 deb-get install master-pdf-editor-5
 deb-get install discord
 deb-get install zotero
 deb-get install gcm # git-credential-manager: authenticates remote repos (e.g., GitHub) using a private GPG key + `pass` to automatically interact with them (via git clone, git push, etc.) without requesting password. This approach diregards tokens or similar.
 deb-get install protonvpn # NOTE: if it fails, see https://github.com/wimpysworld/deb-get/issues/975
diff --git a/gcm_setup.sh b/gcm_setup.sh
 #!/usr/bin/env bash
 # setup remote authentications via git-credential-manager
 # it expects that `pass` and `git-credential-manager`, and `curl` are installed

 # get the private GPG key (a private key inherently contains the public key inside it)
 curl --proto '=https' --tlsv1.2 --fail --location --silent --show-error https://gist.githubusercontent.com/tapyu/c97a537285cdd3171dbaf1f79b3d1862/raw/git_credential_manager.asc | gpg --import

 # set `pass` to use that GPG key
 pass init git-credential-manager

 # says to git this it should use `pass`+GPG keys (it is redundant if `$GCM_CREDENTIAL_STORE` is set to `gpg`)
 git config --global credential.credentialStore gpg

 # set git to use git-credential-manager to authenticate the login
 git config --global credential.helper manager

 # now, a pop-up window should appear in the first login
diff --git a/gnome_setup.sh b/gnome_setup.sh
 #!/usr/bin/env bash
 # set up Gnome Desktop Environment

 ### GNOME default applications ###
 gsettings set org.gnome.desktop.default-applications.terminal exec '/usr/bin/wezterm start --always-new-process'
 xdg-mime default masterpdfeditor5.desktop application/pdf # pdf
 xdg-settings set default-web-browser brave-browser.desktop # browser

 ### GNOME extensions ###
 # List of extension URLs (replace with more URLs as needed)
 urls=(
  'https://extensions.gnome.org/extension/28/gtile/'
  'https://extensions.gnome.org/extension/517/caffeine/'
  'https://extensions.gnome.org/extension/545/hide-top-bar/'
 )

 # Loop through each URL
 for url in "${urls[@]}"; do
  echo "url = ${url}"
  # get package metadata
  id=$(echo "${url}" | cut --delimiter=/ --fields=5)
  url_pkg_metadata="https://extensions.gnome.org/extension-info/?pk=${id}"
  # Extract data for each extension
  uuid=$(curl -s "$url_pkg_metadata" | jq -r '.uuid' | tr -d '@')
  latest_extension_version=$(curl -s "$url_pkg_metadata" | jq -r '.shell_version_map | to_entries | max_by(.value.version) | .value.version')
  latest_shell_version=$(curl -s "$url_pkg_metadata" | jq -r '.shell_version_map | to_entries | max_by(.value.version) | .key')

  # get  package
  filename="${uuid}.v${latest_extension_version}.shell-extension.zip"
  url_pkg="https://extensions.gnome.org/extension-data/${filename}"
  wget -P /tmp "${url_pkg}"
  # install package
  gnome-extensions install "/tmp/${filename}"

  # Print the results
 #   echo "For URL: $url"
 #   echo "UUID: $uuid"
 #   echo "Latest extension version: $latest_extension_version"
 #   echo "Latest shell version: $latest_shell_version"
 #   echo "--------------------------------------"
 done

 ### GNOME gsettings shortcuts ###
 # get more ideas here: https://blog.programster.org/using-the-cli-to-set-custom-keyboard-shortcuts
 # write your solution here: https://askubuntu.com/questions/597395/how-to-set-custom-keyboard-shortcuts-from-terminal
 # TODO: befere binding a shortcut to a command, you should remove this binding from other commands if there exists a link
 KEY_PATH="/org/gnome/settings-daemon/plugins/media-keys/custom-keybindings"
 gsettings set org.gnome.settings-daemon.plugins.media-keys custom-keybindings \
  "['$KEY_PATH/custom0/', '$KEY_PATH/custom1/', '$KEY_PATH/custom2/']" # add more into this list for more shortcuts
 # xtrlock
 gsettings set org.gnome.settings-daemon.plugins.media-keys.custom-keybinding:$KEY_PATH/custom0/ name "Lock keyboard"
 gsettings set org.gnome.settings-daemon.plugins.media-keys.custom-keybinding:$KEY_PATH/custom0/ command "'/usr/bin/xtrlock'"
 gsettings set org.gnome.settings-daemon.plugins.media-keys.custom-keybinding:$KEY_PATH/custom0/  binding "<Super><Control>l"
 # diodon
 gsettings set org.gnome.settings-daemon.plugins.media-keys.custom-keybinding:$KEY_PATH/custom1/ name "diodon"
 gsettings set org.gnome.settings-daemon.plugins.media-keys.custom-keybinding:$KEY_PATH/custom1/ command "diodon"
 gsettings set org.gnome.settings-daemon.plugins.media-keys.custom-keybinding:$KEY_PATH/custom1/  binding "<Super>V"

 ### GNOME settings###
 # isolate workspaces
 gsettings set org.gnome.shell.app-switcher current-workspace-only true
 gsettings set org.gnome.shell.extensions.dash-to-dock isolate-workspaces true
 # TODO: mute alert sounds (`gsettings set org.gnome.desktop.sound event-sounds false` is not working anymore)

 # enable overamplification https://www.reddit.com/r/gnome/comments/exfhc4/overamplification_extension/fgbf9j2/?utm_source=share&utm_medium=web2x&context=3 
 gsettings set org.gnome.desktop.sound allow-volume-above-100-percent 'true'
 # disable animations
 gsettings set org.gnome.desktop.interface enable-animations false
 # unset the anoying IBus emoji insert (see https://superuser.com/questions/1687342/what-is-my-x11-doing-with-ctrl-period-and-how-can-i-disable-it)
 gsettings set org.freedesktop.ibus.panel.emoji hotkey "@as []" # @as indicates that the value is of "array of strings" type (GSettings and dconf are strongly-typed, but usually guess the type from the value itself – but an empty [] only tells them that it's an array-of-something)
 # dark theme
 gsettings set org.gnome.desktop.interface color-scheme 'prefer-dark'
 # autohide docker
 gsettings set org.gnome.shell.extensions.dash-to-dock dock-fixed false
 gsettings set org.gnome.shell.extensions.dash-to-dock autohide true
diff --git a/initial_settings.sh b/initial_settings.sh
 #!/usr/bin/env bash
 # Perform the following initial settings on the brand new Ubuntu:
 # 1- Change shell interpreter to zsh
 # 2- Install Meslo fonts
 # 3- Config symlinks
 # 4- Remove useless directories

 if [[ ! $SHELL =~ zsh ]]; then
  ## install zsh ###
  echo -e "\n\nPlease, provide your password to switch to zsh"
  sudo chsh -s $(which zsh) $(whoami)
  mkdir -p $HOME/.local/state/zsh # create path to zsh hist
 fi

 ### install Meslo patched Nerd-fonts into ~/.local/share/fonts/ ###
 for name in {Regular,Italic,Bold,Bold-Italic}; do
  [[ ! -f "$HOME/.local/share/fonts/MesloLGMDZNerdFont-${name/-/}.ttf" ]] && wget --directory-prefix="$HOME/.local/share/fonts" "https://github.com/ryanoasis/nerd-fonts/raw/master/patched-fonts/Meslo/M-DZ/${name}/MesloLGMDZNerdFont-${name/-/}.ttf"
 done
 echo -e "\n\ninstalled Meslo patched Nerd-fonts into ~/.local/share/fonts/"

 ### HACK: fix WPS-Office error "Some formula symbols might not be displayed correctly due to missing fonts Symbol, Windings" # SEE: https://askubuntu.com/a/861604/976781
 sudo mkdir /usr/share/fonts/kingsoft 2> /dev/null
 sudo chown -R $USER:$USER /usr/share/fonts/kingsoft
 (
  cd /tmp
  cp wps-fonts/wps/* /usr/share/fonts/kingsoft
 )

 ### configuring the symlinks ###
 mkdir $HOME/git
 (cd $HOME/git;git clone https://github.com/tapyu/dotfiles) # clone dotfiles
 rm -f $HOME/.profile # ensure there is no .profile in $HOME
 (cd $HOME/git/dotfiles; stow --verbose=1 --target=${HOME} */) # carry out the symlink manager

 echo -e "\n\nSymlinks configured"

 ### removing useless and default directories ###
 rm -rf $HOME/{Music,Public,Templates,.bash_history,.bash_logout,.bashrc,.lesshst,.wget-hsts}
diff --git a/npm_install.sh b/npm_install.sh
 #!/usr/bin/env bash
 # install npm packages

 sudo npm install -g tldr
 sudo npm install -g bash-language-server
 sudo npm install -g safe-rm
diff --git a/python_packages_install.sh b/python_packages_install.sh
 #!/usr/bin/env bash
 # install Python packages

 pipx install gprof2dot # C/C++: converts profiling output to a dot graph
 pipx install poetry # poetry, a python packaging and dependency management
 pipx install tgpt # AI Chatbots in terminal without needing API keys # CAVEAT: you need a chat GPT API key from a paid account. Otherwise, you cannot make requests via the API
 pipx install ruff # extremely fast Python linter and code formatter, written in Rust. Ruff can be used to replace Flake8 (plus dozens of plugins), Black, isort, pydocstyle, pyupgrade, autoflake, and more, all while executing tens or hundreds of times faster than any individual tool
 pipx install hydra # Stop Hard Coding in a Data Science Project, Use Config Files Instead
 pipx install cookiecutter # Structure a Data Science Project for Maintainability
 pipx install ocrmypdf
diff --git a/without_pkg_manager.sh b/without_pkg_manager.sh
 #!/usr/bin/env bash
 # packages that aren't in any package manages. They are either
 # added to `apt` or installed manually

 ### APT-added packages ###

 # Wez's Terminal emulator
 # SEE: https://wezfurlong.org/wezterm/install/linux.html#installing-on-ubuntu
 curl -fsSL https://apt.fury.io/wez/gpg.key | sudo gpg --yes --dearmor -o /usr/share/keyrings/wezterm-fury.gpg
 echo 'deb [signed-by=/usr/share/keyrings/wezterm-fury.gpg] https://apt.fury.io/wez/ * *' | sudo tee /etc/apt/sources.list.d/wezterm.list

 # Brave browser
 # SEE: https://brave.com/linux/#debian-ubuntu-mint
 sudo curl -fsSLo /usr/share/keyrings/brave-browser-archive-keyring.gpg https://brave-browser-apt-release.s3.brave.com/brave-browser-archive-keyring.gpg
 echo "deb [signed-by=/usr/share/keyrings/brave-browser-archive-keyring.gpg] https://brave-browser-apt-release.s3.brave.com/ stable main"|sudo tee /etc/apt/sources.list.d/brave-browser-release.list

 # fastfetch, a neofetch and screenfetch drop-in replacement
 sudo add-apt-repository -y ppa:zhangsongcui3371/fastfetch

 # install
 sudo apt update
 sudo apt install -y wezterm-nightly brave-browser fastfetch

 ### Others ###

 # deb-get
 # SEE: https://github.com/wimpysworld/deb-get#install
 curl -sL https://raw.githubusercontent.com/wimpysworld/deb-get/main/deb-get | sudo -E bash -s install deb-get

 # LaTeX
 # TeX Live is available for Ubuntu and is in the Universe repository. This will install a basic subset of TeX Live's functionality. To install the complete TeX Live distribution, install texlive-full. Installing TeX Live directly does not interfere with Ubuntu, and ensures that you have the latest releases of all TeX and LaTeX packages. The downside is that you periodically have to update your installation manually, using the TeX Live Package Manager.
 #apt install -y texlive-full # latex from ubuntu
 # NOTE: https://www.tug.org/texlive/quickinstall.html
 (cd /tmp ; \
  wget https://mirror.ctan.org/systems/texlive/tlnet/install-tl-unx.tar.gz ; \
  zcat < install-tl-unx.tar.gz | tar xf - ; \
  cd install-tl-*/ ; \
  sudo perl ./install-tl --no-interaction)
 sudo chown -R $USER:$USER /usr/local/texlive/ # change ownership to user
 # TODO: if the some packages fail, it prompts a message suggesting you to run
 # `tlmgr update --all --reinstall-forcibly-removed` to try to resintall them
 # you should create a return value handling to run it in case any package fails

 # jq: Command-line JSON processor
 curl --fail --location https://github.com/jqlang/jq/releases/latest/download/jq-linux-amd64 --output $HOME/.local/bin/jq
 chmod u+x $HOME/.local/bin/jq

 # xml2json
 (
  git clone https://github.com/Cheedoong/xml2json /tmp/xml2json
  cd /tmp/xml2json
  make
  mv xml2json $HOME/.local/bin
 )

 # rust
 # SEE: https://www.rust-lang.org/tools/install
 curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- -y
 source "${XDG_DATA_HOME}/cargo/env"

 exit 0
	autoinstall:
	version: 1

	packages:
	- vim
	- stow # a symlink farm manager
	- git
	- zsh
	- fzf # fuzzy finder CAVEAT: check if fzf version is greater than or equal to `0.48.0`, otherwise the `--zsh` option in this line https://github.com/tapyu/dotfiles/blob/4a3a599a8848a757ef6b972b65224b9678052612/zsh/.config/zsh/zshrc.sh#L73 will break. SEE: https://github.com/junegunn/fzf/issues/3703
	- apt-transport-https
	- curl # deb-get dependencies
	- lsb-release #
	- wget #
	- apt-file # search for a package that provides a specific file
	- ttf-mscorefonts-installer # Microsoft True Type Core Fonts for the Web including: Andale Mono, Arial Black, Arial (Bold, Italic, Bold Italic), Comic Sans MS (Bold), Courier New (Bold, Italic, Bold Italic), Georgia (Bold, Italic, Bold Italic), Impact, Times New Roman (Bold, Italic, Bold Italic), Trebuchet (Bold, Italic, Bold Italic), Verdana (Bold, Italic, Bold Italic), Webdings
	- libyaml-tiny-perl # HACK: fix latexindent error (see https://stackoverflow.com/a/77425816/23333162)
	- libfile-homedir-perl #
	- moreutils # This is a growing collection of the Unix tools that nobody thought to write long ago, when Unix was young -> `combine`, `pee`, `sponge`, ...
	- rar
	- unrar
	- tree
	- ripgrep
	- pdfgrep
	- screenkey
	- nodejs # node.js: JavaScript runtime environment. When you install a npm package, that requires Node.js to run as it is a JavaScript-based program.
	- npm # npm: stands for "Node Package Manager." It is the default package manager for Node.js;npx: a package runner tool that comes with npm. It allows you to execute Node.js packages directly without having to install them globally or locally.
	- lua5.4 # install the Lua programming language and its package manager (LuaRocks). CAVEAT: This approach doesn't seem too consistent, 1: `lua5.4` pkg version will become absolete and there is no apprent way to install the latest lua version as there is no `lua` pkg in the `apt` command; 2- the `luarocks` pkg is compatible with `lua` of versions from 5.1 to 5.4, you must assure that `luarocks` you are using is compatible with the your `lua` version. See: https://www.reddit.com/r/lua/comments/1agh999/is_there_rustuplike_for_installing_and_managing/ https://luarocks.org/#quick-start https://www.lua.org/download.html
	- luarocks #
	- python-is-python3 # a mere symlink to /usr/bin/python
	- python3-pip # a mere symlink from `python3 -m pip` to `/usr/bin/pip`
	- rename # rename 's/search/replace/g' CLI command
	- xtrlock # keyboard locker (unlock it with the computer password)
	- cmake # C/C++: CMake
	- clang-format # C/C++: formatter
	- valgrind # C/C++: A memory profiler that can detect memory leaks, memory corruption, and other memory-related issues.
	- rclone # NOTE: for the first try, you must run `rclone config reconnect books:`
	- zoxide
	- cloc # count line of code (cloc): git utils to analyze the number lines in a repo (also see the online version: https://codetabs.com/count-loc/count-loc-online.html)
	- pipx # tool for installing and running Python applications in isolated environments, so it's particularly useful for command-line tools or applications you want to run independently, without interfering with other projects or system-wide Python installations.
	- pkg-config # HACK: fix "failed to compile cargo-update" SEE: https://github.com/sfackler/rust-openssl/issues/855
	- libssl-dev #
	# GUI
	- gnome-tweaks
	- gnuradio
	- gnome-clocks # timer, alarms, and stopwatch
	- gnome-shell-extensions
	- usb-creator-gtk # create bootable Linux USBs
	- thunderbird # an email client
	- obs-studio
	- diodon # GTK+ clipboad manager
	- nnn

	snaps: # TODO: avoid using snaps
	- name: helix # NOTE: at the moment, helix has no way to be installed on Ubuntu but via snap
	classic: true
	- name: telegram-desktop

	interactive-sections:
	- storage
	- identity

	storage:
	layout:
	name: direct

	identity:
	hostname: ${HOSTNAME}
	password: "${ADMIN_PASSWORD}"
	username: ${ADMIN_USER}
	realname: Rubem Vasconcelos Pacelli

	keyboard:
	layout: us
	toggle: null # lwin_toggle # TODO: add keyboard layout
	variant: '' # alt-intl # (?)

	locale: en_US.UTF-8 # broader configuration that defines various aspects of the system's behavior based on regional and linguistic preferences, such as language preferences, date/time formats, currency formats, and character encoding
	timezone: America/Recife

	source:
	search_drivers: true
	codecs:
	install: true
	drivers:
	install: true

	# late-commands:
	# - curtin in-target -- apt-get autoremove -y
	# - \|
	# curtin in-target -- curl -sSL https://gist.githubusercontent.com/tapyu/3cbf2ed896c7cdd2a675bbe1a5e4c2e8/raw/initial_settings.sh \| bash
	# - \|
	# curtin in-target -- curl -sSL https://gist.githubusercontent.com/tapyu/3cbf2ed896c7cdd2a675bbe1a5e4c2e8/raw/python_packages_install.sh \| bash
	# - \|
	# curtin in-target -- curl -sSL https://gist.githubusercontent.com/tapyu/3cbf2ed896c7cdd2a675bbe1a5e4c2e8/raw/without_pkg_manager.sh \| bash


	error-commands:
	- tail -200 /var/log/syslog
	# This is a missing part that should be added to `autoinstall.yaml`
	autoinstall:

	early-commands:
	### add non-official APT packages ###
	# helix SEE: https://docs.helix-editor.com/install.html#ubuntu
	- sudo add-apt-repository ppa:maveonair/helix-editor

	# Storage configuration
	storage:
	config:
	## Define the main disk to partition
	- type: disk
	id: disk0 # label to identify and manage the disk, within the YAML configuration file, i.e., during the automated installation process
	ptable: gpt # GUID Partition Table, the modern standard for partition tables. An alternative partitioning scheme is `mbr` (Master Boot Record), the older standard.
	wipe: superblock-recursive # Determines how the disk is wiped (erased) before new partitions are created. `superblock-recursive` wipes all partition tables and filesystem superblocks on the disk to ensure it’s completely clean.
	preserve: false # Deletes all existing partitions and data on the disk.
	grub_device: true # Installs GRUB on this disk, enabling it to boot the installed operating system.
	match:
	size: largest
	## Partition
	# Boot EFI System partition
	- id: boot
	type: partition
	device: disk0
	size: 300MB
	flag: boot # `flag`'s value defines a disk-level attribute that defines how the partition should behave or be treated by the system.
	# swap partition
	- id: swap
	type: partition
	device: disk0
	size: 24GB
	flag: swap
	# root filesystem
	- id: root
	type: partition
	device: disk0
	size: 150GB
	# home directory
	- id: home
	type: partition
	device: disk0
	size: 200GB
	# leave leftover space as free
	- id: free-space
	type: partition
	device: disk0
	size: -1 # -1 uses remaining space, leaving it free

	## Format
	# swap
	- id: swap-fs
	type: format
	volume: swap
	fstype: swap
	label: SWAP
	# /boot
	- id: boot-fs
	type: format
	volume: boot
	fstype: fat32 # FAT32 (File Allocation Table 32) is a legacy file system introduced by Microsoft in 1996. It’s simple and widely supported file system primarily used for compatibility purposes across different operating systems and devices, such as: USB drives, SD cards, System boot partitions (e.g., EFI System Partition). Characteristics of FAT32: Compatibility: Works across virtually all operating systems (Windows, macOS, Linux, etc.); Simple Structure: Based on a file allocation table (FAT) that maps file locations on the disk; No Journaling: FAT32 lacks any mechanism to log changes, making it less resilient to data corruption compared to modern file systems like EXT4 or NTFS; File Size Limitation: Individual files cannot exceed 4 GB; Partition Size Limitation: Maximum partition size is 32 GB (on Windows) or larger with third-party tools.
	label: BOOT
	# root /
	- id: root-fs
	type: format
	volume: root
	fstype: ext4 # a common journaling filesystem on Linux systems due to its reliability
	label: ROOT
	# /home
	- id: home-fs
	type: format
	volume: home
	fstype: ext4
	label: HOME

	## Mount
	# /boot
	- id: boot-mnt
	type: mount
	device: boot-fs
	path: /boot
	# root /
	- id: root-mnt
	type: mount
	device: root-fs
	path: /
	# /home
	- id: home-mnt
	type: mount
	device: home-fs
	path: /home
	#!/usr/bin/env bash
	# intall Rust and its crates

	# install crates
	cargo install cargo-update # a 3th party crate to upgrade all crates (see https://stackoverflow.com/questions/34484361/does-cargo-install-have-an-equivalent-update-command)
	cargo install lsd # the next gen ls command
	cargo install bat # a cat clone with wings
	cargo install --locked typst-cli # the next LaTeX replacement (latest release)
	cargo install just # # the next Makefile replacement
	cargo install git-delta # a syntax-highlighting pager for git, diff, and grep output
	cargo install --locked navi
	cargo install juliaup # Julia installer and version multiplexer

	exit 0
	#!/usr/bin/env bash
	# install deb-get packages

	# deb-get packages
	deb-get install docker-ce
	deb-get install code
	deb-get install sublime-text
	deb-get install master-pdf-editor-5
	deb-get install discord
	deb-get install zotero
	deb-get install gcm # git-credential-manager: authenticates remote repos (e.g., GitHub) using a private GPG key + `pass` to automatically interact with them (via git clone, git push, etc.) without requesting password. This approach diregards tokens or similar.
	deb-get install protonvpn # NOTE: if it fails, see https://github.com/wimpysworld/deb-get/issues/975
	#!/usr/bin/env bash
	# setup remote authentications via git-credential-manager
	# it expects that `pass` and `git-credential-manager`, and `curl` are installed

	# get the private GPG key (a private key inherently contains the public key inside it)
	curl --proto '=https' --tlsv1.2 --fail --location --silent --show-error https://gist.githubusercontent.com/tapyu/c97a537285cdd3171dbaf1f79b3d1862/raw/git_credential_manager.asc \| gpg --import

	# set `pass` to use that GPG key
	pass init git-credential-manager

	# says to git this it should use `pass`+GPG keys (it is redundant if `$GCM_CREDENTIAL_STORE` is set to `gpg`)
	git config --global credential.credentialStore gpg

	# set git to use git-credential-manager to authenticate the login
	git config --global credential.helper manager

	# now, a pop-up window should appear in the first login
	#!/usr/bin/env bash
	# set up Gnome Desktop Environment

	### GNOME default applications ###
	gsettings set org.gnome.desktop.default-applications.terminal exec '/usr/bin/wezterm start --always-new-process'
	xdg-mime default masterpdfeditor5.desktop application/pdf # pdf
	xdg-settings set default-web-browser brave-browser.desktop # browser

	### GNOME extensions ###
	# List of extension URLs (replace with more URLs as needed)
	urls=(
	'https://extensions.gnome.org/extension/28/gtile/'
	'https://extensions.gnome.org/extension/517/caffeine/'
	'https://extensions.gnome.org/extension/545/hide-top-bar/'
	)

	# Loop through each URL
	for url in "${urls[@]}"; do
	echo "url = ${url}"
	# get package metadata
	id=$(echo "${url}" \| cut --delimiter=/ --fields=5)
	url_pkg_metadata="https://extensions.gnome.org/extension-info/?pk=${id}"
	# Extract data for each extension
	uuid=$(curl -s "$url_pkg_metadata" \| jq -r '.uuid' \| tr -d '@')
	latest_extension_version=$(curl -s "$url_pkg_metadata" \| jq -r '.shell_version_map \| to_entries \| max_by(.value.version) \| .value.version')
	latest_shell_version=$(curl -s "$url_pkg_metadata" \| jq -r '.shell_version_map \| to_entries \| max_by(.value.version) \| .key')

	# get package
	filename="${uuid}.v${latest_extension_version}.shell-extension.zip"
	url_pkg="https://extensions.gnome.org/extension-data/${filename}"
	wget -P /tmp "${url_pkg}"
	# install package
	gnome-extensions install "/tmp/${filename}"

	# Print the results
	# echo "For URL: $url"
	# echo "UUID: $uuid"
	# echo "Latest extension version: $latest_extension_version"
	# echo "Latest shell version: $latest_shell_version"
	# echo "--------------------------------------"
	done

	### GNOME gsettings shortcuts ###
	# get more ideas here: https://blog.programster.org/using-the-cli-to-set-custom-keyboard-shortcuts
	# write your solution here: https://askubuntu.com/questions/597395/how-to-set-custom-keyboard-shortcuts-from-terminal
	# TODO: befere binding a shortcut to a command, you should remove this binding from other commands if there exists a link
	KEY_PATH="/org/gnome/settings-daemon/plugins/media-keys/custom-keybindings"
	gsettings set org.gnome.settings-daemon.plugins.media-keys custom-keybindings \
	"['$KEY_PATH/custom0/', '$KEY_PATH/custom1/', '$KEY_PATH/custom2/']" # add more into this list for more shortcuts
	# xtrlock
	gsettings set org.gnome.settings-daemon.plugins.media-keys.custom-keybinding:$KEY_PATH/custom0/ name "Lock keyboard"
	gsettings set org.gnome.settings-daemon.plugins.media-keys.custom-keybinding:$KEY_PATH/custom0/ command "'/usr/bin/xtrlock'"
	gsettings set org.gnome.settings-daemon.plugins.media-keys.custom-keybinding:$KEY_PATH/custom0/ binding "<Super><Control>l"
	# diodon
	gsettings set org.gnome.settings-daemon.plugins.media-keys.custom-keybinding:$KEY_PATH/custom1/ name "diodon"
	gsettings set org.gnome.settings-daemon.plugins.media-keys.custom-keybinding:$KEY_PATH/custom1/ command "diodon"
	gsettings set org.gnome.settings-daemon.plugins.media-keys.custom-keybinding:$KEY_PATH/custom1/ binding "<Super>V"

	### GNOME settings###
	# isolate workspaces
	gsettings set org.gnome.shell.app-switcher current-workspace-only true
	gsettings set org.gnome.shell.extensions.dash-to-dock isolate-workspaces true
	# TODO: mute alert sounds (`gsettings set org.gnome.desktop.sound event-sounds false` is not working anymore)

	# enable overamplification https://www.reddit.com/r/gnome/comments/exfhc4/overamplification_extension/fgbf9j2/?utm_source=share&utm_medium=web2x&context=3
	gsettings set org.gnome.desktop.sound allow-volume-above-100-percent 'true'
	# disable animations
	gsettings set org.gnome.desktop.interface enable-animations false
	# unset the anoying IBus emoji insert (see https://superuser.com/questions/1687342/what-is-my-x11-doing-with-ctrl-period-and-how-can-i-disable-it)
	gsettings set org.freedesktop.ibus.panel.emoji hotkey "@as []" # @as indicates that the value is of "array of strings" type (GSettings and dconf are strongly-typed, but usually guess the type from the value itself – but an empty [] only tells them that it's an array-of-something)
	# dark theme
	gsettings set org.gnome.desktop.interface color-scheme 'prefer-dark'
	# autohide docker
	gsettings set org.gnome.shell.extensions.dash-to-dock dock-fixed false
	gsettings set org.gnome.shell.extensions.dash-to-dock autohide true
	#!/usr/bin/env bash
	# Perform the following initial settings on the brand new Ubuntu:
	# 1- Change shell interpreter to zsh
	# 2- Install Meslo fonts
	# 3- Config symlinks
	# 4- Remove useless directories

	if [[ ! $SHELL =~ zsh ]]; then
	## install zsh ###
	echo -e "\n\nPlease, provide your password to switch to zsh"
	sudo chsh -s $(which zsh) $(whoami)
	mkdir -p $HOME/.local/state/zsh # create path to zsh hist
	fi

	### install Meslo patched Nerd-fonts into ~/.local/share/fonts/ ###
	for name in {Regular,Italic,Bold,Bold-Italic}; do
	[[ ! -f "$HOME/.local/share/fonts/MesloLGMDZNerdFont-${name/-/}.ttf" ]] && wget --directory-prefix="$HOME/.local/share/fonts" "https://github.com/ryanoasis/nerd-fonts/raw/master/patched-fonts/Meslo/M-DZ/${name}/MesloLGMDZNerdFont-${name/-/}.ttf"
	done
	echo -e "\n\ninstalled Meslo patched Nerd-fonts into ~/.local/share/fonts/"

	### HACK: fix WPS-Office error "Some formula symbols might not be displayed correctly due to missing fonts Symbol, Windings" # SEE: https://askubuntu.com/a/861604/976781
	sudo mkdir /usr/share/fonts/kingsoft 2> /dev/null
	sudo chown -R $USER:$USER /usr/share/fonts/kingsoft
	(
	cd /tmp
	cp wps-fonts/wps/* /usr/share/fonts/kingsoft
	)

	### configuring the symlinks ###
	mkdir $HOME/git
	(cd $HOME/git;git clone https://github.com/tapyu/dotfiles) # clone dotfiles
	rm -f $HOME/.profile # ensure there is no .profile in $HOME
	(cd $HOME/git/dotfiles; stow --verbose=1 --target=${HOME} */) # carry out the symlink manager

	echo -e "\n\nSymlinks configured"

	### removing useless and default directories ###
	rm -rf $HOME/{Music,Public,Templates,.bash_history,.bash_logout,.bashrc,.lesshst,.wget-hsts}
	#!/usr/bin/env bash
	# install npm packages

	sudo npm install -g tldr
	sudo npm install -g bash-language-server
	sudo npm install -g safe-rm
	#!/usr/bin/env bash
	# install Python packages

	pipx install gprof2dot # C/C++: converts profiling output to a dot graph
	pipx install poetry # poetry, a python packaging and dependency management
	pipx install tgpt # AI Chatbots in terminal without needing API keys # CAVEAT: you need a chat GPT API key from a paid account. Otherwise, you cannot make requests via the API
	pipx install ruff # extremely fast Python linter and code formatter, written in Rust. Ruff can be used to replace Flake8 (plus dozens of plugins), Black, isort, pydocstyle, pyupgrade, autoflake, and more, all while executing tens or hundreds of times faster than any individual tool
	pipx install hydra # Stop Hard Coding in a Data Science Project, Use Config Files Instead
	pipx install cookiecutter # Structure a Data Science Project for Maintainability
	pipx install ocrmypdf
	#!/usr/bin/env bash
	# packages that aren't in any package manages. They are either
	# added to `apt` or installed manually

	### APT-added packages ###

	# Wez's Terminal emulator
	# SEE: https://wezfurlong.org/wezterm/install/linux.html#installing-on-ubuntu
	curl -fsSL https://apt.fury.io/wez/gpg.key \| sudo gpg --yes --dearmor -o /usr/share/keyrings/wezterm-fury.gpg
	echo 'deb [signed-by=/usr/share/keyrings/wezterm-fury.gpg] https://apt.fury.io/wez/ * *' \| sudo tee /etc/apt/sources.list.d/wezterm.list

	# Brave browser
	# SEE: https://brave.com/linux/#debian-ubuntu-mint
	sudo curl -fsSLo /usr/share/keyrings/brave-browser-archive-keyring.gpg https://brave-browser-apt-release.s3.brave.com/brave-browser-archive-keyring.gpg
	echo "deb [signed-by=/usr/share/keyrings/brave-browser-archive-keyring.gpg] https://brave-browser-apt-release.s3.brave.com/ stable main"\|sudo tee /etc/apt/sources.list.d/brave-browser-release.list

	# fastfetch, a neofetch and screenfetch drop-in replacement
	sudo add-apt-repository -y ppa:zhangsongcui3371/fastfetch

	# install
	sudo apt update
	sudo apt install -y wezterm-nightly brave-browser fastfetch

	### Others ###

	# deb-get
	# SEE: https://github.com/wimpysworld/deb-get#install
	curl -sL https://raw.githubusercontent.com/wimpysworld/deb-get/main/deb-get \| sudo -E bash -s install deb-get

	# LaTeX
	# TeX Live is available for Ubuntu and is in the Universe repository. This will install a basic subset of TeX Live's functionality. To install the complete TeX Live distribution, install texlive-full. Installing TeX Live directly does not interfere with Ubuntu, and ensures that you have the latest releases of all TeX and LaTeX packages. The downside is that you periodically have to update your installation manually, using the TeX Live Package Manager.
	#apt install -y texlive-full # latex from ubuntu
	# NOTE: https://www.tug.org/texlive/quickinstall.html
	(cd /tmp ; \
	wget https://mirror.ctan.org/systems/texlive/tlnet/install-tl-unx.tar.gz ; \
	zcat < install-tl-unx.tar.gz \| tar xf - ; \
	cd install-tl-*/ ; \
	sudo perl ./install-tl --no-interaction)
	sudo chown -R $USER:$USER /usr/local/texlive/ # change ownership to user
	# TODO: if the some packages fail, it prompts a message suggesting you to run
	# `tlmgr update --all --reinstall-forcibly-removed` to try to resintall them
	# you should create a return value handling to run it in case any package fails

	# jq: Command-line JSON processor
	curl --fail --location https://github.com/jqlang/jq/releases/latest/download/jq-linux-amd64 --output $HOME/.local/bin/jq
	chmod u+x $HOME/.local/bin/jq

	# xml2json
	(
	git clone https://github.com/Cheedoong/xml2json /tmp/xml2json
	cd /tmp/xml2json
	make
	mv xml2json $HOME/.local/bin
	)

	# rust
	# SEE: https://www.rust-lang.org/tools/install
	curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs \| sh -s -- -y
	source "${XDG_DATA_HOME}/cargo/env"

	exit 0