diff --git a/eos-apps-info/PKGBUILD b/eos-apps-info/PKGBUILD index 1a26b59b..05bd1a1a 100644 --- a/eos-apps-info/PKGBUILD +++ b/eos-apps-info/PKGBUILD @@ -2,7 +2,7 @@ pkgname=eos-apps-info pkgdesc="Documentation about apps in the EndeavourOS repository." -pkgver=24.6 +pkgver=24.6.1 pkgrel=1 arch=('any') license=('GPL') @@ -34,10 +34,10 @@ source=( sha512sums=('be26da9037149c7801d9aa075bcf9e7feefe82aeba583587acb61e3dbf8fb2ae16e055dbd40e4003104860944a336c6e908d43db963de37aff71c0ab01b9ee18' '264b2ce9f3981728bb45e52ab9d2ec782a5e9a291ca2b9249a5558529f4717c868545524677185cb5cc2f370f373818dd2c690fa79f1a107c34c65b3d6ea53a0' - '13d2d4cbe1be937512bb023e543efbc67be3ba04b78fb5af4fac05a76d7554edb6a249f5bc54bd63f675edfbd0c89034a3a502651a0c2d7c28be649528775b14' + '53e387eb1af9693dce6cc83636de399fc8ceedbce3e237c51c84e330766caec728808a2cf65ab653289b5da7c0648f47d17009f3e3669a15ddb0eb7772bae073' '8a0692ff5e714a0690c7a90d04a928b2edf2e01515f8707b345d0da36ee95cab7f4f9badf3dca6cbd280438a08519957c5852be92e7936da9f0affef3d895b17' '4b5eef3ce297cfa66d38b6ad92739eee905050228f72bd2c58d7f05700269b0ef434b0aa5c6ff8423a98af33918089f1255858bd2385ef3db2967d71e0d1d350' - '190a46697f6b6fd827528ac7d89198ba3fdf7a55c787b4d3e1ca762931931733b060e56670c1d07e85d74bb85b2a1f786ee8bbdcf98d585c4ebb9f8cae4675c6') + '0c72506bf26f8baf878df56c5f327de14093da5f52c1e1710e51f83d272d1a1221ee8ca3fcf345a6a79e40e7accc06c9179da23966ad3e72d975fb69b8acfeb3') package() { local xx diff --git a/eos-apps-info/eos-apps-info-collect b/eos-apps-info/eos-apps-info-collect index c53fcad1..e257a3ef 100755 --- a/eos-apps-info/eos-apps-info-collect +++ b/eos-apps-info/eos-apps-info-collect @@ -10,7 +10,6 @@ popd() { builtin popd "$@" >/dev/null ; } MakePicSmaller() { local picfile="$1" - # /usr/bin/convert "$picfile" -depth 3 "$picfile" /bin/magick "$picfile" -depth 3 "$picfile" } @@ -22,10 +21,7 @@ Md2html() { if [ "${dir::1}" = "/" ] ; then pkgbuildsdir="" else - case "$app" in - welcome) pkgbuildsdir=../../.. ;; # welcome src separated from PKGBUILD! - *) pkgbuildsdir=../.. ;; - esac + pkgbuildsdir=../.. [ -n "$dir" ] && dir="/$dir" fi mkdir -p $app @@ -175,13 +171,7 @@ Main() fi done - # direct pages - for app in akm eos-log-tool eos-rankmirrors pahis reflector-simple - do - Md2html $app - done - - # indirect via man folder + # pages in eos-apps-info/man folder pushd ../man local apps=(*) popd @@ -190,26 +180,6 @@ Main() Md2html $app $appname/man done - for app in checkupdatesext eos-update-notifier eos-update-notifier-configure - do - Md2html $app eos-update-notifier/man - done - - Md2html mirrorlist-rank-info reflector-simple/man - - #for app in nvidia-driver-supported-branches ; do - # Md2html $app nvidia-installer-common/man # does not exist? - #done - - # Md2html nvidia-installer-dkms nvidia-installer-dkms/man - Md2html welcome welcome/man - - # man page to html: no more needed... - #for app in #downgrade #yad # yay polybar inxi - #do - # Man2html $app - #done - # update the tar.gz archive cd .. local archive=${appname}-pages.tar.gz diff --git a/eos-apps-info/eos-apps-info-pages.tar.gz b/eos-apps-info/eos-apps-info-pages.tar.gz index 580a3c96..d279b931 100644 Binary files a/eos-apps-info/eos-apps-info-pages.tar.gz and b/eos-apps-info/eos-apps-info-pages.tar.gz differ diff --git a/eos-apps-info/man/akm/README.md b/eos-apps-info/man/akm/README.md new file mode 100644 index 00000000..08f4b565 --- /dev/null +++ b/eos-apps-info/man/akm/README.md @@ -0,0 +1,97 @@ +# akm +Simple kernel manager for EndeavourOS and Arch.
+Note: does not support kernels in the AUR. + +![](akm.png) + +## Usage +``` +akm [options] + +Options: + --connect-header Make kernel and header package go together at install or uninstall. + --small Make the akm window smaller, meant for helping with small displays at 1366x768 resolution. + --help | -h This help. +``` +Option `--scroll` (enables scrolling in the window) is also available, but it is enabled by default. + +## Options + +Without options, `akm` installs selected packages and uninstalls unselected packages.
+
+If option `--connect-header` is used, then `akm` ties kernel and header package into one atomic "unit" when installing or uninstalling.
+If selections of a kernel and its header conflict, kernel selection is used for both packages. +For example, if you only choose to install package `linux-zen` but not its header, option `--connect-header` would cause installing `linux-zen-headers` too. + +Option `--scroll` may be useful when using kernels from additional repositories. + +## Configuration file + +Configuration file `/etc/akm.conf` manages how `akm` works.
+Currently the supported configurations are: + +Variable | Description | Supported values +:--- | :--- | :--- +KERNEL_HEADER_WITH_KERNEL | Tie header package with the kernel package.
Does the same as option `--connect-header`. | "no" (=default) and "yes" +AKM_KERNELS_HEADERS | Additional kernel and header names. | List of `reponame/pkgname` entries. +AKM_WINDOW_WIDTH | Width of the `akm` window in pixels. | A positive number, default is 900. + +
+ +## Advanced example: add a new (unofficial) package repository + +You can add more (unofficial) package repositories into `/etc/pacman.conf`.
+If the repository contains linux kernel packages, `akm` tries to automagically add them to the list. + +The picture below shows `akm` window after adding the following unofficial repo: +``` +# NOTE: this particular repo is no more supported! + +[kernel-lts] +Server = https://repo.m2x.dev/current/$repo/$arch +``` + +
+ +![](akm-added-repo.png) + +### Caveat + +This method of automatically detecting kernel names is limited because kernels can be named in various ways.
+Use configuration variable AKM_KERNELS_HEADERS (mentioned above) to add a list of kernel and header names from an additional repository. This is useful if the automatic kernel name detection does not recognize certain kernel names. + +Just as an example, to use the info from the picture above, your `/etc/akm.conf` could look something like this: + +``` +#!/bin/bash + +### Config file for akm. + +# When installing/uninstalling a kernel, you may configure to +# install/uninstall the related header too. +# Values: "yes" or "no" +# Default: no +local KERNEL_HEADER_WITH_KERNEL=yes + +# List of kernel and header names when using additional repos. +# Example: +# local AKM_KERNELS_HEADERS=( +# reponame/linux-xxx reponame/linux-xxx-headers +# reponame/linux-yyy reponame/linux-yyy-headers +# ... +# ) +# where +# reponame The name of an additional repository. +# linux-xxx The name of a kernel. +# +local AKM_KERNELS_HEADERS=( + kernel-lts/linux-lts414 kernel-lts/linux-lts414-headers + kernel-lts/linux-lts419 kernel-lts/linux-lts419-headers + kernel-lts/linux-lts44 kernel-lts/linux-lts44-headers + # and so on... +) + +# Width of the akm window in pixels. +# Default: 900 +local AKM_WINDOW_WIDTH=1000 +``` diff --git a/eos-apps-info/man/akm/akm-added-repo.png b/eos-apps-info/man/akm/akm-added-repo.png new file mode 100644 index 00000000..b5c236b0 Binary files /dev/null and b/eos-apps-info/man/akm/akm-added-repo.png differ diff --git a/eos-apps-info/man/checkupdatesext/checkupdatesext.md b/eos-apps-info/man/checkupdatesext/checkupdatesext.md new file mode 100644 index 00000000..bca62df6 --- /dev/null +++ b/eos-apps-info/man/checkupdatesext/checkupdatesext.md @@ -0,0 +1,17 @@ +# checkupdatesext + +A`checkupdates` wrapper. Instead shows the updates with columnized layout and a header. + +![](checkupdatesext.png) + +## Synopsis + +``` +checkupdatesext +``` +## Returns +The same as `checkupdates`. + +## See also + +[checkupdates](https://man.archlinux.org/man/checkupdates.8) diff --git a/eos-apps-info/man/checkupdatesext/checkupdatesext.png b/eos-apps-info/man/checkupdatesext/checkupdatesext.png new file mode 100644 index 00000000..171fc35c Binary files /dev/null and b/eos-apps-info/man/checkupdatesext/checkupdatesext.png differ diff --git a/eos-apps-info/man/eos-log-tool/README.md b/eos-apps-info/man/eos-log-tool/README.md new file mode 100644 index 00000000..fe2099f4 --- /dev/null +++ b/eos-apps-info/man/eos-log-tool/README.md @@ -0,0 +1,22 @@ +# eos-log-tool +A GUI tool for copying various system logs to the internet. + +![](eos-log-tool.png) + +## Options + +Name | Description +:--- | :--- +`-j`
`--enable-journal` | Enable showing journal logs. Note that some logs *may* include personal data. +`-h`
`--help` | This help. + +## Use cases + +If a user wants help in troubleshooting an issue, with this tool user +can share logs for other users to see e.g. on the EndeavourOS forum.
+Note that without logs and/or other system information troubleshooting can be practically impossible. + +This tool aims to hide all personal information from the logs that will be sent to the internet. But hiding is not perfect (especially on journals), so it is a good idea to **Save logs locally** before sending. + +Button **Share logs to the internet** sends the logs to the internet, and an URL is returned after a successful send.
+This URL is the thing to share with those that help troubleshooting the issue. diff --git a/eos-apps-info/man/eos-log-tool/eos-log-tool.png b/eos-apps-info/man/eos-log-tool/eos-log-tool.png new file mode 100644 index 00000000..2c112ea6 Binary files /dev/null and b/eos-apps-info/man/eos-log-tool/eos-log-tool.png differ diff --git a/eos-apps-info/man/eos-rankmirrors/README.md b/eos-apps-info/man/eos-rankmirrors/README.md new file mode 100644 index 00000000..6982f9bc --- /dev/null +++ b/eos-apps-info/man/eos-rankmirrors/README.md @@ -0,0 +1,99 @@ +# eos-rankmirrors + +`eos-rankmirrors` ranks the mirrors that provide the EndeavourOS repository.
+ +## Synopsis +``` +eos-rankmirrors [options] +``` + +## Options +``` + --help, -h + This help. + + --ignore '' + Mirrors to be ignored from the result. + This is useful for e.g. ignoring non-functional mirrors. + The is a list of words separated by a pipe '|' character. + Each word should be a unique part of a mirror address. + Note that the list should be enclosed in single quotes + if it includes more than one word. + Example: + eos-rankmirrors --ignore='funami|accum|moson' + + --mirror-verbosity + How much information will be shown when a mirror fails. + Supported values: see file /etc/eos-rankmirrors.conf, setting + EOS_RANKMIRRORS_EXIT_CODE_VERBOSITY. + + --no-save, -n + Don't save the generated mirrorlist. + + --prefer '' + List of preferred mirrors. + Adds given mirror addresses as the first in the EndeavourOS mirrorlist. + The is as with option --ignore. + Example: + eos-rankmirrors --prefer='funami|accum|moson' + + --show-orig-list + Add the original mirror list into /etc/pacman.d/endeavouros-mirrorlist. + Supported values: yes, no. + Default: yes. + + --show-rank-info + Show the ranking data in /etc/pacman.d/endeavouros-mirrorlist. + Supported values: "yes" (default) or "no". + + --sort + Primary key for sorting the mirrors. + Supported key values: + age (latest first) + rate (fastest first) + Default: age. + + --timeout, -t + Set the timeout value (in seconds) for checking a mirror. + Default: 30. + + --use-local-mirrorlist + For testing purposes. + Uses information in local /etc/pacman.d/endeavouros-mirrorlist as the base for ranking. + + --verbose + Show more detailed output. + +Advanced options: + --list-only + Save only the mirrorlist without the ranking statistics. + + --mirror-add + Temporarily add a mirror URL for ranking (for testing purposes only). +``` +## Configuration + +### Configurable variables in file /etc/eos-rankmirrors.conf + +For detailed info, see the comments in file `/etc/eos-rankmirrors.conf`.
+ +Variable name | Default value | Description +:---- | :---- | :---- +EOS_AUTO_MIRROR_RANKING | no | Write the ranking result to file `/etc/endeavouros-mirrorlist`
or `/etc/endeavouros-mirrorlist.pacnew`. +EOS_AUTORANK_TIMEOUT | 30 | Timeout in seconds for each mirror to respond. +ALWAYS_FIRST_EOS_MIRRORS | `''` (an empty string) | A list of mirrors to set as first in the ranking result. +EOS_IGNORED_MIRRORS | () | Array of mirrors to ignore when ranking. +EOS_RANKMIRRORS_EXIT_CODE_VERBOSITY | show | How much information will be shown a mirror fails to rank.
Supported values: `all`, `code`, `show`, `none`.
See `/etc/eos-rankmirrors.conf` for more details. + + +Example: +``` +# Partial contents of file /etc/eos-rankmirrors.conf. +# Note: use bash syntax. + +EOS_AUTO_MIRROR_RANKING=no +EOS_AUTORANK_TIMEOUT=10 +ALWAYS_FIRST_EOS_MIRRORS='tsinghua|pizza|funami' +EOS_IGNORED_MIRRORS=(belnet accum jingk) +EOS_RANKMIRRORS_EXIT_CODE_VERBOSITY=none +``` diff --git a/eos-apps-info/man/eos-update-notifier-configure/eos-update-notifier-configure.md b/eos-apps-info/man/eos-update-notifier-configure/eos-update-notifier-configure.md new file mode 100644 index 00000000..739a5684 --- /dev/null +++ b/eos-apps-info/man/eos-update-notifier-configure/eos-update-notifier-configure.md @@ -0,0 +1,21 @@ +# eos-update-notifier-configure + +Manages and configures certain features of `eos-update-notifier` with a small GUI. + +![](eos-update-notifier-configure.png) + +## Synopsis +``` +eos-update-notifier-configure +``` +## Tips +Variable `EOS_SUDO_EDITORS` in configuration file +``` +/etc/eos-script-lib-yad.conf +``` +determines which editor will be used when editing the configuration file +``` +/etc/eos-update-notifier.conf +``` +after clicking the **Edit config** button above.
+Note that environment variables `SUDO_EDITOR`, `VISUAL`, or `EDITOR` can be used if `EOS_SUDO_EDITORS` is not set. diff --git a/eos-apps-info/man/eos-update-notifier-configure/eos-update-notifier-configure.png b/eos-apps-info/man/eos-update-notifier-configure/eos-update-notifier-configure.png new file mode 100644 index 00000000..936ae608 Binary files /dev/null and b/eos-apps-info/man/eos-update-notifier-configure/eos-update-notifier-configure.png differ diff --git a/eos-apps-info/man/eos-update-notifier/eos-update-notifier.md b/eos-apps-info/man/eos-update-notifier/eos-update-notifier.md new file mode 100644 index 00000000..4bf9fd64 --- /dev/null +++ b/eos-apps-info/man/eos-update-notifier/eos-update-notifier.md @@ -0,0 +1,30 @@ +# eos-update-notifier + +Checks the availability of package updates (EndeavourOS, Arch, and AUR), and offers to perform the actual update. + +## Synopsis +``` +eos-update-notifier [options] +``` +## Options +``` +-init Initialize the eos-update-notifier systemd service for + the current user. +-init-force Same as -init, but may overwrite existing user service files. +-conf Configure the schedule of checking for the updates. +-show-timer Show the status of the systemd timer. +-iw=X Initial sleep time. Value syntax from 'sleep' program. + Default: 5s. +-nw=X Max time (seconds) to show the "No updates available" window. + Default: 10. +-q Be quieter with dialogs. +--changelog Show the changelog of this package. +``` + +## Tips + +Configuration file: `/etc/eos-update-notifier.conf`. + +## See also + +[eos-update-notifier-configure](/etc/eos-apps-info/pageinfo/eos-update-notifier-configure/eos-update-notifier-configure.html) diff --git a/eos-apps-info/man/eos-welcome b/eos-apps-info/man/eos-welcome new file mode 120000 index 00000000..b6cbc2d1 --- /dev/null +++ b/eos-apps-info/man/eos-welcome @@ -0,0 +1 @@ +welcome \ No newline at end of file diff --git a/eos-apps-info/man/mirrorlist-rank-info/mirrorlist-rank-info.md b/eos-apps-info/man/mirrorlist-rank-info/mirrorlist-rank-info.md new file mode 100644 index 00000000..c90daf6a --- /dev/null +++ b/eos-apps-info/man/mirrorlist-rank-info/mirrorlist-rank-info.md @@ -0,0 +1,18 @@ +# mirrorlist-rank-info + +`mirrorlist-rank-info` shows up-to-date ranking information about the mirrors in file `/etc/pacman.d/mirrorlist`. + +![](mirrorlist-rank-info.png) + +## Synopsis +``` +mirrorlist-rank-info [options] +``` +## Options + +``` + --age Sorting precedence: 'age' over 'rate' + --rate Sorting precedence: 'rate' over 'age' + --help + -h Show this help +``` diff --git a/eos-apps-info/man/mirrorlist-rank-info/mirrorlist-rank-info.png b/eos-apps-info/man/mirrorlist-rank-info/mirrorlist-rank-info.png new file mode 100644 index 00000000..aacb0c5f Binary files /dev/null and b/eos-apps-info/man/mirrorlist-rank-info/mirrorlist-rank-info.png differ diff --git a/eos-apps-info/man/pahis/README.md b/eos-apps-info/man/pahis/README.md new file mode 100644 index 00000000..89edd795 --- /dev/null +++ b/eos-apps-info/man/pahis/README.md @@ -0,0 +1,34 @@ +# pahis +Show pacman history for all or selected packages. + +## Usage +Run command +
+pahis --help
+
+about how to use it.
+Note: you can use bash completion (tab) to complete a partial words and options! + +Examples: +
+pahis --upgraded           # shows upgrades of all packages
+pahis --upgraded firefox   # shows when firefox was upgraded
+pahis geany                # shows all operations on geany
+pahis --removed            # shows removals of packages
+pahis -installed           # shows installs of packages
+pahis --Running            # shows pacman commands used
+
+ +## Screenshots after commands +
+pahis
+
+![pahis](pahis1.png) +
+pahis --upgraded
+
+![](pahis2.png) +
+pahis --upgraded firefox
+
+![](pahis3.png) diff --git a/eos-apps-info/man/pahis/pahis1.png b/eos-apps-info/man/pahis/pahis1.png new file mode 100644 index 00000000..94e961bc Binary files /dev/null and b/eos-apps-info/man/pahis/pahis1.png differ diff --git a/eos-apps-info/man/pahis/pahis2.png b/eos-apps-info/man/pahis/pahis2.png new file mode 100644 index 00000000..65eea861 Binary files /dev/null and b/eos-apps-info/man/pahis/pahis2.png differ diff --git a/eos-apps-info/man/pahis/pahis3.png b/eos-apps-info/man/pahis/pahis3.png new file mode 100644 index 00000000..afd071be Binary files /dev/null and b/eos-apps-info/man/pahis/pahis3.png differ diff --git a/eos-apps-info/man/reflector-simple/README.md b/eos-apps-info/man/reflector-simple/README.md new file mode 100644 index 00000000..bda6f325 --- /dev/null +++ b/eos-apps-info/man/reflector-simple/README.md @@ -0,0 +1,49 @@ +# reflector-simple + +Simple GUI for the `reflector` command.
+Screenshot:
+ +![](reflector-simple.png) + +## Notes about configuration of reflector-simple + +- configuration file `/etc/reflector-simple.conf` is supported +- if `/etc/reflector-simple.conf` exists, the GUI uses it by default +- configuration file can contain options supported by the `reflector` command. Use command `reflector -h` for more info + +### Additional old compatibility notes +- for backwards compatibility, configuration file `/etc/reflector-auto.conf` is still supported, but will no more be supported after year 2020. +- if file `/etc/reflector-simple.conf` exists, then `/etc/reflector-auto.conf` is not used + +## Operational changes + +Version 1.15.2-1 changed `reflector-simple` by changing the setting **Max number of mirrors** (which uses reflector's --number option) to **Max number of freshed mirrors** (uses reflector's --latest option). + +The old behaviour can be achieved by using an environment variable `REFLECTOR_SIMPLE_PREFER_NUMBER` with value "yes", e.g. +``` +REFLECTOR_SIMPLE_PREFER_NUMBER=yes reflector-simple +``` + +Version 1.16.1-1 changed the method of finding the country code of a user. Now user can change the value of variable `REFLECTOR_SIMPLE_COUNTRY_METHOD` in file `/etc/reflector-simple-tool.conf` and see what's the best (=fastest) method (number from 0 to 5) of fetching the country code. This may have a great effect on how quickly `reflector-simple` shows its first window when started. + +## Tips + +- import reflector options from another configuration file with a normal `reflector` syntax: `@/path/to/another/config.conf` +- to exclude a country from ranking, use option `--country-exclude` (this option is not found in `reflector`) + +### Example configuration file +``` +# A part of file /etc/reflector-simple.conf: + +# ... + +@/etc/reflector_excludes.conf +-c DE,FR,"United Kingdom" +--country-exclude LU + +# ... +``` + +## See also + +[reflector(1)](https://man.archlinux.org/man/reflector.1) diff --git a/eos-apps-info/man/reflector-simple/reflector-simple.png b/eos-apps-info/man/reflector-simple/reflector-simple.png new file mode 100644 index 00000000..3163e0f1 Binary files /dev/null and b/eos-apps-info/man/reflector-simple/reflector-simple.png differ diff --git a/eos-apps-info/man/welcome/welcome-man.png b/eos-apps-info/man/welcome/welcome-man.png new file mode 100644 index 00000000..1d44c4e4 Binary files /dev/null and b/eos-apps-info/man/welcome/welcome-man.png differ diff --git a/eos-apps-info/man/welcome/welcome.md b/eos-apps-info/man/welcome/welcome.md new file mode 100644 index 00000000..c8b47085 --- /dev/null +++ b/eos-apps-info/man/welcome/welcome.md @@ -0,0 +1,158 @@ +# welcome (also: eos-welcome) + +Welcome is an application that helps users by providing +- tools for system management and customization +- links for additional information + +and more. + +Welcome has two main uses: +- helps in the install phase +- helps in the system usage phase + +
+ +![](welcome-man.png) + +## Synopsis + +eos-welcome [options] + +## Options +``` +--enable | -f Enable this Welcome app. +--disable Disable this Welcome app. +--once | -1 Allow to run Welcome even if disabled. +--lang=X Use language X on the user interface. Default for X: 'en' +--version Show the version of this app. +--startdelay=X Wait before actually starting this app. + X value syntax is the same as in the 'sleep' command. +--changelog Show the changelog of this package. + +``` + +## Description + +### Enabling or disabling Welcome + +To have Welcome app started when you log in, make sure +- Welcome app is selected in the Autostart feature of the DE
+ or +- `Hidden=false` is set in file `/etc/xdg/autostart/welcome.desktop` + +On DEs that do not work well with system's *Autostart* feature, you may also disable the Welcome app from the app itself +- with the `--disable` option +- with a button in the app (some DEs only) + +To re-enable the app, click the Welcome app icon, or use the terminal command +``` +eos-welcome --enable +``` + +To run Welcome *once* even if it is already disabled, use option `--once`: +``` +eos-welcome --once +``` +Welcome will stay disabled after using option `--once`. + + +Note: check also settings in the configuration file `~/.config/EOS-greeter.conf`. + +### Personalizing Welcome + +User may add own buttons into the Welcome app. The buttons will appear under the **Personal Commands** tab. + +### Language support + +Option `--lang=X` currently supports a small set of languages.
+The X should consist of two (or more) letters (like 'en' for English or 'pt_BR' for Brazilian Portuguese). + +See the supported languages (the X) e.g. by terminal command +``` +ls -1 /usr/share/endeavouros/scripts/translation-*.bash | \ + sed 's|.*/translation-\([a-zA-Z_]*\)\.bash|\1|' +``` +If option `--lang` is not given, the language value is extracted from +the first letters of the environment variable LANG.
+If the extracted value is not supported by Welcome, English will be used. + +## Tips + +### Software news + +Welcome app window includes a button **Software News** on the lower left corner.
+It contains useful and important news for the user about the EndeavourOS software, e.g. manual interventions or important code changes. + +Make sure you click that button regularly! + +### Critical info area + +Welcome has an info area for critical or very important news near the upper edge of the window.
This will used for the uttermost important messages that affect all or most EndeavourOS users.
When this area contains text, it is a very good idea to read it! + +### Add favorite packages at install time + +To customize the *online* mode install phase, you can directly modify file `$HOME/user_pkglist.txt` and add package names to that file. Note that only Arch and EndeavourOS packages are supported, but not AUR packages. + +### Add commands at install time (*Advanced*) + +To customize the *online* mode install phase, you can directly modify file
+``` +/home/liveuser/user_commands.bash +``` +and add almost any commands to that file. See more instructions in this file. + +Examples of things you can do with the commands in `user_commands.bash`: +- install or remove packages +- enable or disable systemd services +- customize new user's personal files at $HOME +- and more! + +Here's an example code for `user_commands.bash`. It will be called with the bash interpreter, so it must have bash syntax: +``` +#!/bin/bash + +pacman -R --noconfirm xed # uninstall packages +pacman -S --noconfirm --needed geany gufw # install packages +systemctl enable ufw # enable a systemd service + +user=$(cat /tmp/new_username.txt) # get the new username! +home=/home/$user # get the $HOME folder path +if [ "$user" != "" ] ; then + cat <> $home/.bashrc # add more configuration to your ~/.bashrc + +alias pacdiff=eos-pacdiff +alias df='df -hT' + +EOF +chown $user:$user $home/.bashrc # make sure ~/.bashrc has the right owner +fi +``` +Yet another tip: download *your* `user_commands.bash` from your website! For example: +``` +$ pwd +/home/liveuser +$ wget -O user_commands.bash https:///user_commands.bash +``` + +Examples of commands that *cannot* be used here: +- yay +- makepkg + + +## Examples +``` +eos-welcome --lang=en # use English instead of the local language +eos-welcome --disable # disable Welcome from starting automatically +eos-welcome --enable # re-enable Welcome after disabling it + +# Adding packages at install. Close Welcome app first, then commmand: + +cat <> ~/user_pkglist.txt + gufw + emacs +EOF +eos-welcome & +``` +## See also + +https://discovery.endeavouros.com/endeavouros-tools/welcome