Knowledge Base (Posts about script)

Git clone and/or pull

bgstack15 — Thu, 19 Feb 2026 14:25:00 GMT

I heavily adapted a function generated by a Copyright Expunging Engine. Here is my function for easily cloning/pulling a git remote.

files/2026/listings/ginit.sh (Source)

ginit() {
    err() {
        printf '%s\n' "${@}" 1>&2
    }
    err "# ginit ${*}"
    ( # parenthesis to suppress the cd
        if test "${#}" -lt 1 ;
        then
            err "Usage: ginit <repository_url> [branch_name] [dirname]"
            return 1
        fi
        REPO_URL="${1}"
        REPO_DIR="$( basename "${REPO_URL}" .git )"
        BRANCH_NAME="${2}"
        DIRNAME="${3}"
        if test -n "${DIRNAME}" ; then REPO_DIR="${DIRNAME}" ; fi
        if test -d "${REPO_DIR}" ;
        then
            err "Directory ${REPO_DIR} already exists. Changing directory to it."
            cd "${REPO_DIR}" || return
            if test -n "${BRANCH_NAME}" ;
            then
                err "Switching to branch ${BRANCH_NAME}"
                git fetch --all
                # my old redirect trick to filter stderr
                {
                    {
                        # Use 'git switch' (modern) or 'git checkout' (older versions)
                        # 'git switch -c' creates and switches to a new branch if it doesn't exist locally
                        git switch -c "${BRANCH_NAME}" "origin/${BRANCH_NAME}" || \
                            git checkout -b "${BRANCH_NAME}" "origin/${BRANCH_NAME}" || \
                            git checkout "${BRANCH_NAME}"
                    } 2>&1 1>&3 | sed -r -e '/fatal: a branch named.*already exists/d' 1>&2
                } 3>&1
            fi
        else
            if test -n "${BRANCH_NAME}" ;
            then
                err "Cloning branch ${BRANCH_NAME} into ${REPO_DIR}"
                git clone -b "${BRANCH_NAME}" "${REPO_URL}" "${REPO_DIR}"
            else
                err "Cloning default branch into ${REPO_DIR}"
                git clone "${REPO_URL}" "${REPO_DIR}"
            fi
            if test -d "${REPO_DIR}" ;
            then
                cd "${REPO_DIR}" || return
                git pull
                err "Changed directory to ${REPO_DIR}"
            else
                err "Failed to clone repository"
                return 1
            fi
        fi
    )
}

Initialize Mineclonia git repo

bgstack15 — Sun, 15 Feb 2026 16:29:00 GMT

I was testing my latest build of mineclonia dpkg which bundles the latest halon luanti client with the latest mineclonia game itself.

I wanted to start fresh, so I wiped the .minetest directory, and whipped up a script to bootstrap all the mods.

I also realized I should mirror all the repositories of projects I care about, in case they disappear from the Internet, but I haven't automated that process yet.

files/2026/listings/initialize-mineclonia.sh (Source)

#!/bin/sh
# File: initialize-mineclonia.sh
# Location: http://server3/git/luanti/initialize-mineclonia/
# Author: bgstack15
# Startdate: 2026-01-25-1 10:03
# Title:
# Project: initialize-mineclonia
# Purpose: Turn https://bgstack15.ddns.net/blog/posts/2025/12/01/my-necessary-luanti-mods-for-mineclonia/ into a shell script
# Usage:
#     Run this after `apt-get install mineclonia`
# References:
#    https://bgstack15.ddns.net/cgit/luanti/mineclonia-dpkg/tree/debian/README.debian
#    Dpkg from https://bgstack15.ddns.net/blog/posts/2025/09/28/package-for-devuan-mineclonia/
# Improve:
#    Save down all non-cgit code in case it disappears upstream. Update my-necessary-luanti-mods-for-mineclonia.md to offer the backup local repos.
# Dependencies:
#     sudo apt-get install mineclonia

mineclonia_repo="https://codeberg.org/mineclonia/mineclonia"
host="http://server3/git"

ginit() {
    echo "# ginit ${@}" 1>&2
    (
    # from google AI "function to git clone or cd and change branch" and adapted 2026-01-25-1 10:43
    # Check if correct number of arguments are provided (URL and optionally branch name)
    if [ "$#" -lt 1 ]; then
        echo "Usage: ginit <repository_url> [branch_name] [dirname]"
        return 1
    fi
    REPO_URL=$1
    # Extract repository name from URL (simple heuristic for common Git URLs)
    REPO_DIR=$(basename "$REPO_URL" .git)
    BRANCH_NAME=$2
    DIRNAME=$3
    if test -n "${DIRNAME}" ; then REPO_DIR="${DIRNAME}" ; fi
    if [ -d "$REPO_DIR" ]; then
        echo "Directory $REPO_DIR already exists. Changing directory to it."
        cd "$REPO_DIR" || return # Change directory
        if [ -n "$BRANCH_NAME" ]; then
            echo "Switching to branch $BRANCH_NAME"
            git fetch --all
            # Use 'git switch' (modern) or 'git checkout' (older versions)
            # 'git switch -c' creates and switches to a new branch if it doesn't exist locally
            git switch -c "$BRANCH_NAME" "origin/$BRANCH_NAME" || git checkout -b "$BRANCH_NAME" "origin/$BRANCH_NAME" || git checkout "$BRANCH_NAME"
        fi
    else
        # Clone the repository with the specified branch (if provided)
        if [ -n "$BRANCH_NAME" ]; then
            echo "Cloning branch $BRANCH_NAME into $REPO_DIR"
            git clone -b "$BRANCH_NAME" "$REPO_URL" "${REPO_DIR}"
        else
            echo "Cloning default branch into $REPO_DIR"
            git clone "$REPO_URL" "${REPO_DIR}"
        fi
        # Change directory into the cloned repository
        if [ -d "$REPO_DIR" ]; then
            cd "$REPO_DIR" || return
            git pull
            echo "Changed directory to $REPO_DIR"
        else
            echo "Failed to clone repository or directory name $REPO_DIR is different from heuristic."
            return 1
        fi
    fi
    )
}

# Mineclonia game itself
install_mineclonia() {
    mkdir -p ~/.minetest/games ; cd ~/.minetest/games
    ginit "${mineclonia_repo}" 0.119.0 mineclonia
}

# Mods
install_mods() {
    mkdir -p ~/.minetest/mods ; cd ~/.minetest/mods
    ginit "${host}/luanti/enchantments_extractor" dev
    ginit "${host}/luanti/enchantments_workbench"
    ginit "${host}/luanti/farmtools" feature/fix-warnings
    ginit "${host}/luanti/minetest_inventory_icon" feature/add-pouches inventory_icon
    ginit "${host}/luanti/inventory_pouches" combined
    ginit "${host}/luanti-readonly/minetest-k-ambient-light" "main" k_ambient_light
    ginit "${host}/luanti-readonly/minetest-k-recycler" "main" k_recycle_bin
    ginit "${host}/luanti/lava_furnace" feature/support-voxelibre
    ginit "${host}/luanti-readonly/leads" main
    ginit "${host}/luanti/list_to_file" dev/add_list_items_to_file
    ginit "${host}/luanti-readonly/mapserver_mod" "" mapserver
    ginit "${host}/luanti/mcl_chiseled_bookshelf"
    ginit "${host}/luanti/mcl_colored_chests"
    ginit "${host}/luanti-readonly/mcl_copper_stuff"
    ginit "${host}/luanti/mcl_cozy"
    ginit "${host}/luanti-readonly/mcl_decor"
    ginit "${host}/luanti/mcl_emerald_stuff" main
    ginit "${host}/luanti/mcl_lapis_stuff"
    ginit "${host}/luanti/mcl_misk_recipes" main
    ginit "${host}/luanti/mcl_morefood" feature/add-applesauce
    ginit "${host}/luanti/milk_potion"
    ginit "${host}/luanti/molten_sailor_mcl"
    ginit "${host}/luanti/mtimer" feature/add-biome
    ginit "${host}/luanti-readonly/mtui_mod"
    ginit "${host}/luanti/obsidian_extra"
    ginit "${host}/luanti-readonly/playerlist" main
    ginit "${host}/luanti-readonly/minetest_poi" "" poi
    ginit "${host}/luanti/privs_per_world"
    ginit "${host}/luanti/mt-respawn" dev/add-dialog respawn
    ginit "${host}/luanti/safe_chest" dev/support-mineclonia
    ginit "${host}/luanti-readonly/snippets"
}

install_config() {
    # use LUANTI_CONFIG if defined, otherwise, use from directory where this script is stored.
    tf="${LUANTI_CONFIG:-${_td}/minetest.conf}"
    if test -f "${tf}" ;
    then
        echo "Installing luanti config ${tf}. You can use env var LUANTI_CONFIG to override." 1>&2
        cp -pf "${tf}" ~/.minetest/
    fi
}

_td="$( dirname "$( readlink -f "${0}" )" )"

main() {
    install_mineclonia
    install_mods
    install_config
}

# BEGIN IS-SOURCED
sourced=0
if [ -n "$ZSH_VERSION" ]; then 
   case $ZSH_EVAL_CONTEXT in *:file) sourced=1;; esac
elif [ -n "$KSH_VERSION" ]; then
   [ "$(cd -- "$(dirname -- "$0")" && pwd -P)/$(basename -- "$0")" != "$(cd -- "$(dirname -- "${.sh.file}")" && pwd -P)/$(basename -- "${.sh.file}")" ] && sourced=1
elif [ -n "$BASH_VERSION" ]; then
   (return 0 2>/dev/null) && sourced=1 
else # All other shells: examine $0 for known shell binary filenames.
   # Detects `sh` and `dash`; add additional shell filenames as needed.
   case ${0##*/} in sh|-sh|dash|-dash) sourced=1;; esac
fi
# END BEGIN IS-SOURCED

if ! test "${sourced}" = "1" ;
then
    main
fi

Geeqie, open the file I said

bgstack15 — Wed, 11 Feb 2026 13:54:00 GMT

While Geeqie is not better than Irfanview, it is native and I've been trying to live with FLOSS. Somehow during the past few years Geeqie has gotten slightly broken and does not always open the exact file I opened from a file manager. So I dug deep enough to fix my problem.

Apparently there is a parameter to open the specific file.

--file=<FILE>|<URL>
    open FILE or URL bring Geeqie window to the top

And of course /usr/share/applications/org.geeqie.Geeqie.desktop (because geeqie.desktop wasn't good enough) does not include that in the Exec line.

Exec=geeqie %F

The spec is a list of files. So perhaps I should have updated the desktop file to call my script, but all I did was write a new script for xfe to associate with the image filetypes.

	`#!/bin/sh`
	`# File: ~/bin/geeqie1`
	`# Startdate: 2026-01-23-6 10:17`
	`# Purpose: fix geeqie so that it points directly to the file it was requested to open with`
	`# Reference:`
	`# man geeqie`
	`for i in "${@}" ;`
	`do`
	`opts="${opts} --file=\"${i}\""`
	`done`
	`eval geeqie "${opts}"`

And then I told xfe to open .jpg, .png, and so on with ~/bin/geeqie1.

Find exact tag of Docker image

bgstack15 — Fri, 25 Apr 2025 12:37:00 GMT

I had a number of old docker images stored locally and didn't have all the tag info. I think I used ":latest" on most of them, but apparently calling an image that does not mean that every time the container restarts (at host reboot), it fetches the latest one. So some of my images were woefully behind, and as part of a good practice to upgrade to current images for everything, I wanted to know exactly which image I had before, in case I need to roll back.

And apparently there's not a good process for determining that. So I had to write a script to do it for me. And then I had to hack it to work with github container registry which operates differently than docker hub, in this case not as efficiently as docker hub.

We'll start with the script and then I'll explain it.

Lego Universe autologin

bgstack15 — Wed, 23 Oct 2024 12:59:00 GMT

I got tired of my Lego Universe game crashing, and having to type my username/password in again. This is not a shared machine, so I wrote a small utility to handle logging in for me.

The first time you use it, it will prompt for username and password. You can trigger this prompting again with parameter --login.

To simulate the clicks and key presses, use parameter --apply.

files/2024/listings/autologin-lego-universe.sh (Source)

	`#!/bin/sh`
	`# File: autologin-lego-universe.sh`
	`# Location: /mnt/public/Games/lego-universe/`
	`# Author: bgstack15`
	`# SPDX-License-Identifier: GPL-3.0-only`
	`# Startdate: 2024-10-07-2 15:26`
	`# Title Autologin for Lego Universe client`
	`# Purpose: Given a username and password, auto log in to the Lego Universe/Darkflame client`
	`# History:`
	`# Usage:`
	`# Env vars:`
	`# APPLY`
	`# Parameters:`
	`# --login Change username and password in conf file`
	`# --apply Actually run automation`
	`# Reference:`
	`# https://stackoverflow.com/questions/2683279/how-to-detect-if-a-script-is-being-sourced/28776166#28776166`
	`# man xdotool, yad`
	`# Improve:`
	`# This is slightly buggy. The longer the delays in typing and between tasks, the better it runs.`
	`# This is only tested against 1920x1080`
	`# Dependencies:`
	`# dep-devuan: xdotool, yad`
	`# Lego Universe already running! This script does not know how long it takes to load the username prompt in the game.`
	`# Documentation:`

	`# variables`
	`CONFFILE=~/.config/autologin-lego-universe.conf`

	`autologin_lego_universe() {`
	`# pixel offset, only tested against 1920x1080`
	`_type_delay_ms=60`
	`_step_delay_s=0.3`
	`_y_offset_username_field=50`
	`_loop_max_safety=10`
	`_tmpfile1="$( mktemp )" ; rm "${_tmpfile1}"`
	`# needs env vars: USERNAME, PASSWORD`
	`# step 0: find window that matters`
	`_x=0`
	`while test ! -f "${_tmpfile1}" ;`
	`do`
	`printf '%s ' "Loop ${_x}" 1>&2`
	`WINDOWID="$( xdotool search "Lego Universe - " )"`
	`test -n "${WINDOWID}" && touch "${_tmpfile1}"`
	`sleep 0.5 ;`
	`_x=$(( _x + 1 ))`
	`test ${_x} -ge ${_loop_max_safety} && { echo "Fatal! Safety valve: could not find game window after 20 loops. Aborting." 1>&2 ; rm -f "${_tmpfile1:-NOTHINGTODEL}" 1>/dev/null 2>&1 ; return 1 ; }`
	`done`
	`echo "Found WINDOWID=${WINDOWID}"`
	`rm -f "${_tmpfile1:-NOTHINGTODEL}"`
	`# step 0: bring game window to top. This does not work for me, but maybe it works for somebody else.`
	`xdotool windowactivate --window "${WINDOWID}" windowfocus --window "${WINDOWID}"`
	`# step 1: move mouse to username field`
	`xdotool mousemove --window "${WINDOWID}" $(( 1920 / 2 )) $(( 1080 / 2 - ${_y_offset_username_field} ))`
	`# step 2: enter username`
	`xdotool click 1 sleep "${_step_delay_s}" click 1 key ctrl+a type --delay "${_type_delay_ms}" "${USERNAME}"`
	`# step 3: move to password field`
	`xdotool sleep "${_step_delay_s}" key Tab`
	`# step 4: enter password`
	`xdotool sleep "${_step_delay_s}" sleep "${_step_delay_s}" type --delay "${_type_delay_ms}" "${PASSWORD}"`
	`# step 5: press enter`
	`xdotool sleep "${_step_delay_s}" key Return`
	`}`

	`save_field() {`
	`# usage: save_field USERNAME`
	`_field="${1}"`
	`# no error handling. Do not mess up save_field!`
	`case "${_field}" in`
	`USERNAME)`
	`_yad_opts='--text Username'`
	`_default="${USERNAME}"`
	`;;`
	`PASSWORD)`
	`_yad_opts='--hide-text --text Password'`
	`set -x`
	`_default="${PASSWORD}"`
	`;;`
	`*)`
	`echo "Error! save_field ${@} is invalid. Needs USERNAME or PASSWORD. Continuing..." 1>&2`
	`return 1`
	`;;`
	`esac`
	`# do not quote _yad_opts on next line.`
	`result="$( yad ${_yad_opts} --entry --entry-text "${_default}" --title "Autologin for Lego Universe" )"`
	`_response_code=$?`
	`# write to file`
	`if test 0 -eq ${_response_code} ;`
	`then`
	`sed -i -r -e "/^${_field}=/d" "${CONFFILE}"`
	`echo "${_field}=\"${result}\"" >> "${CONFFILE}"`
	`else`
	`yad --text "Action cancelled."`
	`fi`
	`set +x`
	`unset _default _response_code`
	`}`

	`# if dot-sourced, run main`
	`# BEGIN IF-DOT-SOURCED, so 2683279`
	`sourced=0`
	`if [ -n "$ZSH_VERSION" ]; then`
	`case $ZSH_EVAL_CONTEXT in *:file) sourced=1;; esac`
	`elif [ -n "$KSH_VERSION" ]; then`
	`[ "$(cd -- "$(dirname -- "$0")" && pwd -P)/$(basename -- "$0")" != "$(cd -- "$(dirname -- "${.sh.file}")" && pwd -P)/$(basename -- "${.sh.file}")" ] && sourced=1`
	`elif [ -n "$BASH_VERSION" ]; then`
	`(return 0 2>/dev/null) && sourced=1`
	`else # All other shells: examine $0 for known shell binary filenames.`
	# Detects `sh` and `dash`; add additional shell filenames as needed.
	`case ${0##*/} in sh\|-sh\|dash\|-dash) sourced=1;; esac`
	`fi`
	`# END IF-DOT-SOURCED`

	`if test "${sourced}" = "0" ;`
	`then`
	`test -f "${CONFFILE}" && . "${CONFFILE}"`
	`unset _reload`
	`if test -z "${USERNAME}" \|\| echo " ${@} " \| grep -qE " --login " ; then save_field USERNAME ; _reload=1 ; fi`
	`if test -z "${PASSWORD}" \|\| echo " ${@} " \| grep -qE " --login " ; then save_field PASSWORD ; _reload=1 ; fi`
	`echo " ${@} " \| grep -qE " --apply " && APPLY=1`
	`test -n "${_reload}" && test -f "${CONFFILE}" && . "${CONFFILE}"`
	`# If you want to be more basic:`
	`#test -z "${USERNAME}" && { echo "Fatal! Need env var USERNAME. Aborted." 1>&2 ; exit 1 ; }`
	`#test -z "${PASSWORD}" && { echo "Fatal! Need env var PASSWORD. Aborted." 1>&2 ; exit 1 ; }`
	`unset _reload`
	`test -n "${APPLY}" && autologin_lego_universe ;`
	`fi`

And you can set your desktop shortcut to run this script then:

files/2024/listings/run-lego-universe-and-autologin.sh (Source)

	`#!/bin/sh`
	`# Startdate: 2024-10-08-3 14:30`
	`# Purpose: run Lego Universe, and then wait a few seconds, and then auto login.`
	`legouniverse_script="$( find ~/.wine* -iname lego-universe.sh -print -quit )"`
	`"${legouniverse_script}" &`
	`# Hopefully this is long enough`
	`sleep 10`
	`# This if-dot-sourcing does not work so just go ahead and call it dot-sourced and then call the relevant function.`
	`. /mnt/public/Games/lego-universe/autologin-lego-universe.sh`
	`autologin_lego_universe`

My newer-in-debian script

bgstack15 — Tue, 30 Jan 2024 13:32:51 GMT

I wanted to use the really cool repology.org site to help track the packages I maintain in Devuan, so I don't get too behind. LeePen feels obligated to tell me when I'm behind, and that shouldn't be his job; I should be doing a better job.

So I wrote this script I can run whenever I feel like it.

files/2024/listings/newer-in-debian.sh (Source)

#!/bin/sh
# File: newer-in-debian.sh
# Location: /mnt/public/Support/Programs/repology.org/
# Author: bgstack15
# Startdate: 2023-12-28-5 17:42
# SPDX-License-Identifier: GPL-3.0-only
# Title: Newer in Debian script
# Purpose: List newer packages in debian than devuan that I maintain
# History:
# Usage: ./newer-in-debian.sh
# Reference:
#    https://stackoverflow.com/questions/5947742/how-to-change-the-output-color-of-echo-in-linux
#    https://repology.org/projects/?maintainer=bgstack15@gmail.com&inrepo=devuan_unstable&newest=1
# Improve:
# Dependencies:
#    req-devuan: jq, curl, devscripts
#    req-raw: jq, curl, rmadison
# Documentation: read repology

# CONFIG
test -z "${CACHE_DIR}" && CACHE_DIR="${XDG_CACHE_DIR:-${HOME}/.cache}"
test -z "${CACHE_FILE}" && CACHE_FILE="${CACHE_DIR}/newer-in-debian.cache"
test -z "${EMAIL}" && EMAIL=bgstack15@gmail.com
test -z "${RMADISON_URL_MAP_DEVUAN}" && export RMADISON_URL_MAP_DEVUAN=https://api.pkginfo.devuan.org/madison
BAD_COLOR='\033[0;31m' # red
GOOD_COLOR='\033[0;32m' # green
NEUTRAL='\033[0m' # no color

# CACHE OPERATIONS
# invalidate cache older than 23 hours
_cache_is_too_old="$( find "${CACHE_FILE}" -maxdepth 0 -mmin +$(( 60 * 23 )) -print -quit 2>/dev/null )"
test -n "${_cache_is_too_old}" && rm "${CACHE_FILE:-NOTHINGTODEL}"
test -n "${CLEAR_CACHE}" && rm "${CACHE_FILE:-NOTHINGTODEL}"

# test and rebuild cache if necessary
_cache_contents="$( cat "${CACHE_FILE}" 2>/dev/null )"
test -z "${_cache_contents}" && {
   curl --silent --header 'User-Agent: bgstack15-cli' "https://repology.org/api/v1/projects/?maintainer=${EMAIL}&inrepo=devuan_unstable" > "${CACHE_FILE}"
   _cache_contents="$( cat "${CACHE_FILE}" 2>/dev/null )"
} || {
   printf '%s\n' "Using cached package list." 1>&2
}

# if cache is still empty, then something broke with curl statement.
test -z "${_cache_contents}" && {
   printf '%s\n' "Fatal! Cache is still empty. Re-run with debugging. Aborted." 1>&2
   exit 1
}

# FUNCTIONS
_check_status() {
   package="${1}"
   # this only uses amd64. If I ever change personal architectures that I care about, I would need to update this.
   # The purpose is to avoid the "source" listing, which might not be the same version as a built architecture, due to binary repacks, e.g., lightdm_1.32.0-4+b1 in debian.
   # --source-and-binary converts "freeipa" source into "freeipa-client" amd64, and a few others but since the versions are all the same we just take the first one (head -n1)
   _deb="$( rmadison              --source-and-binary --architecture=amd64 --suite unstable "${package}" | awk -F'|' '{print $2}' | head -n1 | xargs | sed -r -e 's/\+b[1-9]$//;' )" ;
   # only do anything if the package exists in Debian.
   if test -n "${_deb}" ;
   then
      _dev="$( rmadison --url devuan --source-and-binary --architecture=amd64 --suite unstable "${package}" | awk -F'|' '{print $2}' | head -n1 | xargs | sed -r -e 's/\+b[1-9]$//;' )" ;
      _result="${BAD_COLOR}BAD${NEUTRAL}"
      echo "${_dev}" | grep -qE "${_deb}\+?devuan-?[0-9]" && {
         _result="${GOOD_COLOR}good${NEUTRAL}"
      }
      printf '%4b\t%s\t%s\t%s\n' "${_result}" "${package}" "${_deb}" "${_dev}"
   else
      printf '%4s\t%s\t\n' "none" "${package}" 1>&2
   fi
}

# MAIN
_package_list="$( <"${CACHE_FILE}" jq --raw-output 'keys[]' )"
# do not double-quote variable in next line with the for statement.
for package in ${_package_list} ;
do
   if test -n "${PARALLEL}" ;
   then
      _check_status "${package}" &
   else
      _check_status "${package}"
   fi
done
test -n "${PARALLEL}" && {
   wait
}

I use cache invalidation (which I hear is hard; I hope I did it right!). The web url is https://repology.org/projects/?maintainer=bgstack15@gmail.com&inrepo=devuan_unstable&newest=1. Some of these are original packages and don't have an upstream from Debian.

$ ./newer-in-debian.sh 
good    freeipa 4.10.2-2    4.10.2-2devuan1
good    lightdm 1.32.0-4    1.32.0-4devuan1
good    oddjob  0.34.7-2    0.34.7-2devuan1
none    pam-mkhomedir   
none    sgm 
none    systemctl-service-shim

I even added colors, and parallelization (but not really necessary now that we only run rmadison for Devuan if the rmadison for Debian returned anything), just for this blog post. You're welcome, future self.

script for fixing gray-on-gray icons december 2023 edition

bgstack15 — Wed, 13 Dec 2023 13:42:12 GMT

I previously wrote about fixing the offending icons for audio volume notifications, and here are a few more files that need to be fixed in the Numix-Circle theme.

files/2023/12/listings/fix-icon-colors.sh (Source)

#!/bin/sh
# Startdate: 2023-12-11-2 18:46
# Purpose: fix gray-on-gray for icons that I use
# Reference:
#    1. https://bgstack15.ddns.net/blog/posts/2023/10/26/fixed-the-offending-icons-for-audio-volume-notifications/
# Improve:
# Documentation:
#    powerkit has a different problem. see fix-powerkit-icons.sh

# icons in notifications for changing audio volume
sudo sed -i.bup -r -e "s/fill:#ececec;/fill:#000000;/g;" $( readlink -f $( find /usr/share/icons \( -iname 'audio-volume-medium.*' -o -iname 'audio-volume-low.*' -o -iname 'audio-volume-high.*' -o -iname 'audio-volume-*mute*' \) ! -iname '*block*' -ipath '*Numix/*' ) | sort -u )

# tray icons for krb5-auth-dialog
sudo sed -i.bup -r -e "s/fill:#ececec;/fill:#000000;/g;" $( find /usr/share/icons/Numix -iname 'krb-no-valid-ticket*' -o -iname 'gtk-dialog-authentication-panel.*' | sort -u )

# tray icons for connman-gtk network manager
sudo sed -i.bup -r -e "s/fill:#ececec;/fill:#000000;/g;" /usr/share/icons/Numix/16/status/network-offline.svg /usr/share/icons/Numix/16/status/network-transmit-receive.svg

Helper script: pulsemixer-notification

bgstack15 — Fri, 06 Oct 2023 13:18:32 GMT

Story

Due to a minor hardware problem where my sound card keeps jumping from aplay -l position 0 to position 1, my wine malfunctioned with audio. I set the specific card to use in the winecfg tab for Audio. After a reboot (and the alsa card position switched again), winecfg would crash on the Audio tab and I was unable to figure how to wipe the settings back to all defaults. This wine audio problem meant everything in wine that uses audio (every game) crashes. It was frustrating.

So I bit the bullet and installed pulseaudio on my Devuan GNU+Linux desktop. It was a matter of adding start-pulseaudio-x11 & to ~/.fluxbox/startup. I learned you need to keep alsa-utils and alsamixergui installed. Pulseaudio sits on top of alsa instead of replacing it.

There is a great program named pulsemixer that is a very powerful TUI and CLI tool for controlling your inputs and outputs. But I still needed alsamixer to disable the "auto-mute" when I plug in headphones, because I accidentally discovered a few years ago that if sound comes out of both speakers and headphones, it makes my life easier. I'm probably weird for that reason (and dozens of others), but I like it and I'm going to keep it that way, and it takes alsamixer to control that. (Take that, ... atheists? pulseaudio peeps anyways.)

So, pulsemixer does provide a great, simple way to toggle mute, and change volume up and down. I was only missing notifications about changing the volume.

Configuring other apps

volumeicon

I still use volumeicon but now I have configured middle-click to "open mixer," with mixer defined as pulsemixer --togle-mute. I found that while the volumeicon can still use its built-in "Mute Volume" setting, it mutes it on the alsa level, which mutes the master volume in pulseaudio, but it cannot unmute that pulseaudio master volume. So it is now always muted until I use pulsemixer.

I also had to disable volumeicon from handling the XF86AudioRaiseVolume keypresses. For that, I modified my fluxbox config.

fluxbox

For bare pulsemixer control you can just run:

122 :Exec pulsemixer --change-volume -5
123 :Exec pulsemixer --change-volume +5
121 :Exec pulsemixer --toggle-mute

Which worked well but it doesn't have a cute little popup telling me what the current volume level is. So I had to write the following script, and configure fluxbox to use it.

121 :Exec pulsemixer-notification toggle
122 :Exec pulsemixer-notification down
123 :Exec pulsemixer-notification up

The script

Explanation

This script displays a relative volume level (0/33/66/100) and muted symbol. It will always unmute if you change volume, which is the behavior I expect because that's how alsa handled volume. A neat little feature is that it uses a notification ID, so it can replace it if you're scrolling up on the volume; it will just replace the current notification instead of slowly (1.25s per step) trickling through them.

Listing

files/2023/10/listings/pulsemixer-notification (Source)

#!/bin/sh
# File: pulsemixer-notification
# Location: /usr/bin
# Author: bgstack15
# Startdate: 2023-10-04-4 09:06
# SPDX-License-Identifier: GPL-3.0
# Title: pulsemixer wrapper script that includes notifications
# Package: bgscripts
# Purpose: wrap around pulsemixer hotkey invocations to include status notifications
# History:
# Usage:
#    In ~/.fluxbox/keys:
#       121 :Exec pulsemixer-notification toggle
#       122 :Exec pulsemixer-notification down
#       123 :Exec pulsemixer-notification up
# Reference:
# Improve:
# Dependencies:
#    devuan-dep: pulsemixer, pulseaudio, notify-send
# Documentation:

# Load configuration
test -z "${devtty}" && devtty=/dev/null
test -z "${PN_TEMPFILE}" && PN_TEMPFILE=~/.cache/audio.temp
test -z "${PN_STEP}" && PN_STEP=3
test -z "${PN_EXPIRE_MS}" && PN_EXPIRE_MS=1250
test -f "${HOME}/.config/pulsemixer-notification" && . "${HOME}/.config/pulsemixer-notification"
test -f "/etc/pulsemixer-notification.conf" && . "/etc/pulsemixer-notification.conf"

# runtime
exec 1>>"${devtty}"
action="${1}"
unset icon vol relative_level message replacestring

case "${action}" in
   toggle)
      pulsemixer --toggle-mute
      case "$( pulsemixer --get-mute )" in
         0)
            action="unmute"
            ;;
         1)
            icon="audio-volume-muted"
            message="muted"
            ;;
      esac
      ;;
   up) pulsemixer --unmute ; pulsemixer --change-volume +"${PN_STEP}" ;;
   down) pulsemixer --unmute ; pulsemixer --change-volume -"${PN_STEP}" ;;
   *)
      echo "unknown: ${action}"
      ;;
esac

get_vol_level() {
   vol="$( pulsemixer --get-volume | awk '{print $1}' )"
   is_low="$( printf '%s\n' "${vol}<=33" | bc )"
   is_med="$( printf '%s\n' "(${vol}<=66)*(${vol}>33)" | bc )"
   is_hih="$( printf '%s\n' "${vol}>66" | bc )"
   is_off="$( printf '%s\n' "${vol}==0" | bc )"
   test "${is_low}" = "1" && printf '%s' "low" && return 0
   test "${is_med}" = "1" && printf '%s' "medium" && return 0
   test "${is_hih}" = "1" && printf '%s' "high" && return 0
   test "${is_off}" = "1" && printf '%s' "muted" && return 0
}

# awk: cheat and just use left-side volume of stereo volume.
vol="$( pulsemixer --get-volume | awk '{print $1}' )"
relative_level="$( get_vol_level )"

case "${action}" in
   up|down)
      icon="audio-volume-${relative_level}"
      message="${vol}"
      ;;
   unmute)
      icon="audio-volume-${relative_level}"
      message="unmuted"
      ;;
esac

test -f "${PN_TEMPFILE}" && replacestring="--replace-id=$( cat "${PN_TEMPFILE}" 2>/dev/null )"
# leave replacestring unquoted in case it is empty
notify-send ${replacestring} --icon "${icon}" --transient "${message}" --urgency low --expire-time "${PN_EXPIRE_MS}" --print-id > "${PN_TEMPFILE}"

Fix old git commit author info

bgstack15 — Fri, 17 Feb 2023 14:00:40 GMT

To learn which repos need the info corrected:

cd ~/dev/sync-git/
for word in * ; do ( cd "${word}" ; git log --pretty=format:'%an,%ae' | sort -u | sed -r -e "s/^/${word},/;" ; ) ; done | grep 'localhost|example' ~/fix3

I inspected ~/fix3 and found two projects that had incorrect email addresses.

Now, prepare a script, ~/fix-git-commits.sh

	`#!/bin/sh`
	`# Startdate: 2023-01-30-2 14:00`
	`# ripped from https://www.git-tower.com/learn/git/faq/change-author-name-email/`
	`git filter-branch --env-filter '`
	`WRONG_EMAILS="localhost"`
	`NEW_NAME="B. Stack"`
	`NEW_EMAIL="bgstack15@gmail.com"`
	`if echo "${GIT_COMMITTER_EMAIL}" \| grep -qE "${WRONG_EMAILS}" ;`
	`then`
	`export GIT_COMMITTER_NAME="${NEW_NAME}"`
	`export GIT_COMMITTER_EMAIL="${NEW_EMAIL}"`
	`fi`
	`if echo "${GIT_AUTHOR_EMAIL}" \| grep -qE "${WRONG_EMAILS}" ;`
	`then`
	`export GIT_AUTHOR_NAME="${NEW_NAME}"`
	`export GIT_AUTHOR_EMAIL="${NEW_EMAIL}"`
	`fi`
	`' --tag-name-filter cat -- --branches --tags`

In the two repositories that needed to have info corrected, run this script.

cd ~/dev/project1
sh ~/fix-git-commits.sh

Then, you can just force-push each branch to each remote.

I also had to manually re-tag each tag. I just matched exact commit time and manually ran:

git tag --force v2.1 330b3e91f357f54668c54d5e543a7f3138b77ad7

And then I force-pushed the tags to each remote.

git push --tags local --force
git push --tags cloud --force

Future reading

Gitlab has some extra steps I should bother to do, but I haven't yet: https://docs.gitlab.com/ee/user/project/repository/reducing_the_repo_size_using_git.html

References

Slightly modified from https://www.git-tower.com/learn/git/faq/change-author-name-email/

My mute notification for Fluxbox and volumeicon

bgstack15 — Sun, 18 Sep 2022 12:42:53 GMT

I use fluxbox, with volumeicon-alsa, and notification-daemon. I could use the bog-standard notifications that volumeicon provides, but the little icons in the notification are really small. So I wrote my own.

In ~/.fluxbox/keys, I react to the volume mute button:

#121 :Exec amixer sset Master,0 toggle
121 :Exec /usr/local/bin/audio-toggle.sh

Instead of just toggling the mute with fluxbox, I call my special script at /usr/local/bin/audio-toggle.sh.

	`#!/bin/sh`
	`# Startdate: 2022-09-12`
	`# For fluxbox`
	`# handle the audio being muted and send cute notification`
	`tmpfile=/run/user/${UID}/audio-toggle-notify-id`
	`AUDIO="muted"`
	`ICON=/usr/share/icons/Adwaita/64x64/status/audio-volume-muted-symbolic.symbolic.png`
	`amixer sset Master,0 toggle 2>&1 \| grep -iqE '\[on\]' 2>/dev/null && {`
	`AUDIO="unmuted"`
	`ICON=/usr/share/icons/Adwaita/64x64/status/audio-volume-high-symbolic.symbolic.png`
	`}`
	`nid="$( cat "${tmpfile}" 1>/dev/null 2>&1 )"`
	`notify-send --transient --expire-time 2000 ${nid:+--replace-id=${nid} }--icon "${ICON}" "Audio ${AUDIO}" --print-id \| tee "${tmpfile}" 1>/dev/null 2>&1`

I wanted the size 64 icons so I could see them! Also, I wanted the black icons because my default theme in notification-daemon is apparently the nice, boring gray that hides white icons.