diff --git a/home/.chezmoiscripts/universal/run_onchange_after_40-chrome.tmpl b/home/.chezmoiscripts/universal/run_onchange_after_40-chrome.tmpl index 4202167c..50a5e956 100644 --- a/home/.chezmoiscripts/universal/run_onchange_after_40-chrome.tmpl +++ b/home/.chezmoiscripts/universal/run_onchange_after_40-chrome.tmpl @@ -1,5 +1,30 @@ {{- if ne .host.distro.family "windows" -}} #!/usr/bin/env bash +# @file run_onchange_after_40-firefox.tmpl +# @brief This script configures Chrome, Brave, and Chromium system-wide managed / recommended policies settings. It also pre-loads a configurable list of Chrome extensions to Chrome, Brave, Chromium, and Edge (if they are installed). +# @description +# This Chrome setup script applies system-wide settings and pre-loads Chrome extensions into the browser profiles. The +# extensions still must be enabled but they appear in the Chrome extensions menu and can be enabled with the toggle. The +# system settings are applied to Chrome, Chromium, and Brave. Extensions are installed to the same browsers plus Microsoft Edge. +# +# ## Features +# +# * Adds `~/.config/chrome/managed.json` to the `managed/policies.json` system locations +# * Adds `~/.config/chrome/recommended.json` to the `recommended/policies.json` system locations +# * Pre-loads extension metadata for all the extensions defined under `chromeExtensions` in the [`home/.chezmoidata.yaml`](https://github.com/megabyte-labs/install.doctor/blob/master/home/.chezmoidata.yaml) file +# +# ## TODO +# +# * Automatically enable the extensions that are pre-loaded +# * Create several profiles with different characteristics (similar to the Firefox setup script) +# * Ensure the directories that the script cycles through to install managed settings and extensions are complete for all installation types (i.e. there might need to be some additions for Flatpak installations since their folder structure is different) +# * Document how [`chromium-flags.conf`](https://github.com/megabyte-labs/install.doctor/blob/master/home/dot_config/chromium-flags.conf) can be or is integrated +# +# ## Links +# +# * [Script on GitHub](https://github.com/megabyte-labs/install.doctor/blob/master/home/.chezmoiscripts/universal/run_onchange_after_40-chrome.tmpl) +# * [`managed.json`](https://github.com/megabyte-labs/install.doctor/blob/master/home/dot_config/chrome/managed.json) +# * [`recommended.json`](https://github.com/megabyte-labs/install.doctor/blob/master/home/dot_config/chrome/recommended.json) {{ includeTemplate "universal/profile" }} {{ includeTemplate "universal/logg" }}