commit 393f80ff699b57b76b9ab2748af0c39864e810c6
parent 130fd153a7991f89e288427d04011366ea9e58c1
Author: regexghost <dev@regexghost.com>
Date: Wed, 5 Aug 2026 16:07:09 +0100
added more comments in kshrc
Diffstat:
3 files changed, 52 insertions(+), 32 deletions(-)
diff --git a/dotfiles/.kshrc b/dotfiles/.kshrc
@@ -20,24 +20,26 @@ function truncatedpwd
PS1=' \[\033[1;35m\]'"\$(truncatedpwd)"'\[\033[1;34m\]$(directory-bookmarks current)\[\033[1;36m\] >\[\033[0m\] '
# Basic Aliases
-alias grep='/usr/bin/grep -i --color=auto' # Standard grep
+alias grep='/usr/bin/grep -i --color=auto' # standard grep
alias grepa='grep -i -I -A 5 -B 5 --color=auto' # grep surrounding lines
alias gi='/usr/bin/grep -ir --color=auto' # recursive grep
alias diff='diff --color'
alias n='nano'
-alias sq='ncdu' # Not sure why this is "sq" but I'm used to it now
+alias sq='ncdu' # not sure why this is "sq" but I'm used to it now
alias b='bat --wrap word --theme=base16'
-alias mv='mymv'
+alias mv='mymv' # sbase mv doesn't have -i option
alias cp='cp -r -i'
alias cl='ln -s'
-alias duf='duf -hide special'
+alias duf='duf -hide special' # removes /tmp and /run stuff
alias rm='rm-trash'
alias nnn='files'
alias q='exit'
alias pve='pipe-viewer'
-alias vp='vid-play'
-alias vps='vid-play -s'
+alias vp='vid-play' # normal vids
+alias vps='vid-play -s' # shorts
+# I originally used this on the Pi, because the storage being slow meant newsraft
+# lagged when accessing the database
rss () {
pgrep newsraft > /dev/null && echo "Newsraft already open" && return
command cp "$XDG_DATA_HOME/newsraft/newsraft.sqlite3" "/tmp/newsraft.sqlite3"
@@ -47,14 +49,14 @@ rss () {
# Aliases to Specific Commands
-alias dud='du -s -h *'
-alias buf='cat /proc/meminfo | grep --color=no -e Writeback -e Dirty'
+alias dud='du -s -h *' # file/dir sizes in current directory
+alias buf='cat /proc/meminfo | grep --color=no -e Writeback -e Dirty' # data waiting to be written to disk
alias x='chmod +x'
alias copy="sed 's/\n$//g' | xclip -selection c"
-alias watchlc="watch 'ls | wc -l'"
-alias watchdu="watch 'du -s -h *'"
-alias watchbuf="watch 'cat /proc/meminfo | /usr/bin/grep --color=no -e Writeback -e Dirty'"
-alias fatmount='sudo mount -o rw,users,umask=000' # Mount FAT formatted drive correctly
+alias watchlc="watch 'ls | wc -l'" # for monitoring progress of file copy
+alias watchdu="watch 'du -s -h *'" # similar to above
+alias watchbuf="watch 'cat /proc/meminfo | /usr/bin/grep --color=no -e Writeback -e Dirty'" # for monitoring sync/umount
+alias fatmount='sudo mount -o rw,users,umask=000' # mount FAT formatted drive correctly
alias balance='aacgain -r -m 1 *.m4a'
alias reload='. ~/.kshrc'
alias pong='ping -c 2 -W 2'
@@ -67,12 +69,13 @@ alias sshg='ssh gopherbox'
alias qv='~/.config/newsraft/queue-vid.sh'
alias trash-size='du -s -h ~/.local/share/Trash/files/ | cut -f 1'
alias sync='echo "Syncing"; sync; echo "Done"; lsblk'
-alias man='MANWIDTH=$(($(stty size | cut -d " " -f 2)-20)) man'
-alias dff='df -h | grep -e Filesystem -e "^/dev" | grep -v efi'
+alias man='MANWIDTH=$(($(stty size | cut -d " " -f 2)-20)) man' # fixs a bug with word wrapping in bat by limiting man size
+alias dff='df -h | grep -e Filesystem -e "^/dev" | grep -v efi' # show size of proper filesystems
alias hltb='~/.local/share/regexghost/.venv/bin/python3 ~/.local/share/regexghost/terminal/howlongtobeat.py'
alias wttr='curl wttr.in'
alias im='iphone-mount'
+# Build and deploy my main website
web () {
case "$1" in
b*)
@@ -91,6 +94,7 @@ web () {
esac
}
+# Mount android phone/tablet
android () {
case "$1" in
m*)
@@ -117,15 +121,16 @@ alias bga='bug add'
# Git Aliases
alias gd='git diff'
-alias gdc='git diff --cached' # Show diff for things `git add`'ed
+alias gdc='git diff --cached' # show diff for things `git add`'ed
alias gdw='git diff --word-diff-regex=.'
-alias gs='git status .'
-alias gsa='git status'
+alias gs='git status .' # only show files in current dir
+alias gsa='git status' # status for whole git repo
alias gl='git log'
alias glc='echo "$(git rev-list --count HEAD) commits"'
alias ga='git add'
alias gc='git commit'
+# Push to GitHub, Codeberg and my website/server
gpa () {
git push -u origin
git push -u codeberg
@@ -139,21 +144,22 @@ alias pip='~/.local/share/regexghost/.venv/bin/pip'
#### Start Substitute - Package_Manager
-# Other random aliases
-
alias as='echo "Use \as to run as command, disabled as too easy to type accidentally, creating unnecessary a.out file in home directory"'
## Functions to basic programs
# fzf -> editor
qfi () {
+ # Only look for file types you might actually want to manually edit
file="$(find ~/* | grep -E '.py$|.go$|.txt$|.md$|.java$|.js$|.html$|.css$|.c$|.cc$|.conf$|.lua$|.rs$|.sh$|.bash$|.csv$' | sed 's|'"$HOME"'|~|g' | fzf)"
[[ "$file" == "" ]] && return
"${VISUAL:-${EDITOR:-vi}}" "$file"
}
+# Moving config out of ~/
alias v='vim -u ~/.config/vim/vimrc -i ~/.config/vim/viminfo'
+# By default only show broadly useful info
lsblk () {
if [[ "$1" == "-a" ]]; then
/usr/bin/lsblk -o NAME,MAJ:MIN,RM,SIZE,RO,TYPE,FSTYPE,MOUNTPOINTS
@@ -162,11 +168,13 @@ lsblk () {
fi
}
+# Feedback for pkill
pkill () {
command pkill "$@"
- [ "$?" == "0" ] || echo "Program not found"
+ [ "$?" == "0" ] || echo "Program not found/killed"
}
+# Show trash size before empty
trash-empty () {
echo "Trash is $(trash-size)"
/usr/bin/trash-empty
@@ -182,6 +190,7 @@ restorehistory () {
fi
}
+# Aliases to scripts, calendar info and time zone display
alias cal='calendar'
alias t='date-time'
@@ -200,6 +209,7 @@ alias t='date-time'
## Wrapper script
alias yt-dlp='ytdl-wrapper'
+# toml or csv
archiveplaylist () {
if [[ "$1" == "-t" ]]; then
ytdl-wrapper --firefox-cookies --json "$2" | jq '{title, videos: [.entries[] | {title, channel, id}]}' | yq -t
@@ -210,7 +220,7 @@ archiveplaylist () {
# Search commands
-# History
+# History - run through filter to get rid of escape sequences, otherwise it messes up terminal
alias hs="fc -l 0 100000 | sed 's/[^[:print:]\n ]//g'"
alias his='hs | grep'
@@ -219,15 +229,15 @@ findr () {
/usr/bin/find / -iname "$1" 2>&1 | grep -v 'Permission denied'
}
-alias findh='find ~ -iname'
-alias fig='find . | sort | grep'
-alias psg='pgrep -a'
+alias findh='find ~ -iname' # search home
+alias fig='find . | sort | grep' # search current dir
+alias psg='pgrep -a' # search processes
# Load my other aliases and functions
. "$HOME/.local/share/regexghost/terminal/ls_aliases.sh"
[ -f ~/Programs/localStuff/aliases.sh ] && . ~/Programs/localStuff/aliases.sh
-[ -f ~/.profile ] && . ~/.profile
+[ -f ~/.profile ] && . ~/.profile # ~/.profile should be loaded at login, but load it again here so any changes take place immediately
# Set variables
@@ -236,8 +246,8 @@ export HISTFILESIZE=200000
export HISTFILE="$HOME/.history"
export HISTCONTROL=ignoredups:erasedups
-export MICRO_TRUECOLOR=1
-export PASSWORD_STORE_CLIP_TIME=120
+export MICRO_TRUECOLOR=1 # micro proper colourschemes
+export PASSWORD_STORE_CLIP_TIME=120 # keep passwords in clipboard for longer (for "pass" cli password manager)
# Quick file/directory access
@@ -252,6 +262,7 @@ alias loc='cd ~/.local/share/'
alias bin='cd ~/.local/bin/'
alias con='cd ~/.config/'
+# cd to directories using my bookmarking program
to () {
cd "$(directory-bookmarks get "$1")"
}
@@ -261,12 +272,15 @@ alias bmr='directory-bookmarks remove'
alias bml='directory-bookmarks list'
alias bmc='directory-bookmarks current'
+# Hide output on cd -
alias cdp='cd - > /dev/null'
+# Quickly go up X dirs
alias cdr='cd ..'
alias cdrr='cd ../..'
alias cdrrr='cd ../../..'
+# Wrapper function for my blog post script
blog () {
if [ "$1" = "cd" ]; then
cd "$(blog-devlog blog "cd")"
@@ -275,11 +289,12 @@ blog () {
fi
}
-alias devlog='blog-devlog devlog'
+alias devlog='blog-devlog devlog' # devlog in blog script
-export _FASD_DATA="$XDG_CACHE_HOME/fasd"
-export _FASD_NOCASE=1
-fasd_cache="$XDG_CACHE_HOME/fasd-init"
+export _FASD_DATA="$XDG_CACHE_HOME/fasd" # move out of ~/
+export _FASD_NOCASE=1 # case insensitive
+fasd_cache="$XDG_CACHE_HOME/fasd-init" # move out of ~
+# Cache startup to speed up terminal load time
if [ "$(command -v fasd)" -nt "$fasd_cache" -o ! -s "$fasd_cache" ]; then
echo "Caching fasd startup"
fasd --init posix-alias posix-hook >| "$fasd_cache"
@@ -287,6 +302,7 @@ fi
. "$fasd_cache"
unset fasd_cache
+# Wrapper function, allows going back to previous dir
do_z () {
command="fasd_cd -d"
if [[ "$1" == "--choice" ]]; then
@@ -304,6 +320,7 @@ do_z () {
$command "$1"
}
+# Open bookmarked file in editor
qf () {
file="$(directory-bookmarks file get "$1")"
[[ "$file" == "" ]] && return
@@ -320,6 +337,7 @@ unalias zz
alias z='do_z'
alias zz='do_z --choice'
+# Remove unused fasd aliases
unalias a
unalias s
unalias sd
diff --git a/dotfiles/Package_Manager-Substitution-apt-.kshrc b/dotfiles/Package_Manager-Substitution-apt-.kshrc
@@ -1,7 +1,6 @@
#### Start Substitute - Package_Manager
alias install='sudo apt install'
alias remove='sudo apt remove'
-alias autoremove='sudo apt autoremove'
alias update='sudo apt update && sudo apt upgrade'
alias search='apt search'
alias aptlog='cat /var/log/dpkg.log | grep'
diff --git a/dotfiles/Power_Management-Substitution-jwm-pi-.kshrc b/dotfiles/Power_Management-Substitution-jwm-pi-.kshrc
@@ -1,11 +1,14 @@
#### Start Substitute - Power_Management
## Shutdown with confirmation
shutdown_commands () {
+ # Check if moc is running, if so stop
if pgrep "mocp" > /dev/null; then
mocp -M "$XDG_CONFIG_HOME/moc" --stop
fi
+ # Save latest reddit rss to ~/.cache
/usr/bin/rm -rf "$XDG_CACHE_HOME/reddit-rss"
cp -r /tmp/reddit-rss "$XDG_CACHE_HOME/reddit-rss"
+ # Save and exit scratchpad buffer (if running)
if pgrep -f "tmux new-session -d -s buffer_tmux" > /dev/null; then
tmux send-keys -t buffer_tmux.0 C-s
tmux send-keys -t buffer_tmux.0 C-q
