wip3

This reverts commit abad965e9a.

Makefile

@@ -1,4 +1,4 @@
-# Autogenerated at 22.11.2024 09:40 using ./gen-makefile
+# Autogenerated at 10.07.2025 23:45 using ./gen-makefile
 .DEFAULT_GOAL := help
 
 #===============================================
@@ -21,11 +21,15 @@ canon-mg2500:
 chrome:
 	@./install/chrome
 
+##clamav: ClamAV (WIP)
+clamav:
+	@./install/clamav
+
 ##composer: Install composer (latest)
 composer:
 	@./install/composer
 
-##docker: Install docker (latest) + docker-compose (latest) + ppa
+##docker: Install docker (latest) + ppa
 docker:
 	@./install/docker
 
@@ -45,9 +49,9 @@ droidcam-obs:
 flameshot:
 	@./install/flameshot
 
-##frkn: Install Wireguard + FRKN
+##frkn.deprecated: Install Wireguard + FRKN
-frkn:
+frkn.deprecated:
-	@./install/frkn
+	@./install/frkn.deprecated
 
 ##git: Install git (latest)
 git:
@@ -81,15 +85,11 @@ kde-file-templates:
 kde-portal:
 	@./install/kde-portal
 
-##lazynvim: <no description>
-lazynvim:
-	@./install/lazynvim
-
 ##libreoffice: Install libreoffice
 libreoffice:
 	@./install/libreoffice
 
-##lite-xl: Install lite-xl
+##lite-xl: Install lite-xl v2.1.7
 lite-xl:
 	@./install/lite-xl
 
@@ -105,6 +105,10 @@ nodejs:
 ntfy:
 	@./install/ntfy
 
+##nvim: Install nvim + lazyvim
+nvim:
+	@./install/nvim
+
 ##obs-studio: Install obs-studio (latest snap)
 obs-studio:
 	@./install/obs-studio
@@ -129,7 +133,7 @@ papirus:
 pgsql:
 	@./install/pgsql
 
-##php: Install php v8.1 + ppa
+##php: Install php v8.4
 php:
 	@./install/php
 
@@ -165,18 +169,30 @@ postman:
 qt5:
 	@./install/qt5
 
-##rustdesk: Install rustdesk client v1.1.9 (deb)
+##rustdesk: Install rustdesk client (flatpak)
 rustdesk:
 	@./install/rustdesk
 
+##rustdesk-deb: Install rustdesk client v1.4.0 (deb)
+rustdesk-deb:
+	@./install/rustdesk-deb
+
 ##snap: Install bunch of software from snap
 snap:
 	@./install/snap
 
-##sublimetext: Install Sublime Text (build 4169)
+##sublimemerge: Install Sublime Merge
+sublimemerge:
+	@./install/sublimemerge
+
+##sublimetext: Install Sublime Text
 sublimetext:
 	@./install/sublimetext
 
+##suld: Samsung Unified Linux Driver repo
+suld:
+	@./install/suld
+
 ##syncthing: Install syncthing (latest) + ppa
 syncthing:
 	@./install/syncthing
@@ -201,7 +217,7 @@ vivaldi:
 vscode:
 	@./install/vscode
 
-##wine: Install wine (latest) + ppa (focal)
+##wine: Install wine (latest) + ppa
 wine:
 	@./install/wine
 
@@ -226,9 +242,6 @@ zsh:
 #	Scripts listed in ./packs
 #===============================================
 
-##flameshot: [TODO] [PACK] qt5 + flameshot from source
-flameshot: qt5 flameshot-build
-
 ##lamp: [PACK] Apache + php + mariadb
 lamp: apache phpstack mariadb
 
@@ -240,8 +253,8 @@ omz: zsh omz-clean omz-fancy
 	chsh -s /usr/bin/zsh
 	@exec zsh
 
-##phptools: [PACK] Install only php tooling (composer, phpunit, psalm, phpcs, php-cs-fixer, php-spx, phpmd)
+##phptools: [PACK] Install only php tooling (composer, phpunit, psalm, phpcs, php-cs-fixer, phpmd)
-phptools: composer php-psalm php-spx phpcs phpmd phpstan phpunit
+phptools: composer php-psalm phpcs phpmd phpstan phpunit
 
 ##phpstack: [PACK] Install full php stack with tooling
 phpstack: php phptools
@@ -262,6 +275,18 @@ phpstack: php phptools
 /apache2:
 	@./uninstall/apache2
 
+##/canon-mg2500: Uninstall Canon Pixma MG2500 + ppa
+/canon-mg2500:
+	@./uninstall/canon-mg2500
+
+##/chrome: Uninstall google chrome
+/chrome:
+	@./uninstall/chrome
+
+##/composer: Uninstall composer
+/composer:
+	@./uninstall/composer
+
 ##/docker: Uninstall docker + ppa
 /docker:
 	@./uninstall/docker
@@ -282,10 +307,22 @@ phpstack: php phptools
 /omz:
 	@./uninstall/omz
 
+##/sublimemerge: Uninstall Sublime Merge
+/sublimemerge:
+	@./uninstall/sublimemerge
+
+##/sublimetext: Uninstall Sublime Text
+/sublimetext:
+	@./uninstall/sublimetext
+
 ##/vivaldi: Uninstall vivaldi + ppa
 /vivaldi:
 	@./uninstall/vivaldi
 
+##/wine: Uninstall wine
+/wine:
+	@./uninstall/wine
+
 #===============================================
 #	Service goals
 #===============================================

README.md

@@ -1,46 +1,28 @@
-# My Ubuntu environment
+# My shell environment
 
-`make`-ready bunch of scripts for easily installation of different software.
+`make`-ready bunch of scripts for easily (de)installation of different software and bunch of useful handy functions for custom scripting.
 
 ## Requirements
 
 * Ubuntu >= 20.04 (not tested with version < 20)
 * `bash`, `zsh` or other `sh`-compatible shell
 * `make` (optional but recommended)
-* `wget` (necessary for some scripts)
+* `wget` (required for some scripts)
-* `git` (necessary for some scripts)
+* `git` (required for some scripts)
 
-If some dependecies are missed for some of these scripts it is enougth to run `./install/apt` in most cases.
+If some dependecies are missed for some of these scripts it is enougth to run `./install/apt` in most cases, otherwise script will suggest (or even install) them.
 
 ## Usage
 
-### Clone this repo (recommended)
-
 ```shell
-# if git is installed
+# with git
-git clone git@git.axenov.dev:anthony/my-env.git --depth=1
+git clone git@git.axenov.dev:anthony/shell.git --depth=1 --single-branch
 
-# if git is not installed
+# without git
-wget -qO - https://git.axenov.dev/anthony/my-env/archive/master.tar.gz | tar -zxf -
+wget -qO - https://git.axenov.dev/anthony/shell/archive/master.tar.gz | tar -zxf -
-
-# switch to repo dir
-cd my-env
-
-# generate fresh ./Makefile and get full list of `make` goals
-./gen-makefile
 
 # get full list of `make` goals
-make
+cd shell && make
-```
-
-### Selective straightforward installation
-
-```shell
-# from remote file (you can meet interaction bugs this way!)
-wget -qO - https://git.axenov.dev/anthony/my-env/raw/branch/master/install/apt | bash
-
-# from locally cloned repo (except scripts from ./packs)
-./install/apt
 ```
 
 ## How to add my script?
@@ -48,7 +30,7 @@ wget -qO - https://git.axenov.dev/anthony/my-env/raw/branch/master/install/apt |
 1. Create a new shell script in `./install`, `./upgrade` or `./uninstall` directory.  
    At the beggining of a file you must write these two lines:
    ```shell
-   #!/bin/bash
+   #!/usr/bin/env bash
    ##makedesc: Your description for Makefile
    ```
 2. Make this script executable, e.g.:
@@ -78,17 +60,35 @@ mypackX: goalA goalB
 ```
 
 where:
-* `mypack*` is the pack name
+* `mypack*` is the pack name of your choice
 * `goal*` are script names in `./install`
 
-## TODO
+## Useful links and sources used
 
-* build: [flameshot](https://github.com/flameshot-org/flameshot#compilation)
+* https://gist.github.com/anthonyaxenov/d53c4385b7d1466e0affeb56388b1005
-* build: [rustdesk](https://github.com/rustdesk/rustdesk#build)
+* https://gist.github.com/anthonyaxenov/89c99e09ddb195985707e2b24a57257d
-* [JB mono](https://www.jetbrains.com/ru-ru/lp/mono/#how-to-install) ([2](https://fonts.google.com/specimen/JetBrains+Mono))
+* ...and other my [gists](https://gist.github.com/anthonyaxenov/) with [SHELL] prefix
-* update scripts (when possible)
+* https://github.com/nvie/gitflow/blob/develop/gitflow-common (BSD License)
-* uninstall scripts (when possible)
+* https://github.com/petervanderdoes/gitflow-avh/blob/develop/gitflow-common (FreeBSD License)
+* https://github.com/vaniacer/bash_color/blob/master/color
+* https://misc.flogisoft.com/bash/tip_colors_and_formatting
+* https://www-users.york.ac.uk/~mijp1/teaching/2nd_year_Comp_Lab/guides/grep_awk_sed.pdf
+* https://www.galago-project.org/specs/notification/
+* https://laurvas.ru/bash-trap/
+* https://stackoverflow.com/a/52674277
+* https://rtfm.co.ua/bash-funkciya-getopts-ispolzuem-opcii-v-skriptax/
+* https://gist.github.com/jacknlliu/7c51e0ee8b51881dc8fb2183c481992e
+* https://gist.github.com/anthonyaxenov/d53c4385b7d1466e0affeb56388b1005
+* https://github.com/nvie/gitflow/blob/develop/gitflow-common
+* https://github.com/petervanderdoes/gitflow-avh/blob/develop/gitflow-common
+* https://gitlab.com/kyb/autorsync/-/blob/master/
+* https://lug.fh-swf.de/vim/vim-bash/StyleGuideShell.en.pdf
+* https://www.thegeekstuff.com/2010/06/bash-array-tutorial/
+* https://www.distributednetworks.com/linux-network-admin/module4/ephemeral-reserved-portNumbers.php
+* https://github.com/community-scripts/ProxmoxVE/tree/main/install
+* https://github.com/community-scripts/ProxmoxVE/tree/main/misc
+* https://faculty.cs.niu.edu/~hutchins/csci480/signals.htm
 
 ## License
 
-[WTFPLv2](LICENSE)
+[WTFPLv2](LICENSE) but other licences are also possible.

TODO.md

@@ -1,6 +1,11 @@
 # Todo list
 
-* [ ] tdesktop (https://desktop.telegram.org)
+* tdesktop (https://desktop.telegram.org)
-* [ ] spoofdpi (https://git.axenov.dev/mirrors/SpoofDPI/tags)
+* spoofdpi (https://git.axenov.dev/mirrors/SpoofDPI/tags)
-* [ ] lazynvim (https://www.lazyvim.org)
+* lazynvim (https://www.lazyvim.org)
-* [ ] ...
+* build: [flameshot](https://github.com/flameshot-org/flameshot#compilation)
+* build: [rustdesk](https://github.com/rustdesk/rustdesk#build)
+* update scripts (when possible)
+* uninstall scripts (when possible)
+* ...
+

dotfiles/.bash_aliases

@@ -1,158 +0,0 @@
-#!/bin/bash
-
-# alias bashrc='source ~/.bashrc'
-alias zshrc='source ~/.zshrc'
-alias realias='source ~/.bash_aliases'
-alias reload='exec ${SHELL} -l'
-alias sudo='sudo ' # enable aliases to be sudo’ed
-alias g='git'
-alias hosts="sudo nano /etc/hosts"
-alias shrug="echo '¯\_(ツ)_/¯' | xclip -selection c"
-
-alias ..='cd ..' # zsh builtin
-alias ~='cd ~' # zsh builtin
-alias -- -='cd -' # zsh builtin
-
-alias chmod='chmod --preserve-root'
-alias chown='chown --preserve-root'
-
-alias free='free -h'
-alias duh='du -ha --max-depth=1'
-alias sduh='sudo du -ha --max-depth=1'
-
-alias l='ls -pCFh --color=auto'
-alias la='ls -pAFh --color=auto'
-alias ll='ls -palFh --color=auto'
-
-alias mkdir='mkdir -pv'
-alias where='whereis' # zsh builtin
-
-alias ps='ps auxf'
-alias psg='ps aux | grep -v grep | grep -i -e VSZ -e'
-
-alias is='type -a'
-alias upgrade='sudo apt update && sudo apt upgrade -y && sudo snap refresh'
-alias untargz='tar -czf'
-alias mkcd="mkdir -p $1 && cd $1"
-alias cl='cd $1 && ll'
-alias myip='curl http://ipecho.net/plain; echo'
-alias ports='netstat -tulpan'
-
-alias ssh.pub='cat ~/.ssh/*.pub'
-alias gpg.new="gpg --full-generate-key"
-alias gpg.pub="gpg --armor --export $@"
-alias gpg.list='gpg --list-keys --keyid-format SHORT'
-
-alias lite-xl="LITE_SCALE=1 lite-xl"
-alias wine='LANG=ru_RU.utf8 wine'
-alias docker.prune='docker image prune -f; docker network prune -f; docker container prune -f'
-
-# Add an "alert" alias for long running commands.  Use like so:
-#   sleep 10; alert
-alias alert='notify-send --urgency=low -i "$([ $? = 0 ] && echo terminal || echo error)" "$(history|tail -n1|sed -e '\''s/^\s*[0-9]\+\s*//;s/[;&|]\s*alert$//'\'')"'
-
-# https://obsproject.com/forum/threads/how-to-start-virtual-camera-without-sudo-privileges.139783/
-alias obscam="sudo modprobe v4l2loopback video_nr=2 card_label='OBS Virtual Camera'"
-
-# Download music from Youtube or Youtube Music
-# and save as top quality flac file without video
-# Playlist and video/track URLs are supported
-# Usage:     $ ytm https://www.youtube.com/watch\?v=dQw4w9WgXcQ
-# More info: https://github.com/ytdl-org/youtube-dl
-ytm() {
-    youtube-dl \
-        --extract-audio \
-        --audio-format flac \
-        --audio-quality 0 \
-        --format bestaudio \
-        --write-info-json \
-        --output "${HOME}/Музыка/ytm/%(playlist_title)s/%(channel)s - %(title)s.%(ext)s" \
-        $@
-}
-
-
-docker.ip() {
-    if [ "$1" ]; then
-        if [ "$1" = "-a" ]; then
-            docker ps -aq \
-            | xargs -n 1 docker inspect --format '{{.Name}}{{range .NetworkSettings.Networks}} {{.IPAddress}}{{end}}' \
-            | sed -e 's#^/##' \
-            | column -t
-        elif [ "$1" = "-c" ]; then
-            docker-compose ps -q \
-            | xargs -n 1 docker inspect --format '{{.Name}}{{range .NetworkSettings.Networks}} {{.IPAddress}}{{end}}' \
-            | sed -e 's#^/##' \
-            | column -t
-        else
-            docker inspect --format '{{range .NetworkSettings.Networks}}{{.IPAddress}}{{end}}' "$1"
-            docker port "$1"
-        fi
-    else
-        docker ps -q \
-        | xargs -n 1 docker inspect --format '{{.Name}}{{range .NetworkSettings.Networks}} {{.IPAddress}}{{end}}' \
-        | sed -e 's#^/##' \
-        | column -t
-    fi
-}
-
-
-#################################################################################
-
-# $1 -- file/dir path
-# $2 -- permissions (0644, 0755, etc)
-# own() { #TODO refactor
-#     [ "$1" ] && PATH="${1/#\~/$HOME}" || {
-#         echo "Error (1): path not provided"
-#     }
-#     echo $PATH
-
-#     [ "$2" ] && PERM="$2" || {
-#         if [ -d $PATH ]; then
-#             PERM="0755"
-#         elif [ -f $PATH ]; then
-#             PERM="0644"
-#         else
-#             echo "Error (2): path not exists"
-#         fi;
-#     }
-#     echo $PERM
-
-#     sudo chmod $PERM -R --preserve-root $PATH
-#     sudo chown $USER. -R --preserve-root $PATH
-# }
-
-# function extract {
-#  if [ -z "$1" ]; then
-#     # display usage if no parameters given
-#     echo "Usage: extract <path/file_name>.<zip|rar|bz2|gz|tar|tbz2|tgz|Z|7z|xz|ex|tar.bz2|tar.gz|tar.xz>"
-#     echo "       extract <path/file_name_1.ext> [path/file_name_2.ext] [path/file_name_3.ext]"
-#     return 1
-#  else
-#     for n in $@
-#     do
-#       if [ -f "$n" ] ; then
-#           case "${n%,}" in
-#             *.tar.bz2|*.tar.gz|*.tar.xz|*.tbz2|*.tgz|*.txz|*.tar)
-#                          tar xvf "$n"       ;;
-#             *.lzma)      unlzma ./"$n"      ;;
-#             *.bz2)       bunzip2 ./"$n"     ;;
-#             *.rar)       unrar x -ad ./"$n" ;;
-#             *.gz)        gunzip ./"$n"      ;;
-#             *.zip)       unzip ./"$n"       ;;
-#             *.z)         uncompress ./"$n"  ;;
-#             *.7z|*.arj|*.cab|*.chm|*.deb|*.dmg|*.iso|*.lzh|*.msi|*.rpm|*.udf|*.wim|*.xar)
-#                          7z x ./"$n"        ;;
-#             *.xz)        unxz ./"$n"        ;;
-#             *.exe)       cabextract ./"$n"  ;;
-#             *)
-#                          echo "extract: '$n' - unknown archive method"
-#                          return 1
-#                          ;;
-#           esac
-#       else
-#           echo "'$n' - file does not exist"
-#           return 1
-#       fi
-#     done
-# fi
-# }

dotfiles/.bashrc

@@ -1,108 +0,0 @@
-# ~/.bashrc: executed by bash(1) for non-login shells.
-# see /usr/share/doc/bash/examples/startup-files (in the package bash-doc)
-# for examples
-
-# If not running interactively, don't do anything
-case $- in
-    *i*) ;;
-      *) return;;
-esac
-
-# don't put duplicate lines or lines starting with space in the history.
-# See bash(1) for more options
-HISTCONTROL=ignoreboth
-
-# append to the history file, don't overwrite it
-shopt -s histappend
-
-# for setting history length see HISTSIZE and HISTFILESIZE in bash(1)
-HISTSIZE=1000
-HISTFILESIZE=2000
-
-# check the window size after each command and, if necessary,
-# update the values of LINES and COLUMNS.
-shopt -s checkwinsize
-
-# If set, the pattern "**" used in a pathname expansion context will
-# match all files and zero or more directories and subdirectories.
-#shopt -s globstar
-
-# make less more friendly for non-text input files, see lesspipe(1)
-[ -x /usr/bin/lesspipe ] && eval "$(SHELL=/bin/sh lesspipe)"
-
-# set variable identifying the chroot you work in (used in the prompt below)
-if [ -z "${debian_chroot:-}" ] && [ -r /etc/debian_chroot ]; then
-    debian_chroot=$(cat /etc/debian_chroot)
-fi
-
-# set a fancy prompt (non-color, unless we know we "want" color)
-case "$TERM" in
-    xterm-color|*-256color) color_prompt=yes;;
-esac
-
-# uncomment for a colored prompt, if the terminal has the capability; turned
-# off by default to not distract the user: the focus in a terminal window
-# should be on the output of commands, not on the prompt
-#force_color_prompt=yes
-
-if [ -n "$force_color_prompt" ]; then
-    if [ -x /usr/bin/tput ] && tput setaf 1 >&/dev/null; then
-	# We have color support; assume it's compliant with Ecma-48
-	# (ISO/IEC-6429). (Lack of such support is extremely rare, and such
-	# a case would tend to support setf rather than setaf.)
-	color_prompt=yes
-    else
-	color_prompt=
-    fi
-fi
-
-if [ "$color_prompt" = yes ]; then
-    PS1='${debian_chroot:+($debian_chroot)}\[\033[01;32m\]\u@\h\[\033[00m\]:\[\033[01;34m\]\w\[\033[00m\]\$ '
-else
-    PS1='${debian_chroot:+($debian_chroot)}\u@\h:\w\$ '
-fi
-unset color_prompt force_color_prompt
-
-# If this is an xterm set the title to user@host:dir
-case "$TERM" in
-xterm*|rxvt*)
-    PS1="\[\e]0;${debian_chroot:+($debian_chroot)}\u@\h: \w\a\]$PS1"
-    ;;
-*)
-    ;;
-esac
-
-# enable color support of ls and also add handy aliases
-if [ -x /usr/bin/dircolors ]; then
-    test -r ~/.dircolors && eval "$(dircolors -b ~/.dircolors)" || eval "$(dircolors -b)"
-    alias ls='ls --color=auto'
-    #alias dir='dir --color=auto'
-    #alias vdir='vdir --color=auto'
-
-    alias grep='grep --color=auto'
-    alias fgrep='fgrep --color=auto'
-    alias egrep='egrep --color=auto'
-fi
-
-# colored GCC warnings and errors
-#export GCC_COLORS='error=01;31:warning=01;35:note=01;36:caret=01;32:locus=01:quote=01'
-
-# Alias definitions.
-# You may want to put all your additions into a separate file like
-# ~/.bash_aliases, instead of adding them here directly.
-# See /usr/share/doc/bash-doc/examples in the bash-doc package.
-
-if [ -f ~/.bash_aliases ]; then
-    . ~/.bash_aliases
-fi
-
-# enable programmable completion features (you don't need to enable
-# this, if it's already enabled in /etc/bash.bashrc and /etc/profile
-# sources /etc/bash.bashrc).
-if ! shopt -oq posix; then
-  if [ -f /usr/share/bash-completion/bash_completion ]; then
-    . /usr/share/bash-completion/bash_completion
-  elif [ -f /etc/bash_completion ]; then
-    . /etc/bash_completion
-  fi
-fi

dotfiles/.editorconfig

@@ -1,15 +0,0 @@
-root = true
-
-[*]
-charset = utf-8
-end_of_line = lf
-insert_final_newline = true
-indent_style = space
-indent_size = 4
-trim_trailing_whitespace = true
-
-[*.md]
-trim_trailing_whitespace = false
-
-[*.{yml,yaml}]
-indent_size = 2

dotfiles/.git_aliases

@@ -1,151 +0,0 @@
-[alias]
-a = "add"
-aa = "add --all" # add all unstaged into index
-aliases = "config --get-regexp '^alias'" # show all aliases
-amend = "commit --amend --all --no-edit" # add new changes into last commit
-amendm = "commit --amend --all --message" # amend + edit commit message
-
-b = "branch" #
-bm = "branch --merged" # branches whose tips are reachable from commit or HEAD
-bnm = "branch --no-merged" # branches whose tips are NOT reachable from commit or HEAD
-branches = "branch -a"
-; branches = "bvv"
-brd = "branch -D" # force delete unmerged branch
-brod = "!git branch -D "$1"; git push origin :"$1";" # brd + remove it from origin
-bv = "branch -v" # show branch list with those last commits
-bvv = "branch -vv" # bv + remote branches tracked by them
-
-c = "commit"
-ca = "commit --all" # stage all changes and make a commit (interative)
-cam = "commit --all --message" # ca + cm (non-interactive)
-cf = "!f() { TARGET=$(git rev-parse \"$1\"); git commit --fixup=$TARGET && GIT_EDITOR=true git rebase --interactive --autosquash $TARGET~; }; f" # https://words.filippo.io/git-fixup-amending-an-older-commit/
-cleaner = "clean -dff"
-cleanest = "clean -dffx"
-cleanout = "!git clean -df && git checkout -- ."
-cloner = "clone --recursive" # clone with submodules
-cm = "commit --message" # make a commit with message given (non-interactive)
-co = "checkout"
-cob = "checkout -b" # create new branch with name given
-contributors = "shortlog --summary --numbered --no-merges" # users participating in development
-cp = "cherry-pick"
-cpa = "cherry-pick --abort" # abort cherry-picking
-cpc = "cherry-pick --continue" # continue cherry-picking
-cpn = "cherry-pick --no-commit" # cherry-pick without commit
-; cpnx = "cherry-pick --no-commit -x"
-current-branch = "branch --show-current" #rev-parse --abbrev-ref HEAD
-
-d = "diff"
-dc = "diff --cached" # show diff of staged files
-default-branch = "config init.defaultBranch" # get default branch name
-dehead = "!BR=$(git branch --show-current); if [ -n "$BR" ]; then echo $BR; else git describe --contains --all HEAD; fi;"
-dev = "!git checkout dev && git pull" # quick switch on dev branch and update it
-develop = "!git checkout develop && git pull" # quick switch on develop branch and update it
-discard = "checkout --" # удаляет изменения в файле
-dw = "diff --word-diff" # show word diff in unstaged files
-dwc = "diff --word-diff --cached" # dc + dw
-
-exec = "!exec"
-
-f = "fetch"
-fa = "fetch --all" # fetch branches from all remotes
-fuck = "!git checkout $(git default-branch) && git fetch origin --prune && git reset --hard origin/$(git default-branch) && git clean -ffd"
-
-guser = "config --global --get-regexp '^user'" # show global user settings
-gzip = !"f() { top=$(rev-parse --show-toplevel); cd $top; tar cvzf $top.tar.gz $top ; }; f" # make repo .tar.gz
-
-head = "log -1 HEAD" # показать последний коммит в текущей ветке
-heads = "log --graph --decorate --simplify-by-decoration --oneline" # show last commit of each branch as tree graph
-
-inbound = "!git remote update --prune; git log ..@{upstream}" # get
-init = "init -q"
-
-l = "log"
-; last-tag = "describe --tags --abbrev=0"
-; last-tagged = "!git describe --tags $(git rev-list --tags --max-count=1)"
-lo = "log --oneline"
-log-all = "log --graph --decorate --all"
-log-my = "!git log --author $(git config user.email)"
-log-small = "log --graph --decorate --all --pretty=format:'%C(bold red)%h%C(reset) %C(bold blue)%an%C(reset) %C(green)%cr%C(reset) [%aD]%d%n%B'"
-
-m = "merge"
-ma = "merge --abort" # abort merging
-main = "!git checkout main && git pull" # quick switch on main branch and update it
-master = "!git checkout master && git pull" # quick switch on master branch and update it
-mc = "merge --continue" # continue merging
-merged = "bm"
-mn = "merge --no-commit" # merge without commit
-
-optimizer = "!git pruner; git repacker; git prune-packed"
-orphans = "fsck --full"
-outbound = "log @{upstream}.."
-
-p = "pull"
-pf = "pull --force" # получить ветку принудительно
-pft = "pull --force --tags" # получить теги
-; ploh = "pull origin HEAD" # получить текущую ветку из origin
-; pr = "!git fetch origin pull/$1/head:pr/$1 && git checkout pr/$1" # github: встать на PR с указанным id
-prs = "pull --recurse-submodules" # pull with submodules
-pruner = "!git prune --expire=now; git reflog expire --expire-unreachable=now --rewrite --all"
-pullf = "pull --force"
-pullft = "pull --force --tags"
-pullt = "pull --tags" # получить теги
-pushf = "!git push --force" # отправить ветку принудительно
-; pushf = "!git push --force --set-upstream origin $(git current-branch)" # отправить ветку принудительно
-pushft = "!git push --tags --force" # отправить теги принудительно
-; pushft = "!git push --tags --force --set-upstream origin $(git current-branch)" # отправить теги принудительно
-pusht = "!git push --tags" # отправить теги
-; pusht = "!git push --tags --set-upstream origin $(git current-branch)" # отправить теги
-
-r = "reset"
-rb = "rebase"
-rba = "rebase --abort"
-rbc = "rebase --continue"
-rbi = "rebase --interactive"
-rbs = "rebase --skip"
-re = "remote"
-rea = "remote add"
-remotes = "remote -v" # показать список удалённых репозиториев
-rep = "remote prune"
-repacker = "repack -adf --depth=300 --window=300 --window-memory=1g"
-repd = "remote prune --dry-run"
-repo = "rpo"
-repod = "rpod"
-repush = "!git push origin :$1 && git push origin $1'" # замена push --force
-res = "remote show"
-reso = "remote show origin"
-reu = "remote update"
-rev = "remote -v"
-rh = "reset --hard" # откат коммита с удалением всех изменений на указанный коммит
-rhh = "reset --hard HEAD" # откат коммита с удалением всех изменений на последний коммит
-rpo = "remote prune origin" # удалить все мёртвые ссылки на bare-ветки origin
-rpod = "rpo --dry-run" # удалить все мёртвые ссылки на bare-ветки origin
-rs = "reset --soft" # откат коммита с сохранением всех изменений на указанный коммит
-rsh = "reset --soft HEAD" # откат коммита с сохранением всех изменений
-rso = "remote show origin" # показать состояние локальных веток относительно удалённых на origin bare
-rv = "revert"
-rvn = "revert --no-commit"
-
-s = "status"
-sb = "show-branch"
-start = "!git init -q && git commit --allow-empty -m 'Initial commit'"
-stashes = "stash list" # show stashed changes
-sub = "submodule"
-; sa = "submodule add"
-; sdi = "submodule deinit -f"
-; si = "submodule init"
-; ss = "submodule summary"
-; sst = "submodule status"
-; sup = "submodule update"
-; sy = "remote update origin --prune"
-
-tags = "tag -n1 --list" # shot tag names and commit message
-trim = "!DEFAULT=$(git default-branch); git branch --merged ${1-$DEFAULT} | grep -v " ${1-$DEFAULT}$" | xargs git branch -d; git remote prune origin;"
-
-uncommit = "rs HEAD~1"
-unstage = "reset HEAD" # staged file => unstaged
-;unwip = "reset --mixed HEAD~"
-upstream-branch = "!git for-each-ref --format='%(upstream:short)' $(git symbolic-ref -q HEAD)"
-user = "config --local --get-regexp '^user'" # show local user settings (in current repo)
-
-wip = "!git add . && git commit -am 'WIP'"
-wipa = "!git add . && git commit --amend -am 'WIP'"

dotfiles/.gitconfig

@@ -1,28 +0,0 @@
-[core]
-    editor = nano
-    autocrlf = input
-[user]
-    # ...
-    # signingkey = <key>
-    # git config user.signingkey ... -- установить ключ
-    # https://help.github.com/articles/signing-commits-using-gpg/
-[commit]
-    gpgSign = true
-[tag]
-    gpgSign = true
-[init]
-	defaultBranch = master
-[push]
-    default = current
-    followTags = true
-[pull]
-    default = current
-    rebase = false
-[diff "bin"]
-	textconv = hexdump -v -C
-[help]
-	autocorrect = 1
-[remote "origin"]
-    prune = true
-[include]
-    path = ~/.git_aliases

dotfiles/.gitignore

@@ -1,4 +0,0 @@
-.DS_Store
-Desktop.ini
-._*
-Thumbs.db

dotfiles/.profile

@@ -1,53 +0,0 @@
-# ~/.profile: executed by the command interpreter for login shells.
-# This file is not read by bash(1), if ~/.bash_profile or ~/.bash_login
-# exists.
-# see /usr/share/doc/bash/examples/startup-files for examples.
-# the files are located in the bash-doc package.
-
-# the default umask is set in /etc/profile; for setting the umask
-# for ssh logins, install and configure the libpam-umask package.
-#umask 022
-
-# if running bash
-if [ -n "$BASH_VERSION" ]; then
-    # include .bashrc if it exists
-    if [ -f "$HOME/.bashrc" ]; then
-	. "$HOME/.bashrc"
-    fi
-fi
-
-# set PATH so it includes user's private bin if it exists
-if [ -d "$HOME/bin" ] ; then
-    PATH="$HOME/bin:$PATH"
-fi
-
-# set PATH so it includes user's private bin if it exists
-if [ -d "$HOME/.local/bin" ] ; then
-    PATH="$HOME/.local/bin:$PATH"
-fi
-
-### AAA ##########################################
-
-if [ -f ~/.bash_aliases ]; then
-    . ~/.bash_aliases
-fi
-
-export LD_LIBRARY_PATH="/opt/oci"
-# export NLS_LANG='RUSSIAN_RUSSIA.AL32UTF8'
-# export NLS_DATE_FORMAT='DD.MM.YYYY'
-# export NLS_CURRENCY='р.'
-# export NLS_DUAL_CURRENCY='р.'
-# export NLS_CALENDAR='GREGORIAN'
-# export NLS_ISO_CURRENCY='RUSSIA'
-
-export JAVA_HOME="/usr/bin/"
-export ANDROID_SDK_ROOT="$HOME/android/sdk"
-export LITE_SCALE=1 # workaround https://github.com/lite-xl/lite-xl/issues/1173
-
-export PATH="$HOME/.local/share/JetBrains/Toolbox/scripts:$HOME/.config/composer/vendor/bin:$PATH"
-
-# The next line updates PATH for Yandex Cloud CLI.
-if [ -f "$HOME/yandex-cloud/path.bash.inc" ]; then source "$HOME/yandex-cloud/path.bash.inc"; fi
-
-# The next line enables shell command completion for yc.
-if [ -f "$HOME/yandex-cloud/completion.zsh.inc" ]; then source "$HOME/yandex-cloud/completion.zsh.inc"; fi

dotfiles/.zshrc

@@ -1,114 +0,0 @@
-# Enable Powerlevel10k instant prompt. Should stay close to the top of ~/.zshrc.
-# Initialization code that may require console input (password prompts, [y/n]
-# confirmations, etc.) must go above this block; everything else may go below.
-if [[ -r "${XDG_CACHE_HOME:-$HOME/.cache}/p10k-instant-prompt-${(%):-%n}.zsh" ]]; then
-  source "${XDG_CACHE_HOME:-$HOME/.cache}/p10k-instant-prompt-${(%):-%n}.zsh"
-fi
-
-# If you come from bash you might have to change your $PATH.
-# export PATH=$HOME/bin:/usr/local/bin:$PATH
-
-# Path to your oh-my-zsh installation.
-export ZSH="$HOME/.oh-my-zsh"
-
-# Set name of the theme to load --- if set to "random", it will
-# load a random theme each time oh-my-zsh is loaded, in which case,
-# to know which specific one was loaded, run: echo $RANDOM_THEME
-# See https://github.com/ohmyzsh/ohmyzsh/wiki/Themes
-ZSH_THEME="powerlevel10k/powerlevel10k"
-
-# Set list of themes to pick from when loading at random
-# Setting this variable when ZSH_THEME=random will cause zsh to load
-# a theme from this variable instead of looking in $ZSH/themes/
-# If set to an empty array, this variable will have no effect.
-# ZSH_THEME_RANDOM_CANDIDATES=( "robbyrussell" "agnoster" )
-
-# Uncomment the following line to use case-sensitive completion.
-# CASE_SENSITIVE="true"
-
-# Uncomment the following line to use hyphen-insensitive completion.
-# Case-sensitive completion must be off. _ and - will be interchangeable.
-# HYPHEN_INSENSITIVE="true"
-
-# Uncomment one of the following lines to change the auto-update behavior
-# zstyle ':omz:update' mode disabled  # disable automatic updates
-# zstyle ':omz:update' mode auto      # update automatically without asking
-# zstyle ':omz:update' mode reminder  # just remind me to update when it's time
-
-# Uncomment the following line to change how often to auto-update (in days).
-# zstyle ':omz:update' frequency 13
-
-# Uncomment the following line if pasting URLs and other text is messed up.
-# DISABLE_MAGIC_FUNCTIONS="true"
-
-# Uncomment the following line to disable colors in ls.
-# DISABLE_LS_COLORS="true"
-
-# Uncomment the following line to disable auto-setting terminal title.
-# DISABLE_AUTO_TITLE="true"
-
-# Uncomment the following line to enable command auto-correction.
-# ENABLE_CORRECTION="true"
-
-# Uncomment the following line to display red dots whilst waiting for completion.
-# You can also set it to another string to have that shown instead of the default red dots.
-# e.g. COMPLETION_WAITING_DOTS="%F{yellow}waiting...%f"
-# Caution: this setting can cause issues with multiline prompts in zsh < 5.7.1 (see #5765)
-# COMPLETION_WAITING_DOTS="true"
-
-# Uncomment the following line if you want to disable marking untracked files
-# under VCS as dirty. This makes repository status check for large repositories
-# much, much faster.
-# DISABLE_UNTRACKED_FILES_DIRTY="true"
-
-# Uncomment the following line if you want to change the command execution time
-# stamp shown in the history command output.
-# You can set one of the optional three formats:
-# "mm/dd/yyyy"|"dd.mm.yyyy"|"yyyy-mm-dd"
-# or set a custom format using the strftime function format specifications,
-# see 'man strftime' for details.
-# HIST_STAMPS="mm/dd/yyyy"
-
-# Would you like to use another custom folder than $ZSH/custom?
-# ZSH_CUSTOM=/path/to/new-custom-folder
-
-# Which plugins would you like to load?
-# Standard plugins can be found in $ZSH/plugins/
-# Custom plugins may be added to $ZSH_CUSTOM/plugins/
-# Example format: plugins=(rails git textmate ruby lighthouse)
-# Add wisely, as too many plugins slow down shell startup.
-plugins=(git docker docker-compose composer zsh-autosuggestions zsh-syntax-highlighting)
-# plugins=(git zsh-autosuggestions zsh-syntax-highlighting)
-
-source $ZSH/oh-my-zsh.sh
-
-# User configuration
-
-# export MANPATH="/usr/local/man:$MANPATH"
-
-# You may need to manually set your language environment
-# export LANG=en_US.UTF-8
-
-# Preferred editor for local and remote sessions
-# if [[ -n $SSH_CONNECTION ]]; then
-#   export EDITOR='vim'
-# else
-#   export EDITOR='mvim'
-# fi
-
-# Compilation flags
-# export ARCHFLAGS="-arch x86_64"
-
-# Set personal aliases, overriding those provided by oh-my-zsh libs,
-# plugins, and themes. Aliases can be placed here, though oh-my-zsh
-# users are encouraged to define aliases within the ZSH_CUSTOM folder.
-# For a full list of active aliases, run `alias`.
-#
-# Example aliases
-# alias zshconfig="mate ~/.zshrc"
-# alias ohmyzsh="mate ~/.oh-my-zsh"
-
-# To customize prompt, run `p10k configure` or edit ~/.p10k.zsh.
-[[ ! -f ~/.p10k.zsh ]] || source ~/.p10k.zsh
-
-[[ -f ~/.profile ]] && source ~/.profile

dotfiles/README

@@ -1,2 +0,0 @@
-This directory contains files whose names start with a dot.
-Make sure your file manager displays them here.

dotfiles/etc/docker/daemon.json

@@ -1,11 +0,0 @@
-{
-    "registry-mirrors": [
-        "https://dockerhub.timeweb.cloud",
-        "https://dh-mirror.gitverse.ru",
-        "https://mirror.gcr.io",
-        "https://daocloud.io",
-        "https://c.163.com/",
-        "https://registry.docker-cn.com",
-        "https://huecker.io"
-    ]
-}

gen-makefile

@@ -1,4 +1,4 @@
-#!/bin/bash
+#!/usr/bin/env bash
 [ -f Makefile ] && mv Makefile Makefile.bak
 CHR_UPGRADE='^'
 CHR_UNINSTALL='/'

helpers

@@ -1,224 +0,0 @@
-#!/bin/bash
-
-installed() {
-    command -v "$1" >/dev/null 2>&1
-}
-
-installed2() {
-    dpkg --list | grep -qw "ii  $1"
-}
-
-apt_install() {
-    sudo apt install -y --autoremove $*
-}
-
-require() {
-    sw=()
-    for package in "$@"; do
-        if ! installed "$package" && ! installed2 "$package"; then
-            sw+=("$package")
-        fi
-    done
-    if [ ${#sw[@]} -gt 0 ]; then
-        info "This packages will be installed in your system:\n${sw[*]}"
-        apt_install ${sw[*]}
-        [ $? -gt 0 ] && die "installation cancelled" 201
-    fi
-}
-
-require2() {
-    sw=()
-    for package in "$@"; do
-        if ! installed "$package" && ! installed2 "$package"; then
-            sw+=("$package")
-        fi
-    done
-    if [ ${#sw[@]} -gt 0 ]; then
-        die "This packages must be installed in your system:\n${sw[*]}" 200
-    fi
-}
-
-title() {
-    [ "$1" ] && title="$1" || title="$(grep -m 1 -oP "(?<=^##makedesc:\s).*$" ${BASH_SOURCE[1]})"
-    info
-    info "==============================================="
-    info "$title"
-    info "==============================================="
-    info
-}
-
-unpak_targz() {
-    require tar
-    tar -xzf "$1" -C "$2"
-}
-
-symlink() {
-    ln -sf "$1" "$2"
-}
-
-download() {
-    require wget
-    wget "$1" -O "$2"
-}
-
-clone() {
-    require git
-    git clone $*
-}
-
-clone_quick() {
-    require git
-    git clone $* --depth=1 --single-branch
-}
-
-abspath() {
-    echo $(realpath -q "${1/#\~/$HOME}")
-}
-
-is_writable() {
-    [ -w "$(abspath $1)" ]
-}
-
-is_dir() {
-    [ -d "$(abspath $1)" ]
-}
-
-is_file() {
-    [ -f "$(abspath $1)" ]
-}
-
-is_function() {
-    declare -F "$1" > /dev/null
-}
-
-regex_match() {
-    printf "%s" "$1" | grep -qP "$2"
-}
-
-in_array() {
-	local find=$1
-    shift
-    for e in "$@"; do
-        [[ "$e" == "$find" ]] && return 0
-    done
-    return 1
-}
-
-implode() {
-    local d=${1-}
-    local f=${2-}
-    if shift 2; then
-        printf %s "$f" "${@/#/$d}"
-    fi
-}
-
-IINFO="( i )"
-INOTE="( * )"
-IWARN="( # )"
-IERROR="( ! )"
-IFATAL="( @ )"
-ISUCCESS="( ! )"
-IASK="( ? )"
-IDEBUG="(DBG)"
-IVRB="( + )"
-
-BOLD="\e[1m"
-DIM="\e[2m"
-NOTBOLD="\e[22m" # sometimes \e[21m
-NOTDIM="\e[22m"
-NORMAL="\e[20m"
-RESET="\e[0m"
-
-FRESET="\e[39m"
-FBLACK="\e[30m"
-FWHITE="\e[97m"
-FRED="\e[31m"
-FGREEN="\e[32m"
-FYELLOW="\e[33m"
-FBLUE="\e[34m"
-FLRED="\e[91m"
-FLGREEN="\e[92m"
-FLYELLOW="\e[93m"
-FLBLUE="\e[94m"
-
-BRESET="\e[49m"
-BBLACK="\e[40m"
-BWHITE="\e[107m"
-BRED="\e[41m"
-BGREEN="\e[42m"
-BYELLOW="\e[43m"
-BBLUE="\e[44m"
-BLRED="\e[101m"
-BLGREEN="\e[102m"
-BLYELLOW="\e[103m"
-BLBLUE="\e[104m"
-
-dt() {
-    echo "[$(date +'%H:%M:%S')] "
-}
-
-ask() {
-    IFS= read -rp "$(print ${BOLD}${BBLUE}${FWHITE}${IASK}${BRESET}\ ${BOLD}$1 ): " $2
-}
-
-print() {
-    echo -e "$*${RESET}"
-}
-
-debug() {
-    if [ "$2" ]; then
-        print "${DIM}${BOLD}${RESET}${DIM}${FUNCNAME[1]:-?}():${BASH_LINENO:-?}\t$1 "
-    else
-        print "${DIM}${BOLD}${RESET}${DIM}$1 "
-    fi
-}
-
-verbose() {
-    print "${BOLD}${IVRB}${RESET}${FYELLOW} $1 "
-}
-
-info() {
-    print "${BOLD}${FWHITE}${BLBLUE}${IINFO}${RESET}${FWHITE} $1 "
-}
-
-note() {
-    print "${BOLD}${DIM}${FWHITE}${INOTE}${RESET} $1 "
-}
-
-success() {
-    print "${BOLD}${BGREEN}${FWHITE}${ISUCCESS}${BRESET}$FGREEN $1 "
-}
-
-warn() {
-    print "${BOLD}${BYELLOW}${FBLACK}${IWARN}${BRESET}${FYELLOW} Warning:${RESET} $1 "
-}
-
-error() {
-    print "${BOLD}${BLRED}${FWHITE}${IERROR} Error: ${BRESET}${FLRED} $1 " >&2
-}
-
-fatal() {
-    print "${BOLD}${BRED}${FWHITE}${IFATAL} FATAL: $1 " >&2
-    print_stacktrace
-}
-
-die() {
-    error "${1:-halted}"
-    exit ${2:-100}
-}
-
-print_stacktrace() {
-    STACK=""
-    local i
-    local stack_size=${#FUNCNAME[@]}
-    debug "Callstack:"
-    # for (( i=$stack_size-1; i>=1; i-- )); do
-    for (( i=1; i<$stack_size; i++ )); do
-        local func="${FUNCNAME[$i]}"
-        [ x$func = x ] && func=MAIN
-        local linen="${BASH_LINENO[$(( i - 1 ))]}"
-        local src="${BASH_SOURCE[$i]}"
-        [ x"$src" = x ] && src=non_file_source
-        debug "   at $func $src:$linen"
-    done
-}

helpers.sh

@@ -0,0 +1,20 @@
+#!/usr/bin/env bash
+set -oe pipefail
+
+__root__=$( dirname $(readlink -e -- "${BASH_SOURCE}"))
+source $__root__/helpers/io.sh || exit 255
+source $__root__/helpers/git.sh || exit 255
+source $__root__/helpers/basic.sh || exit 255
+source $__root__/helpers/debug.sh || exit 255
+source $__root__/helpers/packages.sh || exit 255
+
+title() {
+    [[ $__AAA_NO_TITLE = 1 ]] || {
+        [ "$1" ] && title="$1" || title="$(grep -m 1 -oP "(?<=^##makedesc:\s).*$" ${BASH_SOURCE[1]})"
+        info
+        info "==============================================="
+        info "$title"
+        info "==============================================="
+        info
+    }
+}

install/_example

@@ -0,0 +1,46 @@
+#!/usr/bin/env bash
+##makedesc: Example script
+
+set -eo pipefail
+
+install() {
+    echo
+    echo "==============================================="
+    echo "Installing example"
+    echo "==============================================="
+    echo
+    sleep 3
+    echo
+    echo "Finish! example v1.2.3"
+    echo
+}
+
+upgrade() {
+    echo
+    echo "==============================================="
+    echo "Upgrading example"
+    echo "==============================================="
+    echo
+    sleep 3
+    echo
+    echo "Finish! example v1.2.3"
+    echo
+}
+
+remove() {
+    echo
+    echo "==============================================="
+    echo "Removing example"
+    echo "==============================================="
+    echo
+    sleep 3
+    echo
+    echo "Finish!"
+    echo
+}
+
+case "$1" in
+    u|upgrade|update) upgrade ;;
+    r|remove|d|delete|p|purge) remove ;;
+    *) install ;;
+esac

install/anytype

@@ -0,0 +1,46 @@
+#!/usr/bin/env bash
+##makedesc: Manage anytype (deb)
+
+set -eo pipefail
+
+installDir="$HOME/install/anytype"
+
+install() {
+    release="$(curl -s 'https://api.github.com/repos/anyproto/anytype-ts/releases/latest')"
+    tag="$(echo "$release" | jq -r '.tag_name')"
+    asset="$(echo "$release" | jq -r '.assets.[] | select(.name | test("amd64.deb$"))')"
+    url="$(echo "$asset" | jq -r '.browser_download_url')"
+    echo -e "$tag $url"
+
+    echo
+    echo "==============================================="
+    echo "Installing anytype $tag"
+    echo "==============================================="
+    echo
+
+    mkdir -p "$installDir"
+    filepath="$installDir/anytype_${tag}_amd46.deb"
+    wget "$url" -O "$filepath"
+    sudo dpkg -i "$filepath"
+
+    echo
+    echo "Finish! $tag"
+    echo
+}
+
+remove() {
+    echo
+    echo "==============================================="
+    echo "Removing anytype"
+    echo "==============================================="
+    echo
+    sudo apt purge -y anytype*
+    echo
+    echo "Finish!"
+    echo
+}
+
+case "$1" in
+    r|remove|d|delete|p|purge) remove ;;
+    *) install ;;
+esac

install/apache2

@@ -1,15 +1,46 @@
-#!/bin/bash
+#!/usr/bin/env bash
-##makedesc: Install apache2 (latest)
+##makedesc: Manage apache2 (apt)
-source `dirname $0`/../helpers || exit 255
 
-title
+install() {
-
-sudo apt install -y --autoremove apache2 && \
-    sudo systemctl restart apache2
-
-[ $? = 0 ] && {
     echo
-    success "apache2 installed!"
+    echo "==============================================="
-    apache2 -v
+    echo "Installing apache2"
+    echo "==============================================="
+    echo
+    sudo apt install -y apache2
+    sudo systemctl restart apache2
+    echo
+    echo "Finish! $(apache2 -v)"
     echo
 }
+
+upgrade() {
+    echo
+    echo "==============================================="
+    echo "Upgrading apache2"
+    echo "==============================================="
+    echo
+    sudo apt upgrade -y apache2 apache2-data apache2-utils
+    sudo systemctl restart apache2
+    echo
+    echo "Finish! $(apache2 -v)"
+    echo
+}
+
+remove() {
+    echo
+    echo "==============================================="
+    echo "Removing apache2"
+    echo "==============================================="
+    echo
+    sudo apt purge -y apache2*
+    echo
+    echo "Finish!"
+    echo
+}
+
+case "$1" in
+    u|upgrade|update) upgrade ;;
+    r|remove|d|delete|p|purge) remove ;;
+    *) install ;;
+esac

install/apt

@@ -1,8 +1,5 @@
-#!/bin/bash
+#!/usr/bin/env bash
-##makedesc: Install software from apt
+##makedesc: Install basic software from apt
-source `dirname $0`/../helpers || exit 255
-
-title
 
 sudo apt update && \
     sudo apt upgrade -y --autoremove && \
@@ -27,7 +24,6 @@ sudo apt update && \
         libghc-zlib-dev \
         libssl-dev \
         lsb-release \
-        lsp-plugins \
         make \
         mc \
         meld \
@@ -36,24 +32,19 @@ sudo apt update && \
         net-tools \
         nmap \
         p7zip-full \
-        pulseeffects \
+        easyeffects \
         software-properties-common \
-        terminator \
         ubuntu-restricted-extras \
         unzip \
         vlc \
         ffmpeg \
-        xclip \
         inotify-tools \
         notify-osd \
         fonts-open-sans \
         libnotify-bin \
         tree \
         earlyoom
+        # terminator
+        # xclip
         # sqlitebrowser
-        # etckeeper \
+        # etckeeper
-        # geoclue-2.0 \
-        # gnome-software \
-        # minder \
-        # redshift \
-        # redshift-gtk

install/canon-mg2500

@@ -1,17 +1,52 @@
-#!/bin/bash
+#!/usr/bin/env bash
-##makedesc: Install Canon Pixma MG2500 + ppa
+##makedesc: Canon Pixma MG2500 + ppa
-source `dirname $0`/../helpers || exit 255
 
-title
+install() {
-
-sudo add-apt-repository -y ppa:thierry-f/fork-michael-gruz && \
-    sudo apt install -y \
-        cnijfilter-mg2500series \
-        scangearmp-mg2500series
-
-[ $? = 0 ] && {
     echo
-    success "Canon Pixma MG2500 installed!"
+    echo "==============================================="
-    info "Now you must add a new printer in your system."
+    echo "Installing Canon Pixma MG2500 + ppa"
+    echo "==============================================="
+    echo
+    sudo add-apt-repository -y ppa:thierry-f/fork-michael-gruz
+    sudo apt install -y cnijfilter-mg2500series scangearmp-mg2500series
+    echo
+    echo "Finish!"
+    echo "Drivers for Canon Pixma MG2500 installed!"
+    echo "Now you must reboot PC and connect your printer."
     echo
 }
+
+upgrade() {
+    echo
+    echo "==============================================="
+    echo "Upgrading Canon Pixma MG2500 + ppa"
+    echo "==============================================="
+    echo
+    sudo apt upgrade -y cnijfilter-mg2500series scangearmp-mg2500series
+    echo
+    echo "Finish! Canon Pixma MG2500 + ppa"
+    echo
+}
+
+remove() {
+    echo
+    echo "==============================================="
+    echo "Removing Canon Pixma MG2500 + ppa"
+    echo "==============================================="
+    echo
+    # sudo apt purge -y cnijfilter-mg2500series scangearmp-mg2500series
+    sudp dpkg -r cnijfilter-mg2500series
+    sudp dpkg -r cnijfilter-common
+    sudp dpkg -r scangearmp-mg2500series
+    sudp dpkg -r scangearmp-common
+    sudo add-apt-repository -ry ppa:thierry-f/fork-michael-gruz
+    echo
+    echo "Finish!"
+    echo
+}
+
+case "$1" in
+    u|upgrade|update) upgrade ;;
+    r|remove|d|delete|p|purge) remove ;;
+    *) install ;;
+esac

install/chrome

@@ -1,20 +1,56 @@
-#!/bin/bash
+#!/usr/bin/env bash
-##makedesc: Install google chrome (latest)
+##makedesc: Google Chrome (latest)
-source `dirname $0`/../helpers || exit 255
+
+set -eo pipefail
 
 # https://t.me/axenov_blog/251
 
-title
+dest="$HOME/install/deb"
+deb="$dest/google-chrome.deb"
+url="https://dl.google.com/linux/direct/google-chrome-stable_current_amd64.deb"
 
-mkdir -p "$HOME/install"
+install() {
-
-download "https://dl.google.com/linux/direct/google-chrome-stable_current_amd64.deb" \
-    "$HOME/install/google-chrome.deb" && \
-    sudo dpkg -i "$HOME/install/google-chrome.deb"
-
-[ $? = 0 ] && {
     echo
-    success "Google Chrome installed!"
+    echo "==============================================="
-    google-chrome --version
+    echo "Installing Google Chrome"
+    echo "==============================================="
+    echo
+    mkdir -p "$dest"
+    wget "$url" -O "$deb"
+    sudo dpkg -i "$deb"
+    echo
+    echo "Finish! $(google-chrome --version)"
     echo
 }
+
+upgrade() {
+    echo
+    echo "==============================================="
+    echo "Upgrading Google Chrome"
+    echo "==============================================="
+    echo
+    mkdir -p "$dest"
+    wget "$url" -O "$deb"
+    sudo dpkg -i "$deb"
+    echo
+    echo "Finish! $(google-chrome --version)"
+    echo
+}
+
+remove() {
+    echo
+    echo "==============================================="
+    echo "Removing Google Chrome"
+    echo "==============================================="
+    echo
+    sudo dpkg -r google-chrome
+    echo
+    echo "Finish!"
+    echo
+}
+
+case "$1" in
+    u|upgrade|update) upgrade ;;
+    r|remove|d|delete|p|purge) remove ;;
+    *) install ;;
+esac

install/clamav

@@ -0,0 +1,56 @@
+#!/usr/bin/env bash
+##makedesc: ClamAV
+
+set -eo pipefail
+
+install() {
+    echo
+    echo "==============================================="
+    echo "Installing clamav"
+    echo "==============================================="
+    echo
+
+    sudo apt install -y clamav
+    echo "DatabaseMirror packages.microsoft.com/clamav" \
+        | sudo tee -a /etc/clamav/freshclam.conf
+	sudo freshclam
+
+    echo
+    echo "Finish!"
+    echo
+}
+
+upgrade() {
+    echo
+    echo "==============================================="
+    echo "Upgrading clamav"
+    echo "==============================================="
+    echo
+
+    sudo apt upgrade -y clamav
+	sudo freshclam
+
+    echo
+    echo "Finish!"
+    echo
+}
+
+remove() {
+    echo
+    echo "==============================================="
+    echo "Removing clamav"
+    echo "==============================================="
+    echo
+
+    sudo apt purge -y clamav*
+
+    echo
+    echo "Finish!"
+    echo
+}
+
+case "$1" in
+    u|upgrade|update) upgrade ;;
+    r|remove|d|delete|p|purge) remove ;;
+    *) install ;;
+esac

install/composer

@@ -1,6 +1,7 @@
-#!/bin/bash
+#!/usr/bin/env bash
 ##makedesc: Install composer (latest)
-source `dirname $0`/../helpers || exit 255
+here=$( dirname $(readlink -e -- "${BASH_SOURCE}"))
+source "$here/../helpers.sh" || exit 255
 
 # https://getcomposer.org/doc/faqs/how-to-install-composer-programmatically.md
 
@@ -8,34 +9,30 @@ title
 
 require php
 
-if installed "composer"; then
+if installed composer; then
-    warn "WARNING: Removing current composer to install its actual version"
+    warn "WARNING: Removing current composer to install latest one"
-    sudo apt remove -y --autoremove composer
+    composer --version
-    sudo rm -f \
+    __AAA_NO_TITLE=1 source $here/../uninstall/composer
-        "$HOME/.local/bin/composer" \
-        /bin/composer \
-        /usr/bin/composer \
-        /usr/local/bin/composer \
-        /usr/src/composer \
-        "$HOME/.local/bin/composer"
 fi
 
-mkdir -p "$HOME/install" "$HOME/.local/bin"
+mkdir -p "$HOME/install/other" "$HOME/.local/bin"
-download "https://getcomposer.org/installer" "$HOME/install/composer-setup.php" && \
-    php "$HOME/install/composer-setup.php" --install-dir="$HOME/.local/bin/composer"
 
-[ $? = 0 ] && {
+download "https://getcomposer.org/installer" \
-    COMPOSER_GLOBAL_HOME="$($HOME/.local/bin/composer config -g home)"
+    "$HOME/install/other/composer-setup.php"
-    NEWPATH="export PATH=\"$COMPOSER_GLOBAL_HOME/vendor/bin:\${PATH}\""
-    cat "$HOME/.profile" | grep -qoh "$NEWPATH" || {
-        $NEWPATH
-        echo "$NEWPATH" >> "$HOME/.profile"
-    }
 
-    echo
+php "$HOME/install/other/composer-setup.php" \
-    success "composer installed!"
+    --install-dir="$HOME/.local/bin/" \
-    composer --version
+    --filename="composer"
-    echo
+
+COMPOSER_GLOBAL_HOME="$($HOME/.local/bin/composer config -g home)"
+NEWPATH="PATH=\"$COMPOSER_GLOBAL_HOME/vendor/bin:\${PATH}\""
+cat "$HOME/.profile" | grep -qoh "$NEWPATH" || {
+    export "$NEWPATH"
+    echo "export $NEWPATH" >> "$HOME/.profile"
 }
 
 source "$HOME/.profile"
+
+success "composer installed!"
+composer --version
+

install/docker

@@ -1,35 +1,78 @@
-#!/bin/bash
+#!/usr/bin/env bash
-##makedesc: Install docker (latest) + docker-compose (latest) + ppa
+##makedesc: Docker + ppa
-source `dirname $0`/../helpers || exit 255
 
 # https://docs.docker.com/engine/install/ubuntu/
+# https://docs.docker.com/engine/install/linux-postinstall/#manage-docker-as-a-non-root-user
 
-title
+set -eo pipefail
 
-require ca-certificates
+doRemove() {
-require curl
+    sudo apt purge -y docker* podman-docker containerd runc
-require gnupg
+}
-require lsb-release
 
-sudo mkdir -p /etc/apt/keyrings
+install_() {
-curl -fsSL https://download.docker.com/linux/ubuntu/gpg \
+    echo
-| sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg && \
+    echo "==============================================="
-    sudo chmod a+r /etc/apt/keyrings/docker.gpg && \
+    echo "Installing Docker"
-    echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable" \
+    echo "==============================================="
-    | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null && \
+    echo
-    sudo apt update && \
+    doRemove
-    sudo apt install -y --autoremove \
+    sudo apt install -y ca-certificates lsb-release
+    source /etc/os-release
+    codename="$VERSION_CODENAME"
+    key="/etc/apt/keyrings/docker.asc"
+    arch=$(dpkg --print-architecture)
+    sudo install -m 0755 -d /etc/apt/keyrings
+    curl -fsSL "https://download.docker.com/linux/ubuntu/gpg" -o "$key"
+    sudo chmod a+r $key
+    echo "deb [arch=$arch signed-by=$key] https://download.docker.com/linux/ubuntu $codename stable" \
+        | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
+    sudo apt update
+    sudo apt install -y \
         docker-ce \
         docker-ce-cli \
         containerd.io \
-        docker-compose-plugin && \
+        docker-buildx-plugin \
-    sudo usermod -aG docker $(whoami)
+        docker-compose-plugin
-
+    sudo usermod -aG docker "$(whoami)"
-[ $? = 0 ] && {
+    newgrp docker
     echo
-    success "Docker installed!"
+    echo "Finish! $(docker --version)"
-    info "Probably, you need to relogin to apply 'docker' group."
+    echo "Probably, you need to relogin to apply 'docker' group permanently."
-    info "Your ones currently are: $(groups)"
-    docker --version
     echo
 }
+
+upgrade() {
+    echo
+    echo "==============================================="
+    echo "Upgrading Docker"
+    echo "==============================================="
+    echo
+    sudo apt upgrade -y \
+        docker-ce \
+        docker-ce-cli \
+        containerd.io \
+        docker-buildx-plugin \
+        docker-compose-plugin
+    echo
+    echo "Finish!"
+    echo
+}
+
+remove() {
+    echo
+    echo "==============================================="
+    echo "Removing Docker"
+    echo "==============================================="
+    echo
+    doRemove
+    echo
+    echo "Finish!"
+    echo
+}
+
+case "$1" in
+    u|upgrade|update) upgrade ;;
+    r|remove|d|delete|p|purge) remove ;;
+    *) install ;;
+esac

install/dots

@@ -1,6 +1,6 @@
-#!/bin/bash
+#!/usr/bin/env bash
 ##makedesc: Install dotfiles
-source `dirname $0`/../helpers || exit 255
+source "$( dirname $(readlink -e -- "${BASH_SOURCE}"))/../helpers.sh" || exit 255
 
 title
 

install/droidcam

@@ -1,22 +1,21 @@
-#!/bin/bash
+#!/usr/bin/env bash
 ##makedesc: Install droidcam v1.9.0
-source `dirname $0`/../helpers || exit 255
+source "$( dirname $(readlink -e -- "${BASH_SOURCE}"))/../helpers.sh" || exit 255
 
-# https://www.dev47apps.com/droidcam/linux/
+#TODO
+exit
+
+# https://droidcam.app/linux/
 
 title
 
-mkdir -p "$HOME/install/droidcam"
+mkdir -p "$HOME/install/deb/"
 
-download "https://files.dev47apps.net/linux/droidcam_1.9.0.zip" "$HOME/install/droidcam.zip" && \
+download "https://beta.droidcam.app/go/droidCam.client.setup.deb" "$HOME/install/deb/droidcam_client_amd64.deb"
-    unzip -oq "$HOME/install/droidcam.zip" -d "$HOME/install/droidcam" && \
-    cd "$HOME/install/droidcam" && \
-    sudo ./install-client
 
-[ $? = 0 ] && {
+dpkg_install "$HOME/install/deb/droidcam_client_amd64.deb"
-    echo
+apt_install v4l2loopback-dkms
-    success "droidcam installed!"
+
-    info "Don't forget to install the android app:"
+success "droidcam installed!"
-    info "https://play.google.com/store/apps/developer?id=Dev47Apps"
+info "Don't forget to install the android app:"
-    echo
+info "https://play.google.com/store/apps/developer?id=Dev47Apps"
-}

install/droidcam-obs

@@ -1,11 +1,22 @@
-#!/bin/bash
+#!/usr/bin/env bash
 ##makedesc: Install droidcam-obs plugin v1.5.1
 
+#TODO
+# ffmpeg -version | head -n 1 | awk '{print $3}'
+# https://github.com/dev47apps/droidcam-obs-plugin/releases
+
+exit
+
+
+
 # https://www.dev47apps.com/droidcam/linux/
 # https://www.dev47apps.com/obs/
 # https://www.dev47apps.com/obs/usage.html
 # https://obsproject.com/forum/threads/how-to-start-virtual-camera-without-sudo-privileges.139783/
 
+
+
+
 echo
 echo "==============================================="
 echo "Installing droidcam-obs..."

install/flameshot

@@ -1,15 +1,54 @@
-#!/bin/bash
+#!/usr/bin/env bash
 ##makedesc: Install flameshot (latest)
-source `dirname $0`/../helpers || exit 255
+source "$( dirname $(readlink -e -- "${BASH_SOURCE}"))/../helpers.sh" || exit 255
 
 title
 
-sudo apt install -y --autoremove flameshot && \
+# https://github.com/flameshot-org/flameshot?tab=readme-ov-file#compilation
-    sudo systemctl restart flameshot
+# sudo apt install -y --autoremove flameshot && \
+#     sudo systemctl restart flameshot
+
+dir="$HOME/install"
+clone_dir="$dir/flameshot"
+mkdir -p "$dir"
+
+sudo apt install -y \
+    g++ \
+    cmake \
+    build-essential \
+    qtbase5-dev \
+    qttools5-dev-tools \
+    libqt5svg5-dev \
+    qttools5-dev \
+    libqt5dbus5 \
+    libqt5network5 \
+    libqt5core5a \
+    libqt5widgets5 \
+    libqt5gui5 \
+    libqt5svg5
+
+if [ ! -d "$clone_dir" ]; then
+    git clone --depth=1 --single-branch https://github.com/flameshot-org/flameshot.git "$clone_dir"
+fi
+
+# Directory where build files will be placed, may be relative
+export BUILD_DIR=build
+
+# Directory prefix where flameshot will be installed. If you are just building and don't want to
+# install, comment this environment variable.
+# This excludes the bin/flameshot part of the install,
+# e.g. in /opt/flameshot/bin/flameshot, the CMAKE_INSTALL_PREFIX is /opt/flameshot
+# This must be an absolute path. Requires CMAKE 3.29.
+export CMAKE_INSTALL_PREFIX=/opt/flameshot
+
+cd "$clone_dir" && \
+    git pull && \
+    cmake -S . -B "$BUILD_DIR" && \
+    cmake --build "$BUILD_DIR"
 
 [ $? = 0 ] && {
     echo
     success "flameshot installed!"
-    flameshot -v
+    # /opt/flameshot/flameshot -v
     echo
 }

install/frkn

@@ -1,53 +0,0 @@
-#!/bin/bash
-##makedesc: Install Wireguard + FRKN
-source `dirname $0`/../helpers || exit 255
-
-# https://frkn.org/ru/installation
-
-title
-
-mkdir -p "$HOME/install/frkn"
-cd "$HOME/install/frkn"
-
-apt_install wireguard jq
-
-countries=(uk ru nl nl2 ch)
-for idx in ${!countries[@]}; do
-    country=${countries[idx]}
-    info "Downloading config for $country ($(expr $idx + 1)/${#countries[@]})"
-
-    json=$(curl -s "https://api.frkn.org/peer?location=$country" | jq)
-
-    iface_address=$(echo $json | jq -r .iface.address)
-    iface_privkey=$(echo $json | jq -r .iface.key)
-    iface_dns=$(echo $json | jq -r .iface.dns)
-    peer_pubkey=$(echo $json | jq -r .peer.pubkey)
-    peer_psk=$(echo $json | jq -r .peer.psk)
-    peer_allowed_ips=$(echo $json | jq -r .peer.allowed_ips)
-    peer_endpoint=$(echo $json | jq -r .peer.endpoint)
-
-    cat << EOF > "frkn-$country.conf"
-[Interface]
-Address = $iface_address
-DNS = $iface_dns
-PrivateKey = $iface_privkey
-
-[Peer]
-PublicKey = $peer_pubkey
-PresharedKey = $peer_psk
-AllowedIPs = $peer_allowed_ips
-Endpoint = $peer_endpoint
-PersistentKeepalive = 25
-EOF
-
-done
-
-sudo cp frkn-*.conf /etc/wireguard/
-
-[ $? = 0 ] && {
-    echo
-    success "Wireguard + FRKN installed!"
-    wg --version
-    info "Use 'wg-quick (up|down) frkn-($(implode '|' ${countries[@]}))' to control connections"
-    info "Use 'sudo wg show' to see connection status"
-}

install/git

@@ -1,6 +1,6 @@
-#!/bin/bash
+#!/usr/bin/env bash
 ##makedesc: Install git (latest)
-source `dirname $0`/../helpers || exit 255
+source "$( dirname $(readlink -e -- "${BASH_SOURCE}"))/../helpers.sh" || exit 255
 
 title
 

install/golang

@@ -1,28 +1,55 @@
-#!/bin/bash
+#!/usr/bin/env bash
-##makedesc: Install golang v1.21.0
+##makedesc: Install golang
-source `dirname $0`/../helpers || exit 255
 
 # https://go.dev/dl/
 # https://golang.org/doc/install
-# https://www.vultr.com/docs/install-the-latest-version-of-golang-on-ubuntu
+# https://github.com/udhos/update-golang/blob/master/update-golang.sh
 
-[ $1 ] && VERSION="$1" || VERSION="1.21.6"
+set -eo pipefail
-title "Installing golang v$VERSION..."
 
-FILE="go$VERSION.linux-amd64.tar.gz"
+doRemove() {
-sudo rm -rf /usr/local/go && \
+    [ -d "/usr/local/go" ] && sudo rm -rf "/usr/local/go"
-    download "https://golang.org/dl/$FILE" "/tmp/$FILE" && \
+}
-    sudo tar -xzf "/tmp/$FILE" -C /usr/local && \
-    rm -rf "/tmp/$FILE" && \
-    sudo chown $USER: -R /usr/local/go && \
-    echo 'export PATH="/usr/local/go/bin:$PATH"' >> "$HOME/.profile" && \
-    echo "export GOPATH=\"\$HOME/.go\"" >> "$HOME/.profile" && \
-    source ~/.profile
 
-[ $? = 0 ] && {
+install() {
+    dlUrl="https://go.dev/dl"
+    json=$(curl -sSL "$dlUrl/?mode=json")
+    version=$(echo "$json" | jq -r '.[0].version')
     echo
-    success "golang installed!"
+    echo "==============================================="
-    info "NOTE: now run 'source ~/.profile' to apply new env vars"
+    echo "Installing golang v$version"
+    echo "==============================================="
+    echo
+    latestJson=$(echo "$json" | jq -r '.[0].files.[] | select (.kind == "archive" and .os == "linux" and .arch == "amd64")')
+    fileName=$(echo "$latestJson" | jq -r '.filename')
+    fileUrl="$dlUrl/$fileName"
+    downloadPath="$HOME/install"
+    archivePath="$downloadPath/$fileName"
+    doRemove
+    [ -f "$archivePath" ] || wget "$fileUrl" -O "$archivePath"
+    [ -f "$archivePath" ] && sudo tar -xzf "$archivePath" -C /usr/local
+    sudo chown "$USER": -R /usr/local/go
+    echo 'export PATH="/usr/local/go/bin:$PATH"' >> "$HOME/.profile"
+    echo "export GOPATH=\"\$HOME/.go\"" >> "$HOME/.profile"
+    echo
+    echo "Finish!"
     go version
+}
+
+remove() {
+    echo
+    echo "==============================================="
+    echo "Removing golang"
+    echo "==============================================="
+    echo
+    doRemove
+    echo
+    echo "Finish!"
     echo
 }
+
+case "$1" in
+    r|remove|d|delete|p|purge) remove ;;
+    *) install ;;
+esac
+

install/grub-customizer

@@ -1,6 +1,6 @@
-#!/bin/bash
+#!/usr/bin/env bash
 ##makedesc: Install grub-customizer (latest + ppa)
-source `dirname $0`/../helpers || exit 255
+source "$( dirname $(readlink -e -- "${BASH_SOURCE}"))/../helpers.sh" || exit 255
 
 title
 

install/jbmono

@@ -1,20 +0,0 @@
-#!/bin/bash
-##makedesc: Install JetBrains Mono fonts
-source `dirname $0`/../helpers || exit 255
-
-# https://www.jetbrains.com/lp/mono/#how-to-install
-
-title
-
-require unzip
-
-mkdir -p "$HOME/install/jbmono" "$HOME/.local/share/fonts/"
-download "https://download.jetbrains.com/fonts/JetBrainsMono-2.304.zip" "$HOME/install/jbmono.zip" && \
-    unzip -oj "$HOME/install/jbmono.zip" "fonts/ttf/*.ttf" -d "$HOME/.local/share/fonts/" && \
-    fc-cache -vf "$HOME/.local/share/fonts/"
-
-[ $? = 0 ] && {
-    echo
-    success "JetBrains Mono fonts installed!"
-    echo
-}

install/kde-appmenu

@@ -1,4 +1,4 @@
-#!/bin/bash (latest)
+#!/usr/bin/env bash (latest)
 ##makedesc: Install KDE Window AppMenu Applet
 
 echo

install/kde-backports

@@ -1,6 +1,6 @@
-#!/bin/bash
+#!/usr/bin/env bash
 ##makedesc: Install KDE Backports
-source `dirname $0`/../helpers || exit 255
+source "$( dirname $(readlink -e -- "${BASH_SOURCE}"))/../helpers.sh" || exit 255
 
 title
 

install/kde-file-templates

@@ -1,4 +1,4 @@
-#!/bin/bash
+#!/usr/bin/env bash
 ##makedesc: Install file templates (KDE)
 
 echo
@@ -48,7 +48,7 @@ EOF
 
 echo "- Shell" ####################################################
 cat <<EOF > "$TPL_SRC/template.sh"
-#!/bin/bash
+#!/usr/bin/env bash
 EOF
 
 cat << EOF > "$TPL_DIR/sh.desktop"

install/kde-portal

@@ -1,4 +1,4 @@
-#!/bin/bash
+#!/usr/bin/env bash
 ##makedesc: Install KDE portal
 
 echo

install/lazynvim

@@ -1,64 +0,0 @@
-#!/bin/bash
-# https://www.devas.life/effective-neovim-setup-for-web-development-towards-2024/
-
-set -eo pipefail
-trap ontrap SIGINT SIGTERM SIGSTOP
-
-ontrap() {
-    echo
-    echo "[!] Interrupted"
-    exit
-}
-
-[ -z "$1" ] && version=0.10.1 || version="$1"
-
-filedir="$HOME/install/neovim-$version"
-filename="nvim-linux64.tar.gz"
-filepath="$filedir/$filename"
-configdir="$HOME/.config/nvim"
-localdir="$HOME/.local"
-
-echo "[*] Installing neovim v$version"
-
-if [ -d $configdir ]; then
-    mv $configdir "$configdir.bak-$(date +'%Y%m%d_%H%M%S')"
-fi
-
-mkdir -p $filedir $configdir $localdir/{bin,lib,share}
-
-if [ ! -f $filepath ]; then
-    echo "[*] Downloading to $filepath..."
-    wget -q https://github.com/neovim/neovim/releases/download/v$version/nvim-linux64.tar.gz \
-        -O $filepath \
-        --show-progress
-fi
-
-echo "[*] Unpacking: $filepath..."
-tar -zxf $filepath -C $filedir
-cp -rf $filedir/nvim-linux64/bin/nvim $localdir/bin/
-cp -rf $filedir/nvim-linux64/lib/nvim $localdir/lib/
-cp -rf $filedir/nvim-linux64/share $localdir/share
-rm -rf $filedir/nvim-linux64
-
-echo "[*] Reinit git repo..."
-git clone https://github.com/LazyVim/starter \
-    $configdir \
-    --depth=1 \
-    --single-branch
-cd $configdir
-rm -rf .git
-git init -q
-
-
-
-
-
-
-
-
-
-
-
-
-
-

install/libreoffice

@@ -1,4 +1,4 @@
-#!/bin/bash
+#!/usr/bin/env bash
 ##makedesc: Install libreoffice
 
 echo

install/lite-xl

@@ -1,43 +1,45 @@
-#!/bin/bash
+#!/usr/bin/env bash
-##makedesc: Install lite-xl
+##makedesc: Install lite-xl v2.1.7
 
 # https://github.com/lite-xl/lite-xl/releases
-# https://lite-xl.com/en/documentation/build
+# https://lite-xl.com/setup/getting-started/
 
 echo
 echo "==============================================="
-echo "Installing lite-xl v2.1.0..."
+echo "Installing lite-xl v2.1.7..."
 echo "==============================================="
 echo
 
-tar_url="https://github.com/lite-xl/lite-xl/releases/download/v2.1.0/lite-xl-v2.1.0-addons-linux-x86_64-portable.tar.gz"
+tar_url="https://github.com/lite-xl/lite-xl/releases/download/v2.1.7/lite-xl-v2.1.7-addons-linux-x86_64-portable.tar.gz"
-tar_filepath="/tmp/lite-xl.tar.gz"
+lpm_url="https://github.com/lite-xl/lite-xl-plugin-manager/releases/download/latest/lpm.x86_64-linux"
+tar_filepath="$HOME/install/lite-xl-v2.1.7.tar.gz"
 untar_dir="$HOME/install"
-untar_subdir="$untar_dir/lite-xl"
-dest_bin_dir="$HOME/.local/bin"
-dest_config_dir="$HOME/.config/lite-xl"
-dest_share_dir="$HOME/.local/share"
-dest_share_subdir="$dest_share_dir/lite-xl"
 
-wget "$tar_url" -O "$tar_filepath"
+rm -rf \
+    "$HOME/.local/bin/lpm" \
+    "$HOME/install/lite-xl" \
+    "$HOME/.local/bin/lite-xl" \
+    "$HOME/.local/share/lite-xl"
+
 mkdir -vp \
     "$untar_dir" \
-    #"$dest_config" \
+    "$HOME/.local/bin" \
-    "$dest_bin_dir" \
+    "$HOME/.local/share/lite-xl"
-    "$dest_share_dir"
 
-tar -xzf "$tar_filepath" -C "$untar_dir"
+wget "$tar_url" -O "$tar_filepath" && \
-mv -fv "$untar_subdir/lite-xl" "$dest_bin_dir/lite-xl"
+    wget "$lpm_url" -O "$HOME/.local/bin/lpm" && \
-mv -fvT "$untar_subdir/data" "$dest_share_subdir"
+    chmod +x "$HOME/.local/bin/lpm" && \
-rm -fr "$tar_file" "$untar_subdir"
+    tar -xzf "$tar_filepath" -C "$untar_dir" && \
+    cp -vf "$untar_dir/lite-xl/lite-xl" "$HOME/.local/bin/" && \
+    cp -vfr "$untar_dir"/lite-xl/data/* "$HOME/.local/share/lite-xl/"
 
 # echo -e "\nexport LITE_SCALE=1 # https://github.com/lite-xl/lite-xl/issues/1173\n" >> $HOME/.profile
-cat << EOF > "$dest_share_dir/applications/org.lite_xl.lite_xl.desktop"
+cat << EOF > "$HOME/.local/share/applications/org.lite_xl.lite_xl.desktop"
 [Desktop Entry]
 Type=Application
 Name=Lite XL
 Comment=A lightweight text editor written in Lua
-Exec=env LITE_SCALE=1 ${dest_bin_dir}/lite-xl %F
+Exec=$HOME/.local/bin/lite-xl %F
 Icon=lite-xl
 Terminal=false
 StartupWMClass=lite-xl
@@ -48,53 +50,6 @@ EOF
 sudo update-desktop-database && \
     xdg-desktop-menu forceupdate
 
-echo
-echo "==============================================="
-echo "Installing lite-xl plugins..."
-echo "https://github.com/lite-xl/lite-xl-plugins"
-echo "==============================================="
-echo
-
-download_plugin() {
-    echo "- $1"
-    curl -s "https://raw.githubusercontent.com/lite-xl/lite-xl-plugins/master/plugins/$1.lua" \
-        > "$dest_share_subdir/plugins/$1.lua"
-}
-
-download_plugin "align_carets"
-download_plugin "autosaveonfocuslost"
-download_plugin "bracketmatch"
-download_plugin "copyfilelocation"
-download_plugin "dragdropselected"
-download_plugin "fontconfig"
-download_plugin "force_syntax"
-download_plugin "lfautoinsert"
-download_plugin "markers"
-download_plugin "memoryusage"
-download_plugin "minimap"
-download_plugin "navigate"
-download_plugin "openselected"
-download_plugin "restoretabs"
-download_plugin "smoothcaret"
-
-# echo "- eofnewline-xl"
-# curl -s "https://raw.githubusercontent.com/bokunodev/lite_modules/master/plugins/eofnewline-xl.lua" \
-#     > "$dest_share_subdir/plugins/eofnewline-xl.lua"
-
-echo "- language_env"
-curl -s "https://raw.githubusercontent.com/anthonyaxenov/lite-xl-env-syntax/master/language_env.lua" \
-    > "$dest_share_subdir/plugins/language_env.lua"
-
-echo "- language_ignore"
-curl -s "https://raw.githubusercontent.com/anthonyaxenov/lite-xl-ignore-syntax/master/language_ignore.lua" \
-    > "$dest_share_subdir/plugins/language_ignore.lua"
-
-# echo "- language-containerfile"
-# git clone -q "https://github.com/FilBot3/lite-xl-language-containerfile.git" \
-#     "$dest_share_subdir/plugins/language_containerfile"
-
 echo
 echo "Finish!"
-echo "- $dest_bin_dir/lite-xl"
-echo "- $dest_share_subdir"
 echo

install/mariadb

@@ -1,4 +1,4 @@
-#!/bin/bash
+#!/usr/bin/env bash
 ##makedesc: Install mariadb (latest) and php-mysql + phpMyAdmin (if php is installed)
 
 echo

install/nerd-fonts

@@ -0,0 +1,66 @@
+#!/usr/bin/env bash
+##makedesc: Install nerd-fonts
+
+set -eo pipefail
+
+#TODO nokia-sans
+
+downloadPath="$HOME/install/nerd-fonts"
+installPath="$HOME/.local/share/fonts/"
+url="https://github.com/ryanoasis/nerd-fonts/releases/latest/download"
+
+fonts=(
+    FiraCode
+    FiraMono
+    JetBrainsMono
+    Meslo
+    Noto
+    RobotoMono
+    Ubuntu
+    UbuntuMono
+    UbuntuSans
+)
+
+install() {
+    echo
+    echo "==============================================="
+    echo "Installing nerd-fonts"
+    echo "==============================================="
+    echo
+
+    [[ -d "$downloadPath" ]] || mkdir -p "$downloadPath"
+
+    for fontname in "${fonts[@]}"; do
+        fontdir="$installPath/Nerd-$fontname"
+        wget "$url/$fontname.tar.xz" -O "$downloadPath/$fontname.tar.xz"
+        [[ -d "$installPath/$fontname" ]] || mkdir -p "$fontdir"
+        tar -xJf "$downloadPath/$fontname.tar.xz" -C "$fontdir"
+    done
+
+    fc-cache -vf "$installPath"
+
+    echo
+    echo "Finish!"
+    echo
+}
+
+remove() {
+    echo
+    echo "==============================================="
+    echo "Removing nerd-fonts"
+    echo "==============================================="
+    echo
+
+    find "$installPath" -type d -name "Nerd-*" -exec rm -rf {} +
+    fc-cache -vf "$installPath"
+
+    echo
+    echo "Finish!"
+    echo
+}
+
+case "$1" in
+    r|remove|d|delete|p|purge) remove ;;
+    *) install ;;
+esac
+

install/nodejs

@@ -1,4 +1,4 @@
-#!/bin/bash
+#!/usr/bin/env bash
 ##makedesc: Install nodejs + npm via nvm
 
 echo

install/ntfy

@@ -1,4 +1,4 @@
-#!/bin/bash
+#!/usr/bin/env bash
 ##makedesc: Install ntfy (latest) + ppa
 
 echo

install/nvim

@@ -0,0 +1,80 @@
+#!/usr/bin/env bash
+##makedesc: Install nvim + lazyvim
+set -eo pipefail
+
+# https://www.lazyvim.org/installation
+# https://www.devas.life/effective-neovim-setup-for-web-development-towards-2024/
+
+# TODO https://github.com/rockerBOO/awesome-neovim
+# TODO https://docs.astronvim.com
+
+url="https://github.com/neovim/neovim/releases/latest/download/nvim-linux-x86_64.tar.gz"
+downloadPath="$HOME/install"
+downloadTarGz="$downloadPath/nvim.tar.gz"
+installPath="/opt/nvim"
+cfgPath="$HOME/.config/nvim"
+nvimDataPaths=(
+    "$cfgPath"
+    "$HOME"/.local/share/nvim
+    "$HOME"/.local/state/nvim
+    "$HOME"/.cache/nvim
+)
+
+backup() {
+    echo "Backup configuration files..."
+    t=$(date +'%s')
+    for path in "${nvimDataPaths[@]}"; do
+        [[ -d "$path" ]] && cp -v "$path" "$path-$t.bak"
+    done
+    echo "Done"
+}
+
+install() {
+    echo
+    echo "==============================================="
+    echo "Installing neovim"
+    echo "==============================================="
+    echo
+
+    backup
+    wget "$url" -O "$downloadTarGz"
+    tar -xzf "$downloadTarGz" -C "$downloadPath"
+
+    sudo rm -rf "$installPath"
+    sudo mv "$downloadPath/nvim-linux-x86_64" "$installPath"
+
+    git clone --depth=1 --single-branch https://github.com/LazyVim/starter "$cfgPath"
+    rm -rf "$cfgPath/.git"
+
+    sudo update-desktop-database
+    xdg-desktop-menu forceupdate
+
+    echo
+    echo "Finish!"
+    nvim -v
+    echo
+}
+
+remove() {
+    echo
+    echo "==============================================="
+    echo "Removing nerd-fonts"
+    echo "==============================================="
+    echo
+
+    find "$downloadPath" -type d -name "Nerd-*" -exec rm -rf {} +
+    fc-cache -vf "$downloadPath"
+
+    echo
+    echo "Finish!"
+    echo
+}
+
+case "$1" in
+    b|backup) backup ;;
+    r|remove|d|delete|p|purge) remove ;;
+    *) install ;;
+esac
+
+
+# export PATH="$PATH:/opt/nvim-linux-x86_64/bin"

install/obs-studio

@@ -1,4 +1,4 @@
-#!/bin/bash
+#!/usr/bin/env bash
 ##makedesc: Install obs-studio (latest snap)
 
 echo

install/omz-clean

@@ -1,4 +1,4 @@
-#!/bin/bash
+#!/usr/bin/env bash
 ##makedesc: Install omz (latest)
 
 echo

install/omz-fancy

@@ -1,6 +1,15 @@
-#!/bin/bash
+#!/usr/bin/env bash
 ##makedesc: Install omz fancy (powerline10k + MesloLGS font)
 
+# https://gist.github.com/anthonyaxenov/b8460935d06b9f0da72def03d0f26515
+
+# Based on:
+# https://github.com/Powerlevel9k/powerlevel9k/wiki/Install-Instructions
+# https://github.com/ohmyzsh/ohmyzsh
+# https://powerline.readthedocs.io/en/latest/installation/linux.html#fonts-installation
+# https://gist.github.com/dogrocker/1efb8fd9427779c827058f873b94df95
+# https://linuxhint.com/install_zsh_shell_ubuntu_1804/
+
 echo
 echo "==============================================="
 echo "Installing omz fancy: powerline10k + MesloLGS font..."

install/openvpn

@@ -1,6 +1,6 @@
-#!/bin/bash
+#!/usr/bin/env bash
 ##makedesc: Install openvpn v2.6.3 (src)
-source `dirname $0`/../helpers || exit 255
+source "$( dirname $(readlink -e -- "${BASH_SOURCE}"))/../helpers.sh" || exit 255
 
 # https://openvpn.net/community-downloads/
 # https://openvpn.net/community-resources/installing-openvpn/
@@ -15,7 +15,7 @@ require libssl-dev \
 
 mkdir -p "$HOME/install/"
 download "https://swupdate.openvpn.org/community/releases/openvpn-${OVPNVER}.tar.gz" "$HOME/install/openvpn-${OVPNVER}.tar.gz" && \
-    unpak_targz "$HOME/install/openvpn-${OVPNVER}.tar.gz" "$HOME/install/" && \
+    unpack_targz "$HOME/install/openvpn-${OVPNVER}.tar.gz" "$HOME/install/" && \
     cd "$HOME/install/openvpn-${OVPNVER}" && \
     sudo ./configure && \
     sudo make && \

install/papirus

@@ -1,6 +1,6 @@
-#!/bin/bash
+#!/usr/bin/env bash
 ##makedesc: Install papirus-icon-theme (latest)
-source `dirname $0`/../helpers || exit 255
+source "$( dirname $(readlink -e -- "${BASH_SOURCE}"))/../helpers.sh" || exit 255
 
 title
 

install/pgsql

@@ -1,6 +1,6 @@
-#!/bin/bash
+#!/usr/bin/env bash
 ##makedesc: Install postgresql (latest) and php-pgsql (if php is installed)
-source `dirname $0`/../helpers || exit 255
+source "$( dirname $(readlink -e -- "${BASH_SOURCE}"))/../helpers.sh" || exit 255
 
 title
 

install/php

@@ -1,16 +1,16 @@
-#!/bin/bash
+#!/usr/bin/env bash
-##makedesc: Install php v8.1 + ppa
+##makedesc: Install php v8.4
 
-[ $1 ] && PHPVER="$1" || PHPVER="8.1"
+[ "$1" ] && PHPVER="$1" || PHPVER="8.4"
 echo
 echo "==============================================="
 echo "Installing php${PHPVER}..."
 echo "==============================================="
 echo
 
-sudo LC_ALL=C.UTF-8 add-apt-repository -y ppa:ondrej/php
 sudo apt install -y --autoremove \
-    php${PHPVER} \
+    php${PHPVER}-fpm \
+    php${PHPVER}-dev \
     php${PHPVER}-apcu \
     php${PHPVER}-bcmath \
     php${PHPVER}-cli \
@@ -24,6 +24,7 @@ sudo apt install -y --autoremove \
     php${PHPVER}-mysql \
     php${PHPVER}-opcache \
     php${PHPVER}-pgsql \
+    php${PHPVER}-simplexml \
     php${PHPVER}-soap \
     php${PHPVER}-sqlite3 \
     php${PHPVER}-xdebug \

install/php-psalm

@@ -1,4 +1,4 @@
-#!/bin/bash
+#!/usr/bin/env bash
 ##makedesc: Install psalm
 
 echo

install/php-spx

@@ -1,4 +1,4 @@
-#!/bin/bash
+#!/usr/bin/env bash
 ##makedesc: Install php-spx
 
 echo

install/phpcs

@@ -1,4 +1,4 @@
-#!/bin/bash
+#!/usr/bin/env bash
 ##makedesc: Install phpcs + php-cs-fixer
 
 echo

install/phpmd

@@ -1,4 +1,4 @@
-#!/bin/bash
+#!/usr/bin/env bash
 ##makedesc: Install phpmd
 
 echo

install/phpstan

@@ -1,4 +1,4 @@
-#!/bin/bash
+#!/usr/bin/env bash
 ##makedesc: Install phpstan
 
 echo

install/phpunit

@@ -1,4 +1,4 @@
-#!/bin/bash
+#!/usr/bin/env bash
 ##makedesc: Install phpunit
 
 echo

install/postman

@@ -1,6 +1,6 @@
-#!/bin/bash
+#!/usr/bin/env bash
 ##makedesc: Install postman (latest)
-source `dirname $0`/../helpers || exit 255
+source "$( dirname $(readlink -e -- "${BASH_SOURCE}"))/../helpers.sh" || exit 255
 
 # https://learning.postman.com/docs/getting-started/installation-and-updates/#installing-postman-on-linux
 
@@ -13,7 +13,7 @@ mkdir -p "$HOME/install" && \
     "$HOME/.local/share/applications"
 
 download "https://dl.pstmn.io/download/latest/linux64" "$HOME/install/postman.tar.gz" && \
-    unpak_targz "$HOME/install/postman.tar.gz" "$HOME/install" && \
+    unpack_targz "$HOME/install/postman.tar.gz" "$HOME/install" && \
     symlink "$HOME/install/Postman/Postman" "$HOME/.local/bin/postman" && \
     cat << EOF > "$HOME/.local/share/applications/Postman.desktop" && sudo update-desktop-database
 [Desktop Entry]

install/qt5

@@ -1,4 +1,4 @@
-#!/bin/bash
+#!/usr/bin/env bash
 ##makedesc: Install qt5
 
 echo

install/rustdesk

@@ -1,7 +1,7 @@
-#!/bin/bash
+#!/usr/bin/env bash
-##makedesc: Install rustdesk client v1.1.9 (deb)
+##makedesc: Install rustdesk client v1.4.2 (deb)
 
-[ $1 ] && RDVER="$1" || RDVER="1.1.9"
+[ "$1" ] && RDVER="$1" || RDVER="1.4.2"
 echo
 echo "==============================================="
 echo "Installing rustdesk v$RDVER..."
@@ -12,9 +12,13 @@ echo
 
 deb_path="$HOME/install"
 deb_name="rustdesk-$RDVER.deb"
-mkdir -p $deb_path
+mkdir -p "$deb_path"
 deb="$deb_path/$deb_name"
 
-sudo apt install -y libxdo3 python3-pip && \
+sudo apt install -y libxdo3 python3-pip
-    wget "https://github.com/rustdesk/rustdesk/releases/download/$RDVER/$deb_name" -O $deb && \
+wget "https://github.com/rustdesk/rustdesk/releases/download/$RDVER/$deb_name" -O "$deb"
-    sudo dpkg -i $deb
+sudo dpkg -i "$deb"
+
+# flatpak install -y com.rustdesk.RustDesk
+# https://develop.kde.org/docs/administration/portal-permissions/
+# flatpak permission-set kde-authorized remote-desktop com.rustdesk.RustDesk yes

install/snap

@@ -1,4 +1,4 @@
-#!/bin/bash
+#!/usr/bin/env bash
 ##makedesc: Install bunch of software from snap
 
 echo

install/sublimemerge

@@ -0,0 +1,45 @@
+#!/usr/bin/env bash
+##makedesc: Install Sublime Merge
+source "$( dirname $(readlink -e -- "${BASH_SOURCE}"))/../helpers.sh" || exit 255
+
+# https://www.sublimemerge.com/download
+# https://gist.github.com/lugrus2000/1fc55158b87f94d799392a6dd1ac0ce2
+# https://gist.github.com/maboloshi/feaa63c35f4c2baab24c9aaf9b3f4e47
+
+[ "$1" ] && SMVER="$1" || SMVER='2102'
+
+title
+
+mkdir -p "$HOME/install"
+DEB_PATH="$HOME/install/sublime-merge_build-${SMVER}_amd64.deb"
+BIN_PATH="/opt/sublime_merge/sublime_merge"
+
+if [[ ! -f "$DEB_PATH" ]]; then
+    download https://download.sublimetext.com/sublime-merge_build-${SMVER}_amd64.deb "$DEB_PATH"
+fi
+
+sudo dpkg -i "$DEB_PATH"
+# sudo cp -f $BIN_PATH $BIN_PATH.old
+
+# if [[ $SMVER = 2102 ]]; then
+    #TODO not working
+    # printf '\x48\xC7\xC0\x19\x01\x00\x00\xC3' | sudo dd of=$BIN_PATH bs=1 seek=$((0x003A5400)) conv=notrunc
+    # printf '\x90\x90\x90\x90\x90'             | sudo dd of=$BIN_PATH bs=1 seek=$((0x003A7EC9)) conv=notrunc
+    # printf '\x90\x90\x90\x90\x90'             | sudo dd of=$BIN_PATH bs=1 seek=$((0x003A7EE4)) conv=notrunc
+    # printf '\x48\x31\xC0\x48\xFF\xC0\xC3'     | sudo dd of=$BIN_PATH bs=1 seek=$((0x003A67FE)) conv=notrunc
+    # printf '\xC3'                             | sudo dd of=$BIN_PATH bs=1 seek=$((0x003A514E)) conv=notrunc
+    # printf '\xC3'                             | sudo dd of=$BIN_PATH bs=1 seek=$((0x003A40D2)) conv=notrunc
+
+    #TODO segfault
+    # echo 0045a360: 48 C7 C0 19 01 00 00 C3 | sudo xxd -r - $BIN_PATH
+    # echo 0045d21d: 90 90 90 90 90          | sudo xxd -r - $BIN_PATH
+    # echo 0045d23a: 90 90 90 90 90          | sudo xxd -r - $BIN_PATH
+    # echo 0045b990: C3                      | sudo xxd -r - $BIN_PATH
+    # echo 0045a05a: C3                      | sudo xxd -r - $BIN_PATH
+    # echo 00459aba: C3                      | sudo xxd -r - $BIN_PATH
+# fi
+
+echo
+success "Sublime Merge installed!"
+$BIN_PATH --version
+echo

install/sublimetext

@@ -1,22 +1,37 @@
-#!/bin/bash
+#!/usr/bin/env bash
-##makedesc: Install Sublime Text (build 4169)
+##makedesc: Install Sublime Text
-source `dirname $0`/../helpers || exit 255
+source "$( dirname $(readlink -e -- "${BASH_SOURCE}"))/../helpers.sh" || exit 255
 
-# https://www.sublimetext.com/download_thanks?target=x64-deb
+# https://www.sublimetext.com/download
-# https://gist.github.com/skoqaq/3f3e8f28e23c881143cef9cf49d821ff
+# https://gist.axenov.dev/anthony/sublime
+# https://gist.axenov.dev/anthony/sublime2
+# https://gist.github.com/lugrus2000/1fc55158b87f94d799392a6dd1ac0ce2
+# https://gist.github.com/maboloshi/feaa63c35f4c2baab24c9aaf9b3f4e47
+
+[ "$1" ] && STVER="$1" || STVER='4200'
 
 title
 
 mkdir -p "$HOME/install"
+DEB_PATH="$HOME/install/sublime-text_build-${STVER}_amd64.deb"
+BIN_PATH="/opt/sublime_text/sublime_text"
 
-download https://download.sublimetext.com/sublime-text_build-4169_amd64.deb \
+if [[ ! -f "$DEB_PATH" ]]; then
-    "$HOME/install/sublime-text_build-4169_amd64.deb" && \
+    download "https://download.sublimetext.com/sublime-text_build-${STVER}_amd64.deb" "$DEB_PATH"
-    sudo dpkg -i "$HOME/install/sublime-text_build-4169_amd64.deb" && \
+fi
-    echo "00489f39: c640 0501 4885 c9" | sudo xxd -r - /opt/sublime_text/sublime_text
 
-[ $? = 0 ] && {
+sudo dpkg -i "$DEB_PATH"
-    echo
+sudo cp -f "$BIN_PATH" "$BIN_PATH.old"
-    success "Sublime Text installed!"
+
-    subl --version
+if [[ $STVER = 4169 ]]; then
-    echo
+    echo "00489f39: c640 0501 4885 c9" | sudo xxd -r - "$BIN_PATH"
-}
+elif [[ $STVER = 4200 ]]; then
+    sudo sed -i 's#\x0F\xB6\x51\x05\x83\xF2\x01#\xC6\x41\x05\x01\xB2\x00\x90#' "$BIN_PATH"
+else
+    sudo sed -i 's#\x80\x79\x05\x00\x0F\x94\xC2#\xC6\x41\x05\x01\xB2\x00\x90#' "$BIN_PATH"
+fi
+
+echo
+success "Sublime Text installed!"
+$BIN_PATH --version
+echo

install/suld

@@ -0,0 +1,20 @@
+#!/usr/bin/env bash
+##makedesc: Samsung Unified Linux Driver repo
+source "$( dirname $(readlink -e -- "${BASH_SOURCE}"))/../helpers.sh" || exit 255
+
+# https://www.bchemnet.com/suldr/
+# https://www.bchemnet.com/suldr/supported.html
+
+title
+
+mkdir -vp "$HOME/install"
+sudo bash -c 'echo "deb https://www.bchemnet.com/suldr/ debian extra" >> /etc/apt/sources.list.d/samsung.list'
+download \
+    https://www.bchemnet.com/suldr/pool/debian/extra/su/suldr-keyring_3_all.deb \
+    "$HOME/install/suldr-keyring_3_all.deb"
+sudo dpkg -i "$HOME/install/suldr-keyring_3_all.deb"
+apt_install suld-driver2-1.00.39
+
+success "Samsung Unified Linux Driver installed!"
+info "Don't forget to connect your Samsung printer"
+info "See more info here: https://www.bchemnet.com/suldr/"

install/syncthing

@@ -1,4 +1,4 @@
-#!/bin/bash
+#!/usr/bin/env bash
 ##makedesc: Install syncthing (latest) + ppa
 
 echo

install/telebit

@@ -1,4 +1,4 @@
-#!/bin/bash
+#!/usr/bin/env bash
 ##makedesc: Install telebit (latest)
 
 echo

install/telegram

@@ -1,4 +1,4 @@
-#!/bin/bash
+#!/usr/bin/env bash
 ##makedesc: Install telegram (latest)
 
 echo

install/ulauncher

@@ -1,4 +1,4 @@
-#!/bin/bash
+#!/usr/bin/env bash
 ##makedesc: Install ulauncher (latest) + ppa
 
 echo
@@ -7,5 +7,7 @@ echo "Installing ulauncher (latest) + ppa..."
 echo "==============================================="
 echo
 
-sudo add-apt-repository -y ppa:agornostal/ulauncher
+sudo add-apt-repository universe -y
-sudo apt install -y --autoremove ulauncher
+sudo add-apt-repository ppa:agornostal/ulauncher -y
+sudo apt update
+sudo apt install ulauncher

install/vivaldi

@@ -1,4 +1,4 @@
-#!/bin/bash
+#!/usr/bin/env bash
 ##makedesc: Install Vivaldi + ppa
 
 # https://repo.vivaldi.com
@@ -11,11 +11,9 @@ echo "Installing Vivaldi + ppa..."
 echo "==============================================="
 echo
 
-wget -qO- https://repo.vivaldi.com/archive/linux_signing_key.pub \
+wget -qO- https://repo.vivaldi.com/archive/linux_signing_key.pub | gpg --dearmor > packages.vivaldi.gpg
-| gpg --dearmor \
+sudo install -o root -g root -m 644 packages.vivaldi.gpg /etc/apt/trusted.gpg.d
-| sudo dd of=/usr/share/keyrings/vivaldi-browser.gpg
+sudo sh -c 'echo "deb [arch=amd64,armhf signed-by=/etc/apt/trusted.gpg.d/packages.vivaldi.gpg] https://repo.vivaldi.com/archive/deb stable main" > /etc/apt/sources.list.d/vivaldi.list'
-
+rm -f packages.vivaldi.gpg
-echo "deb [signed-by=/usr/share/keyrings/vivaldi-browser.gpg arch=$(dpkg --print-architecture)] https://repo.vivaldi.com/archive/deb/ stable main" \
-| sudo dd of=/etc/apt/sources.list.d/vivaldi-archive.list
 
 sudo apt update && sudo apt install vivaldi-stable

install/vscode

@@ -1,18 +1,18 @@
-#!/bin/bash
+#!/usr/bin/env bash
 ##makedesc: VSCode deb-package
-source `dirname $0`/../helpers || exit 255
+source "$( dirname $(readlink -e -- "${BASH_SOURCE}"))/../helpers.sh" || exit 255
 
 title
 
 mkdir -p "$HOME/install"
 
-download "https://code.visualstudio.com/docs/?dv=linux64_deb" \
+download "https://code.visualstudio.com/sha/download?build=stable&os=linux-deb-x64" \
     "$HOME/install/vscode.deb" && \
     sudo dpkg -i "$HOME/install/vscode.deb"
 
 [ $? = 0 ] && {
     echo
     success "VSCode installed"
-    vscode --version
+    code --version
     echo
 }

install/wine

@@ -1,5 +1,5 @@
-#!/bin/bash
+#!/usr/bin/env bash
-##makedesc: Install wine (latest) + ppa (focal)
+##makedesc: Install wine (latest) + ppa
 
 echo
 echo "==============================================="
@@ -9,6 +9,6 @@ echo
 
 sudo dpkg --add-architecture i386
 wget -qO- https://dl.winehq.org/wine-builds/winehq.key | sudo apt-key add -
-sudo add-apt-repository -y 'deb https://dl.winehq.org/wine-builds/ubuntu/ focal main'
+sudo add-apt-repository -y "deb https://dl.winehq.org/wine-builds/ubuntu/ $(lsb_release -cs 2>/dev/null) main"
 sudo apt install -y --autoremove winehq-stable
 wine --version

install/youtube-dl

@@ -1,4 +1,4 @@
-#!/bin/bash
+#!/usr/bin/env bash
 ##makedesc: Install youtube-dl (src)
 
 # https://github.com/ytdl-org/youtube-dl#installation
@@ -23,7 +23,12 @@ installed() {
 mkdir -p "$HOME/install/youtube-dl" "$HOME/.local/bin"
 
 if installed git; then
-    git clone https://github.com/ytdl-org/youtube-dl.git "$HOME/install/youtube-dl" --depth=1 --single-branch
+    if [[ -d "$HOME/install/youtube-dl" ]]; then
+        cd "$HOME/install/youtube-dl"
+        git pull
+    else 
+        git clone https://github.com/ytdl-org/youtube-dl.git "$HOME/install/youtube-dl" --depth=1 --single-branch
+    fi
 else
     ! installed wget && sudo apt install -y wget
     wget https://github.com/ytdl-org/youtube-dl/archive/refs/heads/master.zip -O "$HOME/install/youtube-dl.zip" && \

install/ytdlcue

@@ -1,4 +1,4 @@
-#!/bin/bash
+#!/usr/bin/env bash
 ##makedesc: Install ytdlcue
 
 # https://gist.github.com/anthonyaxenov/8e11f18493c8419ee7abc94a8ea0cfaf

install/zint

@@ -1,4 +1,4 @@
-#!/bin/bash
+#!/usr/bin/env bash
 ##makedesc: Install zint (latest)
 
 echo

install/zsh

@@ -1,4 +1,4 @@
-#!/bin/bash
+#!/usr/bin/env bash
 ##makedesc: Install vanilla zsh
 
 echo

packs/flameshot

@@ -1,2 +0,0 @@
-##flameshot: [TODO] [PACK] qt5 + flameshot from source
-flameshot: qt5 flameshot-build

packs/phpstack

@@ -1,2 +1,2 @@
-##phptools: [PACK] Install only php tooling (composer, phpunit, psalm, phpcs, php-cs-fixer, php-spx, phpmd)
+##phptools: [PACK] Install only php tooling (composer, phpunit, psalm, phpcs, php-cs-fixer, phpmd)
-phptools: composer php-psalm php-spx phpcs phpmd phpstan phpunit
+phptools: composer php-psalm phpcs phpmd phpstan phpunit

scripts/README.md

@@ -0,0 +1,6 @@
+# Shell-скрипты
+
+Эти скрипты я писал в разное время для решения разных задач.
+Чтобы они не растерялись по репозиториям и носителям, я решил собрать их здесь в одну кучу.
+
+Я всегда использую Ubuntu в качестве своих настольных и серверных ОС, поэтому все эти скрипты писались и использовались в этих средах с версий 18.*.

scripts/disable-ipv6.sh

@@ -0,0 +1,5 @@
+#!/usr/bin/env bash
+
+sudo sysctl -w net.ipv6.conf.all.disable_ipv6="$1"
+sudo sysctl -w net.ipv6.conf.default.disable_ipv6="$1"
+sudo sysctl -w net.ipv6.conf.lo.disable_ipv6="$1"

scripts/display-resolution.sh

@@ -1,54 +1,55 @@
-#!/bin/bash
+#!/usr/bin/env bash
+# https://gist.github.com/anthonyaxenov/c16e1181d4b8a8644c57ec8a1f6cf21c
 #########################################################################
 #                                                                       #
-# Set display resolution                                                #
+# Set output resolution                                                 #
 #                                                                       #
 # Author: Anthony Axenov (Антон Аксенов)                                #
 # Version: 1.0                                                          #
-# License: WTFPL                                                        #
+# License: WTFPLv2                                                      #
 #                                                                       #
 #########################################################################
 #                                                                       #
-# Using this script you can change your display resolution              #
+# Using this script you can change your output resolution               #
 # to any one you need. Just adjust some vars below and run script       #
 # (chmod +x needed).                                                    #
 #                                                                       #
 #########################################################################
 
-# https://gist.github.com/anthonyaxenov/c16e1181d4b8a8644c57ec8a1f6cf21c
+# Set output name to work with. You can get it via 'xrandr --listactivemonitors'
-
+output="HDMI-3"
-# Set display name to work with. You can get it via 'xrandr --listactivemonitors'
+# Set width of this output in px
-display="HDMI-2"
+width=1920
-# Set width of this display in px
+# Set height of this output in px
-width=1600
+height=1080
-# Set height of this display in px
+# Set refresh rate in Hz of this output in px
-height=900
+refresh=120
 
 # Sometimes cvt and gtf generates different modelines.
 # You can play around and look which of them gives best result:
-modeline=$(cvt ${width} ${height} | grep "Modeline")
+modeline=$(cvt ${width} ${height} ${refresh} | grep "Modeline")
-# modeline=$(gtf ${width} ${height} 60 | grep "Modeline")
+# modeline=$(gtf ${width} ${height} ${refresh} | grep "Modeline")
 
 # Some important data needed to xrandr:
-modename="${width}x${height}_my"
+modename="${width}x${height}@${refresh}_my"
 params=$(echo "$modeline" | sed "s|^\s*Modeline\s*\"[0-9x_.]*\"\s*||")
 
-echo "Set resolution ${width}x${height} on display $display:"
+echo "Set resolution ${width}x${height}@${refresh} on output $output:"
 echo "$modename $params"
 
 # Simple logic:
-# 1. Switch display to safe mode which always exists (I believe) to avoid errors
+# 1. Switch output to safe mode which always exists (I believe) to avoid errors
-xrandr --output $display --mode 640x480
+xrandr --output $output --mode 640x480 --verbose
-# 2. If display aready have our mode -- we must delete it to avoid errors
+# 2. If output aready have our mode -- we must delete it to avoid errors
 if $(xrandr | grep -q "$modename"); then
-    # 2.1. Detach mode from display
+    # 2.1. Detach mode from output
-    xrandr --delmode $display $modename
+    xrandr --delmode $output $modename
     # 2.2. Remove mode itself
     xrandr --rmmode $modename
 fi
 # 3. Create new mode with freshly generated parameters
-xrandr --newmode $modename $params
+xrandr --newmode $modename $params --verbose
-# 4. Attach mode to our display
+# 4. Attach mode to our output
-xrandr --addmode $display $modename
+xrandr --addmode $output $modename --verbose
-# 5. Switch display to this mode immidiately
+# 5. Switch output to this mode immidiately
-xrandr --output $display --mode $modename
+xrandr --output $output --mode $modename --refresh $refresh --verbose

scripts/display-rotate.sh

@@ -0,0 +1,11 @@
+#!/usr/bin/env bash
+
+# X11:
+# xrandr --listactivemonitors
+# xrandr --output $OUTPUT --rotate (left|right|normal|...)
+
+# Wayland KDE: https://www.reddit.com/r/kde/comments/11vrbwc/how_do_i_rotate_the_screen_on_kde_with_wayland/
+# kscreen-doctor --outputs
+OUTPUT='HDMI-A-1'
+[ "$1" ] && DIRECTION="$1" || DIRECTION="normal" # (left|right|normal|inverted)
+kscreen-doctor "output.$OUTPUT.rotation.$DIRECTION"

scripts/docker-volume-snapshot.sh

@@ -0,0 +1,47 @@
+#!/usr/bin/env bash
+# Original filename: docker-volume-snapshot
+# Author: Juned Khatri
+# License: MIT
+# Repo: https://github.com/junedkhatri31/docker-volume-snapshot
+
+set -e -o pipefail
+
+programname=`basename "$0"`
+
+display_usage() {
+    echo "usage: $programname (create|restore) source destination"
+    echo "  create         create snapshot file from docker volume"
+    echo "  restore        restore snapshot file to docker volume"
+    echo "  source         source path"
+    echo "  destination    destination path"
+    echo
+    echo "Tip: Supports tar's compression algorithms automatically"
+    echo "     based on the file extention, for example .tar.gz"
+    echo
+    echo "Examples:"
+    echo "docker-volume-snapshot create xyz_volume xyz_volume.tar"
+    echo "docker-volume-snapshot create xyz_volume xyz_volume.tar.gz"
+    echo "docker-volume-snapshot restore xyz_volume.tar xyz_volume"
+    echo "docker-volume-snapshot restore xyz_volume.tar.gz xyz_volume"
+}
+
+case "$1" in
+    "create")
+        if [[ -z "$2" || -z "$3" ]]; then display_usage; exit 1; fi
+        directory=`dirname "$3"`
+        if [ "$directory" == "." ]; then directory=$(pwd); fi
+        filename=`basename "$3"`
+        docker run --rm -v "$2:/source" -v "$directory:/dest" busybox tar cvaf "/dest/$filename" -C /source .
+        ;;
+    "restore")
+        if [[ -z "$2" || -z "$3" ]]; then display_usage; exit 1; fi
+        directory=`dirname "$2"`
+        if [ "$directory" == "." ]; then directory=$(pwd); fi
+        filename=`basename "$2"`
+        docker run --rm -v "$3:/dest" -v "$directory:/source" busybox tar xvf "/source/$filename" -C /dest
+        ;;
+    *)
+        display_usage
+        exit 1 # Command to come out of the program with status 1
+        ;;
+esac

scripts/duckdns/.env.example

@@ -0,0 +1,3 @@
+DUCK_TOKEN=
+DUCK_DOMAINS=
+DUCK_IP=

scripts/duckdns/.gitignore

@@ -0,0 +1,2 @@
+.env
+*.log

scripts/duckdns/install.sh

@@ -0,0 +1,9 @@
+#!/bin/bash
+thisdir="$( dirname "$(readlink -e -- "${BASH_SOURCE[0]}")")"
+
+# https://www.duckdns.org/install.jsp
+
+croncmd="$thisdir/update.sh"
+cronjob="*/30 * * * * $croncmd" # every 30 min
+( crontab -l | grep -v -F "$croncmd" ; echo "$cronjob" ) | crontab -
+cp -f "$thisdir/.env.example" "$thisdir/.env"

scripts/duckdns/uninstall.sh

@@ -0,0 +1,3 @@
+#!/bin/bash
+
+( crontab -l | grep -v -F "duckdns" ) | crontab -

scripts/duckdns/update.sh

@@ -0,0 +1,30 @@
+#!/bin/bash
+# shellcheck disable=SC1091
+thisdir="$( dirname "$(readlink -e -- "${BASH_SOURCE[0]}")")"
+
+log() {
+    timestamp="$(date +'%Y-%m-%d %H:%M:%S')"
+    datestamp="$(date +'%Y-%m-%d')"
+    [ ! -d "$thisdir/log" ] && mkdir "$thisdir/log"
+    echo "[$timestamp] $*" >> "$thisdir/log/$datestamp.log"
+}
+
+[ ! -f "$thisdir/.env" ] && {
+    log "ERROR: .env not exists"
+    exit 1
+}
+
+source "$thisdir/.env"
+
+[ -z "$DUCK_TOKEN" ] && {
+    log "ERROR: env var DUCK_TOKEN not specified"
+    exit 1
+}
+
+[ -z "$DUCK_DOMAINS" ] && {
+    log "ERROR: env var DUCK_DOMAINS not specified"
+    exit 1
+}
+
+result=$(curl -s "https://www.duckdns.org/update?domains=${DUCK_DOMAINS}&token=${DUCK_TOKEN}&ip=${DUCK_IP}")
+log "$result"

scripts/fix-obs-vcam.sh

@@ -1,4 +1,4 @@
-#!/bin/bash
+#!/usr/bin/env bash
 
 # https://obsproject.com/kb/virtual-camera-troubleshooting
 # https://obsproject.com/forum/threads/how-to-start-virtual-camera-without-sudo-privileges.139783/

scripts/fix-repo-vivaldi.sh

@@ -0,0 +1,11 @@
+#!/usr/bin/env bash
+
+# https://gist.github.com/pkorpine/16fcdbe070222cf1d99e67cf542e60c2
+
+sudo rm -rf /etc/apt/sources.list.d/vivaldi*
+cd /tmp
+wget -qO- https://repo.vivaldi.com/archive/linux_signing_key.pub | gpg --dearmor > packages.vivaldi.gpg
+sudo install -o root -g root -m 644 packages.vivaldi.gpg /etc/apt/trusted.gpg.d
+sudo sh -c 'echo "deb [arch=amd64,armhf signed-by=/etc/apt/trusted.gpg.d/packages.vivaldi.gpg] https://repo.vivaldi.com/archive/deb stable main" > /etc/apt/sources.list.d/vivaldi.list'
+rm -f packages.vivaldi.gpg
+sudo apt update

scripts/fix-repo-vscode.sh

@@ -0,0 +1,12 @@
+#!/usr/bin/env bash
+
+# https://code.visualstudio.com/docs/setup/linux
+
+sudo rm -rf /etc/apt/sources.list.d/vscode*
+cd /tmp
+sudo apt install wget gpg apt-transport-https
+wget -qO- https://packages.microsoft.com/keys/microsoft.asc | gpg --dearmor > packages.microsoft.gpg
+sudo install -D -o root -g root -m 644 packages.microsoft.gpg /etc/apt/keyrings/packages.microsoft.gpg
+echo "deb [arch=amd64,arm64,armhf signed-by=/etc/apt/keyrings/packages.microsoft.gpg] https://packages.microsoft.com/repos/code stable main" |sudo tee /etc/apt/sources.list.d/vscode.list > /dev/null
+rm -f packages.microsoft.gpg
+sudo apt update

scripts/free-space.sh

@@ -1,48 +1,57 @@
-#!/bin/bash
+#!/usr/bin/env bash
 # Очистка места на диске
 # https://gist.github.com/anthonyaxenov/02c00c965be4eb5bb163a153abdf4c2b
 # https://itsfoss.com/free-up-space-ubuntu-linux/
 
-df -h
+echo
-echo ""
+echo
+df -hx tmpfs
+echo
+
+echo
 echo "[1/5] Removing apt caches and unused packages"
-echo ""
+echo
 
 sudo apt autoremove --purge
 sudo apt autoclean
 sudo apt clean
 
-echo ""
+echo
-echo "[2/5] Removing old journalctl logs"
+echo "[2/5] Removing old system logs"
-echo ""
+echo
 
 sudo journalctl --vacuum-time=1d
 sudo rm -rf /var/log/journal/user-*@*
 sudo rm -rf /var/log/journal/system*@*
+sudo rm /var/log/{syslog,dmesg,btmp}.*
+sudo rm /var/log/{auth,dpkg,kern,alternatives,dmesg}.log.*
 
-echo ""
+echo
 echo "[3/5] Cleaning user trash and thumbnails"
-echo ""
+echo
 
 rm -rf ~/.local/share/Trash/files/*
 rm -rf ~/.cache/thumbnails/*
 
-echo ""
+echo
 echo "[4/5] Cleaning out dangling docker objects"
-echo ""
+echo
 
 docker system prune -f
 # docker system prune -af
 
-echo ""
+echo
 echo "[5/5] Removing disabled unused snaps"
-echo ""
+echo
 
-sudo snap list --all | awk '/disabled/{print $1, $3}' |
+sudo snap list --all \
-    while read snapname revision; do
+    | awk '/disabled/{print $1, $3}' \
-        sudo snap remove "$snapname" --revision="$revision"
+    | while read snapname revision; do
-    done
+            sudo snap remove "$snapname" --revision="$revision"
+        done
 
-echo ""
+echo
-echo ""
+echo
-df -h
+df -hx tmpfs
+echo
+echo

scripts/helpers/arg-parser/README.md

@@ -0,0 +1,111 @@
+# Argument parser for bash scripts v1.6
+
+## Usage
+
+```shell
+# 1. add these lines after shebang:
+
+__RAW_ARGS__=("$@")
+source args.sh
+
+# 2. read arguments as flags:
+
+arg a 1 flag_a
+echo "Flag -a has value '$flag_a'"
+echo "Flag -a has value '$(arg a 1)'"
+
+arg b 1 flag_b
+echo "Flag -b has value '$flag_b'"
+echo "Flag -b has value '$(arg b 1)'"
+
+arg c 1 flag_c
+echo "Flag -c has value '$flag_c'"
+echo "Flag -c has value '$(arg c 1)'"
+
+arg d 1 flag_d
+echo "Flag -d has value '$flag_d'"
+echo "Flag -d has value '$(arg d 1)'"
+
+argl flag1 1 flag_1
+echo "Flag --flag1 has value '$flag_1'"
+echo "Flag --flag1 has value '$(argl flag1 1)'"
+
+argl flag2 1 flag_2
+echo "Flag --flag2 has value '$flag_2'"
+echo "Flag --flag2 has value '$(argl flag2 1)'"
+
+# 3. and/or read arguments' values:
+
+arg a 0 arg_a
+echo "Arg -a has value '$arg_a'"
+echo "Arg -a has value '$(arg a 0)'"
+
+arg b 0 arg_b
+echo "Arg -b has value '$arg_b'"
+echo "Arg -b has value '$(arg b 0)'"
+
+argl arg1 0 arg_1
+echo "Arg --arg1 has value '$arg_1'"
+echo "Arg --arg1 has value '$(argl arg1 0)'"
+
+argl arg2 0 arg_2
+echo "Arg --arg2 has value '$arg_2'"
+echo "Arg --arg2 has value '$(argl arg2 0)'"
+```
+
+## How it works
+
+1. Short arguments can be specified contiguously or separately
+   and their order does not matter, but before each of them
+   (or the first of them) one leading dash must be specified.
+
+   > Valid combinations: `-a -b -c`, `-cba`, `-b -azc "value of z"`
+
+2. Short arguments can have values and if are - value must go
+   next to argument itself.
+   
+   > Valid combinations: `-ab avalue`, `-ba avalue`, `-a avalue -b`
+   
+3. Long arguments cannot be combined like short ones and each
+   of them must be specified separately with two leading dashes.
+   
+   > Valid combinations: `--foo --bar`, `--bar --foo`
+   
+4. Long arguments can have a value which must be specified after `=`.
+   
+   > Valid combinations: `--foo value --bar`, `--bar --foo=value`
+   
+5. If arg value may contain space then value must be "double-quoted".
+
+6. You can use arg() or argl() to check presence of any arg, no matter
+   if it has value or not.
+
+More info:
+* 🇷🇺 [axenov.dev/bash-args](https://axenov.dev/bash-args/)
+* 🇺🇸 [axenov.dev/en/bash-processing-arguments-in-a-script-when-called-from-the-shell/](https://axenov.dev/en/bash-processing-arguments-in-a-script-when-called-from-the-shell)
+
+Tested in Ubuntu 20.04.2 LTS in:
+
+```
+bash 5.0.17(1)-release (x86_64-pc-linux-gnu) and later
+zsh 5.8 (x86_64-ubuntu-linux-gnu) and later
+```
+
+## Version history
+
+```
+v1.0 - initial
+v1.1 - arg(): improved skipping uninteresting args
+     - arg(): check next arg to be valid value
+v1.2 - removed all 'return' statements
+     - arg(): error message corrected
+     - new examples
+v1.3 - argl(): improved flag check
+     - some text corrections
+v1.4 - new function argn()
+     - some text corrections
+v1.5 - arg(), grep_match(): fixed searching for -e argument
+     - grep_match(): redirect output into /dev/null
+v1.6 - removed useless argn()
+     - arg() and argl() refactored and now support values with whitespaces
+```

scripts/helpers/arg-parser/args.sh

@@ -0,0 +1,158 @@
+#!/usr/bin/env bash
+
+# Argument parser for bash scripts
+#
+# Author: Anthony Axenov (Антон Аксенов)
+# Version: 1.6
+# License: MIT
+# Description: https://git.axenov.dev/anthony/shell/src/branch/master/helpers/arg-parser
+
+#purpose    Little helper to check if string matches PCRE
+#argument   $1 - some string
+#argument   $2 - regex
+#exitcode	0 - string valid
+#exitcode	1 - string is not valid
+grep_match() {
+    printf "%s" "$1" | grep -qE "$2" >/dev/null
+}
+
+#purpose	Find short argument or its value
+#argument	$1 - (string) argument (without leading dashes; only first letter will be processed)
+#argument	$2 - (number) is it flag? 1 if is, otherwise 0 or nothing
+#argument	$3 - (string) variable to return value into
+#                (if not specified then it will be echo'ed in stdout)
+#returns    (string) 1 (if $2 == 1), value (if correct and if $2 != 1) or nothing
+#usage      To get value into var:      arg v 0 myvar    or    myvalue=$(arg 'v')
+#usage      To find flag into var:      arg f 1 myvar    or    flag=$(arg 'f')
+#usage      To echo value:              arg v
+#usage      To echo 1 if flag exists:   arg f
+arg() {
+    [ "$1" ] || { echo "Argument name is not specified!" >&2 && exit 1; }
+    local arg_name="${1:0:1}" # first character of argument name to find
+    local is_flag="$2" || 0   # 1 if we need just find a flag, 0 to get a value
+    local var_name="$3" || 0  # variable name to return value into or 0 to echo it in stdout
+    local value=              # initialize empty value to check if we found one later
+    local arg_found=0         # marker of found argument
+
+    for idx in "${!__RAW_ARGS__[@]}"; do # going through all args
+        local arg_search=${__RAW_ARGS__[idx]} # get current argument
+
+        # skip $arg_search if it starts with '--' or letter
+        grep_match "$arg_search" "^(\w|--)" && continue
+
+        # clear $arg_search from special and duplicate characters, e.g. 'fas-)dfs' will become 'fasd'
+        local arg_chars="$(printf "%s" "$arg_search" \
+            | tr -s "[$arg_search]" 2>/dev/null \
+            | tr -d "[:punct:][:blank:]" 2>/dev/null)"
+
+        # if $arg_name is not one of $arg_chars the skip it
+        grep_match "-$arg_name" "^-[$arg_chars]$" || continue
+        arg_found=1
+
+        # then return '1'|'0' back into $value if we need flag or next arg value otherwise
+        [ "$is_flag" = 1 ] && value=1 || value="${__RAW_ARGS__[idx+1]}"
+        break
+    done
+
+    [ "$is_flag" = 1 ] && [ -z "$value" ] && value=0;
+
+    # if value we found is empty or looks like another argument then exit with error message
+    if [ "$arg_found" = 1 ] && ! grep_match "$value" "^[[:graph:]]+$" || grep_match "$value" "^--?\w+$"; then
+        echo "ERROR: Argument '-$arg_name' must have correct value!" >&2 && exit 1
+    fi
+
+    # return '$value' back into $var_name (if exists) or echo in stdout
+    [ "$var_name" ] && eval "$var_name='$value'" || echo "$value"
+}
+
+#purpose	Find long argument or its value
+#argument	$1 - argument (without leading dashes)
+#argument	$2 - (number) is it flag? 1 if is, otherwise 0 or nothing
+#argument	$3 - (string) variable to return value into
+#                (if not specified then it will be echo'ed in stdout)
+#returns    (string) 1 (if $2 == 1), value (if correct and if $2 != 1) or nothing
+#usage      To get value into var:      arg v 0 myvar    or    myvalue=$(arg 'v')
+#usage      To find flag into var:      arg f 1 myvar    or    flag=$(arg 'f')
+#usage      To echo value:              arg v
+#usage      To echo 1 if flag exists:   arg f
+argl() {
+    [ "$1" ] || { echo "Argument name is not specified!" >&2 && exit 1; }
+    local arg_name="$1"      # argument name to find
+    local is_flag="$2" || 0  # 1 if we need just find a flag, 0 to get a value
+    local var_name="$3" || 0 # variable name to return value into or 0 to echo it in stdout
+    local value=             # initialize empty value to check if we found one later
+    local arg_found=0        # marker of found argument
+
+    for idx in "${!__RAW_ARGS__[@]}"; do # going through all args
+        local arg_search="${__RAW_ARGS__[idx]}" # get current argument
+
+        if [ "$arg_search" = "--$arg_name" ]; then # if current arg begins with two dashes
+            # then return '1' back into $value if we need flag or next arg value otherwise
+            [ "$is_flag" = 1 ] && value=1 || value="${__RAW_ARGS__[idx+1]}"
+            break # stop the loop
+        elif grep_match "$arg_search" "^--$arg_name=.+$"; then # check if $arg like '--foo=bar'
+            # then return '1' back into $value if we need flag or part from '=' to arg's end as value otherwise
+            [ "$is_flag" = 1 ] && value=1 || value="${arg_search#*=}"
+            break # stop the loop
+        fi
+    done
+
+    [ "$is_flag" = 1 ] && [ -z "$value" ] && value=0;
+
+    # if value we found is empty or looks like another argument then exit with error message
+    if [ "$arg_found" = 1 ] && ! grep_match "$value" "^[[:graph:]]+$" || grep_match "$value" "^--?\w+$"; then
+        echo "ERROR: Argument '--$arg_name' must have correct value!" >&2 && exit 1;
+    fi
+
+    # return '$value' back into $var_name (if exists) or echo in stdout
+    [ "$var_name" ] && eval "$var_name='$value'" || echo "$value"
+}
+
+################################
+
+# This is simple examples which you can play around with.
+# 1. uncomment code below
+# 2. call thi sscript to see what happens:
+#     /args.sh -abcd --flag1 --flag2 -e evalue -f fvalue --arg1=value1 --arg2 value2
+
+# __RAW_ARGS__=("$@")
+
+# arg a 1 flag_a
+# echo "Flag -a has value '$flag_a'"
+# echo "Flag -a has value '$(arg a 1)'"
+
+# arg b 1 flag_b
+# echo "Flag -b has value '$flag_b'"
+# echo "Flag -b has value '$(arg b 1)'"
+
+# arg c 1 flag_c
+# echo "Flag -c has value '$flag_c'"
+# echo "Flag -c has value '$(arg c 1)'"
+
+# arg d 1 flag_d
+# echo "Flag -d has value '$flag_d'"
+# echo "Flag -d has value '$(arg d 1)'"
+
+# argl flag1 1 flag_1
+# echo "Flag --flag1 has value '$flag_1'"
+# echo "Flag --flag1 has value '$(argl flag1 1)'"
+
+# argl flag2 1 flag_2
+# echo "Flag --flag2 has value '$flag_2'"
+# echo "Flag --flag2 has value '$(argl flag2 1)'"
+
+# arg e 0 arg_e
+# echo "Arg -e has value '$arg_e'"
+# echo "Arg -e has value '$(arg e 0)'"
+
+# arg f 0 arg_f
+# echo "Arg -f has value '$arg_f'"
+# echo "Arg -f has value '$(arg f 0)'"
+
+# argl arg1 0 arg_1
+# echo "Arg --arg1 has value '$arg_1'"
+# echo "Arg --arg1 has value '$(argl arg1 0)'"
+
+# argl arg2 0 arg_2
+# echo "Arg --arg2 has value '$arg_2'"
+# echo "Arg --arg2 has value '$(argl arg2 0)'"

scripts/helpers/basic.sh

@@ -0,0 +1,127 @@
+#!/usr/bin/env bash
+source $( dirname $(readlink -e -- "${BASH_SOURCE}"))/io.sh || exit 255
+
+########################################################
+# Little handy helpers for scripting
+########################################################
+
+is_bash() {
+    [[ "$(basename "$SHELL")" != "bash" ]]
+}
+
+is_sourced() {
+    [[ "${BASH_SOURCE[0]}" != "$0" ]]
+}
+
+is_root() {
+    [[ "$(id -u)" -ne 0 || $(ps -o comm= -p $PPID) == "sudo" ]]
+}
+
+get_os() {
+    case "$(uname -s)" in
+        Linux*) echo Linux ;;
+        Darwin*) echo Macos ;;
+        CYGWIN*) echo Cygwin ;;
+        MINGW*) echo MinGw ;;
+        MSYS_NT*) echo Git ;;
+        *) return 1 ;;
+    esac
+}
+
+get_os_id() {
+    [ -f /etc/os-release ] && source /etc/os-release
+    echo "$ID"
+}
+
+# convert relative path $1 to full one
+abspath() {
+    echo $(realpath -q "${1/#\~/$HOME}")
+}
+
+# check if path $1 is writable
+is_writable() {
+    [ -w "$(abspath $1)" ]
+}
+
+# check if path $1 is a directory
+is_dir() {
+    [ -d "$(abspath $1)" ]
+}
+
+# check if path $1 is a file
+is_file() {
+    [ -f "$(abspath $1)" ]
+}
+
+# check if an argument is a shell function
+is_function() {
+    declare -F "$1" > /dev/null
+}
+
+# check if string $1 matches regex $2
+regex_match() {
+    printf "%s" "$1" | grep -qP "$2"
+}
+
+# check if array $2 contains string $1
+in_array() {
+	local find=$1
+    shift
+    for e in "$@"; do
+        [[ "$e" == "$find" ]] && return 0
+    done
+    return 1
+}
+
+# join all elements of array $2 with delimiter $1
+implode() {
+    local d=${1-}
+    local f=${2-}
+    if shift 2; then
+        printf %s "$f" "${@/#/$d}"
+    fi
+}
+
+# open url $1 in system web-browser
+open_url() {
+    if which xdg-open > /dev/null; then
+        xdg-open "$1" </dev/null >/dev/null 2>&1 & disown
+    elif which gnome-open > /dev/null; then
+        gnome-open "$1" </dev/null >/dev/null 2>&1 & disown
+    fi
+}
+
+# unpack .tar.gz file $1 into path $2
+unpack_targz() {
+    require tar
+    tar -xzvf "$1" -C "$2"
+}
+
+# make soft symbolic link of path $1 to path $2
+symlink() {
+    ln -sf "$1" "$2"
+}
+
+# download file $1 into path $2 using wget
+download() {
+    require wget
+    wget "$1" -O "$2"
+}
+
+# download file $1 into path $2 using curl
+cdownload() {
+    require curl
+    curl -fsSL "$1" -o "$2"
+}
+
+is_int() {
+    [[ "$1" =~ ^[0-9]+$ ]]
+}
+
+is_number() {
+    [[ "$1" =~ ^[0-9]+([.,][0-9]+)?$ ]]
+}
+
+trim() {
+    echo "$1" | xargs
+}

scripts/helpers/debug.sh

@@ -0,0 +1,3 @@
+#!/usr/bin/env bash
+source $( dirname $(readlink -e -- "${BASH_SOURCE}"))/io.sh || exit 255
+

scripts/helpers/docker.sh

@@ -0,0 +1,79 @@
+#!/usr/bin/env bash
+
+########################################################
+# Docker wrappers
+########################################################
+
+# Вызывает корректную команду docker compose
+docker.compose() {
+    require docker
+
+    argl profiles 0 profiles
+    args=${*/--profiles=[a-zA-Z_,0-9]*/}
+
+    if $(docker compose &>/dev/null); then
+        local cmd="docker compose $args"
+    elif installed_pkg "docker-compose"; then
+        local cmd="docker-compose $args"
+        warn
+        warn "docker-compose v1 устарел и не поддерживается, его поведение непредсказуемо."
+        warn "Обнови docker согласно документации: https://docs.docker.com/engine/install/"
+        warn
+    else
+        error "Должен быть установлен docker-compose-plugin!"
+        die "Установи docker согласно документации: https://docs.docker.com/engine/install/" 2
+    fi
+
+    if [[ "$profiles" ]]; then
+        export COMPOSE_PROFILES=$profiles
+        debug "Выполнено: export COMPOSE_PROFILES=$profiles"
+    fi
+
+    debug "Команда: $cmd"
+    $cmd
+}
+
+# Выводит информацию о контейнере
+docker.inspect() {
+    cmd="docker inspect $*"
+    debug "Команда: $cmd"
+    $cmd 2>/dev/null
+}
+
+# Выполняет команду в контейнере от имени root
+docker.exec() {
+    cmd="docker exec -u root -it $*"
+    debug "Команда: $cmd"
+    $cmd
+}
+
+# Выводит информацию о контейнере
+docker.inspect() {
+    cmd="docker inspect $*"
+    debug "Команда: $cmd"
+    $cmd 2>/dev/null
+}
+
+docker.ip() { # not finished
+    if [ "$1" ]; then
+        if [ "$1" = "-a" ]; then
+            docker ps -aq \
+            | xargs -n 1 docker inspect --format '{{.Name}}{{range .NetworkSettings.Networks}} {{.IPAddress}}{{end}}' \
+            | sed -e 's#^/##' \
+            | column -t
+        elif [ "$1" = "-c" ]; then
+            docker-compose ps -q \
+            | xargs -n 1 docker inspect --format '{{.Name}}{{range .NetworkSettings.Networks}} {{.IPAddress}}{{end}}' \
+            | sed -e 's#^/##' \
+            | column -t
+        else
+            docker inspect --format '{{range .NetworkSettings.Networks}}{{.IPAddress}}{{end}}' "$1"
+            docker port "$1"
+        fi
+    else
+        docker ps -q \
+        | xargs -n 1 docker inspect --format '{{.Name}}{{range .NetworkSettings.Networks}} {{.IPAddress}}{{end}}' \
+        | sed -e 's#^/##' \
+        | column -t
+    fi
+}

scripts/helpers/git.sh

@@ -0,0 +1,178 @@
+#!/usr/bin/env bash
+_dir=$( dirname $(readlink -e -- "${BASH_SOURCE}"))
+source "$_dir/io.sh" || exit 255
+source "$_dir/basic.sh" || exit 255
+source "$_dir/packages.sh" || exit 255
+
+########################################################
+# Shorthands for git
+########################################################
+
+git.clone_quick() {
+    require git
+    git clone --depth=1 --single-branch "$@"
+}
+
+git.is_repo() {
+    require git
+    [ "$1" ] || die "Path is not specified" 101
+    require_dir "$1/"
+    check_dir "$1/.git"
+}
+
+git.require_repo() {
+    require git
+    git.is_repo "$1" || die "'$1' is not git repository!" 10
+}
+
+git.cfg() {
+    require git
+    [ "$1" ] || die "Key is not specified" 101
+    if [[ "$2" ]]; then
+        git config --global --replace-all "$1" "$2"
+    else
+        echo $(git config --global --get-all "$1")
+    fi
+}
+
+git.set_user() {
+    require git
+    [ "$1" ] || die "git.set_user: Repo is not specified" 100
+    git.cfg "$1" "user.name" "$2"
+    git.cfg "$1" "user.email" "$3"
+    success "User set to '$name <$email>' in ${FWHITE}$1"
+}
+
+git.fetch() {
+    require git
+    if [ "$1" ]; then
+        if git.remote_branch_exists "origin/$1"; then
+            git fetch origin "refs/heads/$1:refs/remotes/origin/$1" --progress --prune --quiet 2>&1 || die "Could not fetch $1 from origin" 12
+        else
+            warn "Tried to fetch branch 'origin/$1' but it does not exist."
+        fi
+    else
+        git fetch origin --progress --prune --quiet 2>&1 || exit 12
+    fi
+}
+
+git.reset() {
+    require git
+    git reset --hard HEAD
+    git clean -fd
+}
+
+git.clone() {
+    require git
+    git clone "$*" 2>&1
+}
+
+git.co() {
+    require git
+    git checkout "$*" 2>&1
+}
+
+git.is_it_current_branch() {
+    require git
+    [ "$1" ] || die "git.is_it_current_branch: Branch is not specified" 19
+    [[ "$(git.current_branch)" = "$1" ]]
+}
+
+git.pull() {
+    require git
+    [ "$1" ] && BRANCH=$1 || BRANCH=$(git.current_branch)
+    # note "Updating branch $BRANCH..."
+    git pull origin "refs/heads/$BRANCH:refs/remotes/origin/$BRANCH" --prune --force --quiet 2>&1 || exit 13
+    git pull origin --tags --force --quiet 2>&1 || exit 13
+    # [ "$1" ] || die "git.pull: Branch is not specified" 19
+    # if [ "$1" ]; then
+        # note "Updating branch $1..."
+        # git pull origin "refs/heads/$1:refs/remotes/origin/$1" --prune --force --quiet 2>&1 || exit 13
+    # else
+    #     note "Updating current branch..."
+    #     git pull
+    # fi
+}
+
+git.current_branch() {
+    require git
+    git branch --show-current || exit 18
+}
+
+git.local_branch_exists() {
+    require git
+    [ -n "$(git for-each-ref --format='%(refname:short)' refs/heads/$1)" ]
+}
+
+git.update_refs() {
+    require git
+    info "Updating local refs..."
+    git remote update origin --prune 1>/dev/null 2>&1 || exit 18
+}
+
+git.delete_remote_branch() {
+    require git
+    [ "$1" ] || die "git.remote_branch_exists: Branch is not specified" 19
+    if git.remote_branch_exists "origin/$1"; then
+        git push origin :"$1" # || die "Could not delete the remote $1 in $ORIGIN"
+        return 0
+    else
+        warn "Trying to delete the remote branch $1, but it does not exists in origin"
+        return 1
+    fi
+}
+
+git.is_clean_worktree() {
+    require git
+    git rev-parse --verify HEAD >/dev/null || exit 18
+    git update-index -q --ignore-submodules --refresh
+    git diff-files --quiet --ignore-submodules || return 1
+    git diff-index --quiet --ignore-submodules --cached HEAD -- || return 2
+    return 0
+}
+
+git.is_branch_merged_into() {
+    require git
+    [ "$1" ] || die "git.remote_branch_exists: Branch1 is not specified" 19
+    [ "$2" ] || die "git.remote_branch_exists: Branch2 is not specified" 19
+    git.update_refs
+    local merge_hash=$(git merge-base "$1"^{} "$2"^{})
+    local base_hash=$(git rev-parse "$1"^{})
+    [ "$merge_hash" = "$base_hash" ]
+}
+
+git.remote_branch_exists() {
+    require git
+    [ "$1" ] || die "git.remote_branch_exists: Branch is not specified" 19
+    git.update_refs
+	[ -n "$(git for-each-ref --format='%(refname:short)' refs/remotes/$1)" ]
+}
+
+git.new_branch() {
+    require git
+    [ "$1" ] || die "git.new_branch: Branch is not specified" 19
+    if [ "$2" ] && ! git.local_branch_exists "$2" && git.remote_branch_exists "origin/$2"; then
+        git.co -b "$1" origin/"$2"
+    else
+        git.co -b "$1" "$2"
+    fi
+}
+
+git.require_clean_worktree() {
+    require git
+    if ! git.is_clean_worktree; then
+        warn "Your working tree is dirty! Look at this:"
+        git status -bs
+        _T="What should you do now?\n"
+        _T="${_T}\t${BOLD}${FWHITE}0.${RESET} try to continue as is\t- errors may occur!\n"
+        _T="${_T}\t${BOLD}${FWHITE}1.${RESET} hard reset\t\t\t- clear current changes and new files\n"
+        _T="${_T}\t${BOLD}${FWHITE}2.${RESET} stash changes (default)\t- save all changes in safe to apply them later via 'git stash pop'\n"
+        _T="${_T}\t${BOLD}${FWHITE}3.${RESET} cancel\n"
+        ask "${_T}${BOLD}${FWHITE}Your choice [0-3]" reset_answer
+        case $reset_answer in
+            1 ) warn "Clearing your work..." && git.reset              ;;
+            3 ) exit                                                   ;;
+            * ) git stash -a -u -m "WIP before switch to $branch_task" ;;
+        esac
+    fi
+}

scripts/helpers/help.sh

@@ -0,0 +1,28 @@
+#!/usr/bin/env bash
+#TODO source basic.sh
+#TODO source args-parser/args.sh
+
+########################################################
+# Help functions
+########################################################
+
+process_help_arg() {
+    command="${FUNCNAME[1]}"
+    need_help=$(arg help 1)
+    [[ "$need_help" -eq 0 ]] && need_help=$(argl help 1)
+    [[ "$need_help" -eq 1 ]] && help "$command"
+}
+
+help() {
+    is_function "help.$1" && help."$1" && exit
+    echo "Main help message"
+}
+
+help.example() {
+    echo "Example help message"
+}
+
+example() {
+    process_help_arg
+    echo "Example command"
+}