add script

obsidian seems to only have a per-vault config approach, so my approach
is to define settings within .config/obsidian, then copy to vault dirs

README.md

@@ -10,23 +10,24 @@
 #### specific prereqs, macos
 - install the package manager, [homebrew](https://brew.sh/)
 - for aerospace window manager, have only 1 workspace/desktop
-- manual settings, refer to [macos-system-settings](ref/macos-system-settings.txt)
+- manual settings, refer to [ref/macos-system-settings](ref/macos-system-settings.txt)
 
 ### script run
-- (run these commands from repo's root dir)
-- to do the full setup, run: `./box_setup.sh <OS-name>`
-- to copy dotfiles only, run: `./copy_dotfiles.sh`
-    - NOTE: the `copy_dotfiles.sh` script may not work if ENV vars are not set as expected
+- to do the full setup, from git root dir, run: `./box_setup.sh`
+- to copy dotfiles only, from git root dir, run: `./copy_dotfiles.sh`
 
 ### after script run
-- complete manual actions specified in [ref/post-run-manual.md](ref/post-run-manual.md)
+- complete manual actions specified in [ref/post-run](ref/post-run.md)
+
+------------------------------------------------------------------------------------------
 
 ### todo items
 - choose window manager for linux, then configure
 - config for: terminal (ghostty); shell; mpd, mpc, ncmpcpp; mpv
-- config for gimp, `src_files/.config/GIMP` (dir)
-    - set things in gtkrc only? still need to nest that within a sub dir?
-    - or configure in gimp, copy resulting dir to `src_files/.config/GIMP`, call it a day
-- decide on and implement approach for languages and versioning
-    - language-specific? asdf? no, not asdf, mise seems better from what i hear so far
-    - docker? or alternatives like podman? any license concerns?
+- decide on docker? or alternatives like podman? any license concerns?
+- switch installation approach, use csv file with programs to install, install types,
+  any extra flags/opts, comments
+    - regarding the system-types idea i'd started to build in already, maybe have a
+      column for filtering in the csv file, or just have multiple csv files corresponding
+      to a base/core install, a music-studio install, a employer/work machine, etc.
+- add command in tmux to perform cd to a given dir in all windows of the current session

box_setup.sh

@@ -1,40 +1,47 @@
 #!/bin/zsh
 
-[[ -z $1 ]] && {
-    echo "OS must be passed as an arg, run \`./box_setup.sh --help\` for more info"
-    exit 1
-}
-
 [[ $1 = "--help" ]] && {
-    echo "usage: ./box_setup.sh <OS-name> [system-type]\n"
-    echo "OS-name options: arch, artix, debian, macos"
-    echo "system-type options: personal, studio-music, work-placeholder\n"
-    echo "examples:\n./box_setup.sh arch studio-music\n./box_setup.sh macos\n"
+    echo "\nusage: ./box_setup.sh [system-type]"
+    echo "\nsystem-type options: personal, studio-music, work-placeholder"
+    echo "\nexamples:\n    ./box_setup.sh\n    ./box_setup.sh studio-music\n"
     exit 0
 }
 
-# set env vars for installs
-install_cmd=''
-update_pkg_manager_and_defs_cmd=''
-update_pkgs_cmd=''
-case $1 in
-    (arch | artix)
-        install_cmd="sudo pacman -S"
-        update_pkg_manager_and_defs_cmd='' # don't; update system instead?
-        update_pkgs_cmd='sudo pacman -Syu'
-	;;
-    (debian)
-        install_cmd="sudo apt install"
-        update_pkg_manager_and_defs_cmd='sudo apt update'
-        update_pkgs_cmd='sudo apt upgrade'
-	;;
-    (macos)
-        install_cmd="brew install"
-        update_pkg_manager_and_defs_cmd='brew update'
-        update_pkgs_cmd='brew upgrade'
-	;;
-esac
+# determine OS and, if linux, distro
+[[ "$OSTYPE" = *"darwin"* ]] && setup_os="macos" || {
+    [[ "$OSTYPE" = *"linux"* ]] && setup_os="linux" && {
+        [[ -f /etc/os-release ]] && . /etc/os-release
+        setup_distro=$(echo "${NAME%% *}" | tr '[:upper:]' '[:lower:]')
+        [[ -z "$setup_distro" ]] && echo "OS: linux; distro not detected" && exit 1
+    }
+}
+[[ -z "$setup_os" ]] && echo "OS not detected" && exit 1
 
+# set package manager commands for installs
+[[ "$setup_os" = "macos" ]] && {
+    install_cmd="brew install"
+    update_pkg_manager_and_defs_cmd='brew update'
+    update_pkgs_cmd='brew upgrade'
+} || {
+    [[ "$setup_os" = "linux" ]] && {
+        case $setup_distro in
+            (arch | artix)
+                install_cmd="sudo pacman -S"
+                update_pkg_manager_and_defs_cmd='' # don't; update system instead?
+                update_pkgs_cmd='sudo pacman -Syu'
+        	;;
+            (debian)
+                install_cmd="sudo apt install"
+                update_pkg_manager_and_defs_cmd='sudo apt update'
+                update_pkgs_cmd='sudo apt upgrade'
+        	;;
+        esac
+    }
+}
+
+# export vars for scripts
+export BOX_SETUP_OS="$setup_os"
+export BOX_SETUP_DISTRO="$setup_distro"
 export BOX_SETUP_INSTALL_COMMAND="$install_cmd"
 export BOX_SETUP_UPDATE_PKG_MANAGER_AND_DEFS_CMD="$update_pkg_manager_and_defs_cmd"
 export BOX_SETUP_UPDATE_PKGS_CMD="$update_pkgs_cmd"
@@ -42,10 +49,10 @@ export BOX_SETUP_UPDATE_PKGS_CMD="$update_pkgs_cmd"
 # make dirs and copy configs/dotfiles
 source ./src_files/.config/zsh/.zshenv
 ./make_dirs.sh
-./copy_dotfiles.sh $2
+./copy_dotfiles.sh $1
 
 # install programs
 source $ZDOTDIR/.zshenv
 source $ZDOTDIR/.zshrc
-./install_programs.sh $2
+./install_programs.sh $1
 

copy_dotfiles.sh

@@ -40,15 +40,16 @@ copy_file src_files/.config/zsh/.zshenv $HOME # duplicate, copy anyway, ensures
 
 copy_dir src_files/.config $XDG_CONFIG_HOME
 copy_dir src_files/.local/bin $DIR_BIN
+[[ "$OSTYPE" = *"darwin"* ]] && copy_dir src_files/bin_overrides_macos $DIR_BIN
 copy_dir src_files/.local/scripts $DIR_SCRIPTS
 
-[[ "$BOX_SETUP_OS" = "macos" ]] && {
-    copy_dir src_files/executable_wrappers_macos $DIR_BIN
-    link_dir "$XDG_CONFIG_HOME/GIMP" "$HOME/Library/Application Support/GIMP"
-}
+for obs_dir in "${OBSIDIAN_WORKSPACES_TO_CONFIGURE[@]}"; do
+    [[ ! -d "$obs_dir/.obsidian" ]] && mkdir "$obs_dir/.obsidian"
+    copy_dir $XDG_CONFIG_HOME/obsidian "$obs_dir/.obsidian"
+done
 
 # [[ $1 = "studio-music" ]] {
-#     [[ "$BOX_SETUP_OS" = "macos" ]] &&
+#     [[ "$OSTYPE" = *"darwin"* ]] &&
 #         link_dir "$XDG_CONFIG_HOME/REAPER" "$HOME/Library/Application Support/REAPER" # TODO: get reaper config set up
 # }
 

installs_and_builds/s02_utils

@@ -12,5 +12,16 @@ ${=BOX_SETUP_INSTALL_COMMAND} \
     grep \
     ripgrep
 
+utils_package_name_pandoc="pandoc"
+case $BOX_SETUP_DISTRO in
+    (arch | alpine)
+        utils_package_name_pandoc="pandoc-cli"
+        ;;
+    (artix)
+        utils_package_name_pandoc="pandoc-bin"
+        ;;
+esac
+${=BOX_SETUP_INSTALL_COMMAND} $utils_package_name_pandoc
+
 [[ "$BOX_SETUP_OS" = "macos" ]] &&
-    ${=BOX_SETUP_INSTALL_COMMAND} coreutils
+    ${=BOX_SETUP_INSTALL_COMMAND} coreutils findutils

installs_and_builds/s12_web_browser

@@ -1,8 +1,10 @@
 #!/bin/zsh
 
-# TODO: replace firefox with brave or another browser
+# TODO: get browser config and install set up
+# current idea: qutebrowser for general, tor for sensitive, brave as a backup option
+
 # install_option_prefix=''
 # [[ "$BOX_SETUP_OS" = "macos" ]] && install_option_prefix='--cask'
 # firefox_package_name='firefox'
-# [[ "$BOX_SETUP_OS" = "debian" ]] && firefox_package_name='firefox-esr'
+# [[ "$BOX_SETUP_DISTRO" = "debian" ]] && firefox_package_name='firefox-esr'
 # ${=BOX_SETUP_INSTALL_COMMAND} "$install_option_prefix" "$firefox_package_name"

installs_and_builds/s31_docker

@@ -7,15 +7,7 @@ setup_docker_on_debian() {
     echo "setup_docker_on_debian function not implemented"
 }
 
-# TODO: decide on docker vs others; below is included just for reference
-# case $BOX_SETUP_OS in
-#     (arch | artix)
-#         ${=BOX_SETUP_INSTALL_COMMAND} docker
-#         ;;
-#     (debian)
-#         setup_docker_on_debian
-#         ;;
-#     (macos)
-#         ${=BOX_SETUP_INSTALL_COMMAND} docker
-#         ;;
-# esac
+# TODO: decide on docker vs others
+[[ "$BOX_SETUP_DISTRO" = "debian" ]] && setup_docker_on_debian || {
+    ${=BOX_SETUP_INSTALL_COMMAND} docker
+}

make_dirs.sh

@@ -5,9 +5,10 @@ source ./src_files/.config/zsh/.zshenv # ensure env vars set for use below
 # some standard/common directories, some overlap/use in XDG directories
 [[ ! -d "$DIR_LOCAL" ]] && mkdir -p "$DIR_LOCAL"
 [[ ! -d "$DIR_BIN" ]] && mkdir -p "$DIR_BIN"
-[[ ! -d "$DIR_BUILD" ]] && mkdir -p "$DIR_BUILD"
 [[ ! -d "$DIR_SCRIPTS" ]] && mkdir -p "$DIR_SCRIPTS"
 [[ ! -d "$DIR_TMP" ]] && mkdir -p "$DIR_TMP"
+[[ ! -d "$DIR_USER_OPT" ]] && mkdir -p "$DIR_USER_OPT"
+[[ ! -d "$DIR_USER_LIB" ]] && mkdir -p "$DIR_USER_LIB"
 
 # directories related to XDG Base Directory specification
 [[ ! -d "$XDG_CONFIG_HOME" ]] && mkdir -p "$XDG_CONFIG_HOME"
@@ -23,3 +24,8 @@ source ./src_files/.config/zsh/.zshenv # ensure env vars set for use below
 [[ ! -d "$DIR_GIT_PROJECTS" ]] && mkdir -p $DIR_GIT_PROJECTS
 [[ ! -d "$DIR_GIT_PROJECTS/me" ]] && mkdir -p $DIR_DEV/git/me
 [[ ! -d "$DIR_GIT_PROJECTS/other" ]] && mkdir -p $DIR_DEV/git/other
+
+# directories for music/audio production
+[[ ! -d "$DIR_REAPER_PORTABLE_SHARED" ]] && mkdir -p $DIR_REAPER_PORTABLE_SHARED
+[[ ! -d "$DIR_REAPER_PORTABLE_LINUX" ]] && mkdir -p $DIR_REAPER_PORTABLE_LINUX
+[[ ! -d "$DIR_REAPER_PORTABLE_MACOS" ]] && mkdir -p $DIR_REAPER_PORTABLE_MACOS

ref/macos-system-settings.txt

@@ -1,4 +1,4 @@
-// settings for manual configuration in macos system settings app
+// settings for manual configuration in macOS system settings app
 // NOTE: some of these could be scripted, but for now i'm okay with this manual list
 
 - desktop/dock/mission-control:

ref/workflow-and-workspaces-scheme.md

@@ -0,0 +1,61 @@
+# notes regarding my workflow and intended use of workspaces
+
+## workspaces layout
+
+idea from the ThePrimeagen: designated workspace/label/desktop per app/purpose
+
+### current layout/plan
+
+| workspace number                                             | wm layout/mode         |
+|--------------------------------------------------------------|------------------------|
+| 1. notes (stack: nvim, obsidian)                             | stack                  |
+| 2. music makeing - misc                                      | stack                  |
+| 3. music making - daw                                        | floating (workaround)  |
+| 4. drawing (currently: gimp)                                 | stack                  |
+| 5. music/audio listening                                     | stack                  |
+| 6. comms (stack: emails, chats, av/calls)                    | stack                  |
+| 7. web browser                                               | stack                  |
+| 8. terminal (primary; one-offs & tui apps can be anywhere)   | stack                  |
+| 9. programming - misc (whatever is not in terminal)          | stack                  |
+| 0. general - misc (catch-all)                                | stack                  |
+
+### ideas/guidelines:
+- use this consistently accross all machines
+    - if something not applicable for a given machine, just don't have apps or screens
+      present, but maintain absolute position/numbering of each screen
+- structure the above so that programs which i'm likely to use with one hand off of the
+  keyboard (i.e. to use a trackpad, mouse, stylus, etc) are on the screens that allow
+  for one hand (i.e. the one still on the keyboard) to navigate those screens
+    - for me, using peripherals with right hand, so put programs likely to be used with
+      peripherals where my left hand can switch to them single-handedly (screens 1 to 5)
+
+## workflow / use notes
+
+- related to the layout above, my approach is to run almost every window in fullscreen
+    - note: on macOS, this is not mac's notion of fullscreen, which basically moves
+      windows to new workspaces/desktops when going to fullscreen mode; instead, when i
+      say 'fullscreen', the idea is taking up all of the normal screen (excluding the
+      menu bar at the top of the screen)
+- key bindings are set for moving window focus up/down (vim style: mod + k/j)
+    - the mental model here is that every fullscreen window is in a stack, so i can move
+      focus up and down the stack (and i try to maintain consistent order in stacks,
+      e.g. in the comms workspace, email is always on the bottom and chat apps are above)
+- for apps with tabs, pair the above mental model of a stack with a mental model of a
+  circular list being in any position in that stack
+    - so, keybindings are also set for previous/next tab (vim style: mod + h/l)
+    - specifically, mod+h is mapped to ctrl+shift+tab and mod+l is mapped to ctrl+tab,
+      so it should work anywhere ctrl+tab and ctrl+shift+tab work
+- all this said, it is better to keep things simple when possible and avoid having too
+  many windows and/or tabs open at one time; however, with the designated purpose for
+  each workspace and the mental models above, it rarely takes me long to find what i need
+
+## example cases
+
+- if i want a particular browser window, i jump to workspace 9, then move focus
+  up or down until i get to the window i want; if the window is right but i need
+  a different tab, i then just move "right or left" through my tabs
+- if i want a particular music-playing app/tui, i jumpt to workspace 4 and move
+  focus up or down as needed to find it
+- variation case: if i want a particular terminal workspace, i jump to workspace
+  8, but then i'm in tmux land and navigate via the methods i've set up for tmux
+

ref/workflow-desktops-scheme.txt

@@ -1,24 +0,0 @@
-//////////////////////////////////////////////////////////////////////////////////////////
-// idea from the primeagen, designated label/workspace/desktop per app/purpose
-
-// current layout/plan                                         // wm default layout/mode
-1. notes/drawing/thinking (notes app, drawing pad, etc)        stack (fullscreen)
-2. music makeing - misc                                        stack (fullscreen)
-3. music making - daw                                          floating
-4. music/audio listening                                       stack (fullscreen)
-5. general misc (catch-all)                                    stack (fullscreen)
-6. comms (email, chats, etc)                                   stack (fullscreen)
-7. dev - misc                                                  stack (fullscreen)
-8. terminal (primary, but audio/one-off/etc can be anywhere)   stack (fullscreen)
-9. web browser                                                 stack (fullscreen)
-
-// ideas/guidelines:
-- use this consistently accross all machines
-    - if something not applicable for a given machine, just don't have apps or screens
-        present, but maintain absolute position/numbering of each screen
-- structure the above so that programs which i'm likely to use with one hand off of the
-    keyboard (i.e. to use a trackpad, mouse, stylus, etc) are on the screens that allow
-    for one hand (i.e. the one still on the keyboard) to navigate those screens
-    - for me, using peripherals with right hand, so put programs likely to be used with
-        peripherals where my left hand can switch to them single-handedly (screens 1 to 5)
-

src_files/.config/aerospace/aerospace.toml

@@ -9,7 +9,7 @@ enable-normalization-opposite-orientation-for-nested-containers = true
 accordion-padding = 0 # ref: https://nikitabobko.github.io/AeroSpace/guide#layouts
 
 default-root-container-layout = 'accordion' # tiles|accordion
-default-root-container-orientation = 'auto' # horizontal|vertical|auto
+default-root-container-orientation = 'vertical' # horizontal|vertical|auto
 
 # refs: https://nikitabobko.github.io/AeroSpace/guide#on-focus-changed-callbacks
 #       https://nikitabobko.github.io/AeroSpace/commands#move-mouse
@@ -61,21 +61,24 @@ automatically-unhide-macos-hidden-apps = true
     # '''
 
     # See: https://nikitabobko.github.io/AeroSpace/commands#layout
-    alt-slash = 'layout tiles horizontal vertical'
-    alt-comma = 'layout accordion horizontal vertical'
+    alt-comma = 'layout v_accordion'
+    alt-period = 'layout h_tiles'
+    alt-slash = 'layout horizontal vertical'
 
     # See: https://nikitabobko.github.io/AeroSpace/commands#focus
-    alt-j = 'focus down'
-    alt-k = 'focus up'
+    # new windows are added to the stack "below" the current, so swap up and down
+    alt-j = 'focus up'
+    alt-k = 'focus down'
     # bindings: alt-l -> ctrl-tab, alt-h -> ctrl-shift-tab
     # alt-l = "exec-and-forget osascript -e 'tell application \"System Events\" to key code 48 using control down'"
     # alt-h = "exec-and-forget osascript -e 'tell application \"System Events\" to key code 48 using {control down, shift down}'"
 
 
     # See: https://nikitabobko.github.io/AeroSpace/commands#move
+    # new windows are added to the stack "below" the current, so swap up and down
+    alt-shift-j = 'move up'
+    alt-shift-k = 'move down'
     alt-shift-h = 'move left'
-    alt-shift-j = 'move down'
-    alt-shift-k = 'move up'
     alt-shift-l = 'move right'
 
     # See: https://nikitabobko.github.io/AeroSpace/commands#resize
@@ -92,6 +95,7 @@ automatically-unhide-macos-hidden-apps = true
     alt-7 = 'workspace 7'
     alt-8 = 'workspace 8'
     alt-9 = 'workspace 9'
+    alt-0 = 'workspace 0'
 
     # See: https://nikitabobko.github.io/AeroSpace/commands#move-node-to-workspace
     alt-shift-1 = 'move-node-to-workspace 1'
@@ -103,6 +107,7 @@ automatically-unhide-macos-hidden-apps = true
     alt-shift-7 = 'move-node-to-workspace 7'
     alt-shift-8 = 'move-node-to-workspace 8'
     alt-shift-9 = 'move-node-to-workspace 9'
+    alt-shift-0 = 'move-node-to-workspace 0'
 
     # See: https://nikitabobko.github.io/AeroSpace/commands#mode
     alt-shift-semicolon = 'mode service'
@@ -115,9 +120,8 @@ automatically-unhide-macos-hidden-apps = true
 
     r = ['flatten-workspace-tree', 'mode main'] # reset layout
     f = ['flatten-workspace-tree', 'layout floating', 'mode main']
-    t = ['flatten-workspace-tree', 'layout tiling', 'mode main']
-    s = ['layout v_accordion', 'mode main']
-    g = ['layout v_tiles', 'mode main']
+    s = ['flatten-workspace-tree', 'layout v_accordion', 'mode main']
+    g = ['flatten-workspace-tree', 'layout h_tiles', 'mode main']
 
     alt-shift-h = ['join-with left', 'mode main']
     alt-shift-j = ['join-with down', 'mode main']

src_files/.config/aerospace/ref-aerospace-default.toml

@@ -1,206 +0,0 @@
-# Place a copy of this config to ~/.aerospace.toml
-# After that, you can edit ~/.aerospace.toml to your liking
-
-# You can use it to add commands that run after AeroSpace startup.
-# Available commands : https://nikitabobko.github.io/AeroSpace/commands
-after-startup-command = []
-
-# Start AeroSpace at login
-start-at-login = false
-
-# Normalizations. See: https://nikitabobko.github.io/AeroSpace/guide#normalization
-enable-normalization-flatten-containers = true
-enable-normalization-opposite-orientation-for-nested-containers = true
-
-# See: https://nikitabobko.github.io/AeroSpace/guide#layouts
-# The 'accordion-padding' specifies the size of accordion padding
-# You can set 0 to disable the padding feature
-accordion-padding = 30
-
-# Possible values: tiles|accordion
-default-root-container-layout = 'tiles'
-
-# Possible values: horizontal|vertical|auto
-# 'auto' means: wide monitor (anything wider than high) gets horizontal orientation,
-#               tall monitor (anything higher than wide) gets vertical orientation
-default-root-container-orientation = 'auto'
-
-# Mouse follows focus when focused monitor changes
-# Drop it from your config, if you don't like this behavior
-# See https://nikitabobko.github.io/AeroSpace/guide#on-focus-changed-callbacks
-# See https://nikitabobko.github.io/AeroSpace/commands#move-mouse
-# Fallback value (if you omit the key): on-focused-monitor-changed = []
-on-focused-monitor-changed = ['move-mouse monitor-lazy-center']
-
-# You can effectively turn off macOS "Hide application" (cmd-h) feature by toggling this flag
-# Useful if you don't use this macOS feature, but accidentally hit cmd-h or cmd-alt-h key
-# Also see: https://nikitabobko.github.io/AeroSpace/goodies#disable-hide-app
-automatically-unhide-macos-hidden-apps = false
-
-# Possible values: (qwerty|dvorak|colemak)
-# See https://nikitabobko.github.io/AeroSpace/guide#key-mapping
-[key-mapping]
-    preset = 'qwerty'
-
-# Gaps between windows (inner-*) and between monitor edges (outer-*).
-# Possible values:
-# - Constant:     gaps.outer.top = 8
-# - Per monitor:  gaps.outer.top = [{ monitor.main = 16 }, { monitor."some-pattern" = 32 }, 24]
-#                 In this example, 24 is a default value when there is no match.
-#                 Monitor pattern is the same as for 'workspace-to-monitor-force-assignment'.
-#                 See:
-#                 https://nikitabobko.github.io/AeroSpace/guide#assign-workspaces-to-monitors
-[gaps]
-    inner.horizontal = 0
-    inner.vertical =   0
-    outer.left =       0
-    outer.bottom =     0
-    outer.top =        0
-    outer.right =      0
-
-# 'main' binding mode declaration
-# See: https://nikitabobko.github.io/AeroSpace/guide#binding-modes
-# 'main' binding mode must be always presented
-# Fallback value (if you omit the key): mode.main.binding = {}
-[mode.main.binding]
-
-    # All possible keys:
-    # - Letters.        a, b, c, ..., z
-    # - Numbers.        0, 1, 2, ..., 9
-    # - Keypad numbers. keypad0, keypad1, keypad2, ..., keypad9
-    # - F-keys.         f1, f2, ..., f20
-    # - Special keys.   minus, equal, period, comma, slash, backslash, quote, semicolon,
-    #                   backtick, leftSquareBracket, rightSquareBracket, space, enter, esc,
-    #                   backspace, tab, pageUp, pageDown, home, end, forwardDelete,
-    #                   sectionSign (ISO keyboards only, european keyboards only)
-    # - Keypad special. keypadClear, keypadDecimalMark, keypadDivide, keypadEnter, keypadEqual,
-    #                   keypadMinus, keypadMultiply, keypadPlus
-    # - Arrows.         left, down, up, right
-
-    # All possible modifiers: cmd, alt, ctrl, shift
-
-    # All possible commands: https://nikitabobko.github.io/AeroSpace/commands
-
-    # See: https://nikitabobko.github.io/AeroSpace/commands#exec-and-forget
-    # You can uncomment the following lines to open up terminal with alt + enter shortcut
-    # (like in i3)
-    # alt-enter = '''exec-and-forget osascript -e '
-    # tell application "Terminal"
-    #     do script
-    #     activate
-    # end tell'
-    # '''
-
-    # See: https://nikitabobko.github.io/AeroSpace/commands#layout
-    alt-slash = 'layout tiles horizontal vertical'
-    alt-comma = 'layout accordion horizontal vertical'
-
-    # See: https://nikitabobko.github.io/AeroSpace/commands#focus
-    alt-h = 'focus left'
-    alt-j = 'focus down'
-    alt-k = 'focus up'
-    alt-l = 'focus right'
-
-    # See: https://nikitabobko.github.io/AeroSpace/commands#move
-    alt-shift-h = 'move left'
-    alt-shift-j = 'move down'
-    alt-shift-k = 'move up'
-    alt-shift-l = 'move right'
-
-    # See: https://nikitabobko.github.io/AeroSpace/commands#resize
-    alt-minus = 'resize smart -50'
-    alt-equal = 'resize smart +50'
-
-    # See: https://nikitabobko.github.io/AeroSpace/commands#workspace
-    alt-1 = 'workspace 1'
-    alt-2 = 'workspace 2'
-    alt-3 = 'workspace 3'
-    alt-4 = 'workspace 4'
-    alt-5 = 'workspace 5'
-    alt-6 = 'workspace 6'
-    alt-7 = 'workspace 7'
-    alt-8 = 'workspace 8'
-    alt-9 = 'workspace 9'
-    alt-a = 'workspace A' # In your config, you can drop workspace bindings that you don't need
-    alt-b = 'workspace B'
-    alt-c = 'workspace C'
-    alt-d = 'workspace D'
-    alt-e = 'workspace E'
-    alt-f = 'workspace F'
-    alt-g = 'workspace G'
-    alt-i = 'workspace I'
-    alt-m = 'workspace M'
-    alt-n = 'workspace N'
-    alt-o = 'workspace O'
-    alt-p = 'workspace P'
-    alt-q = 'workspace Q'
-    alt-r = 'workspace R'
-    alt-s = 'workspace S'
-    alt-t = 'workspace T'
-    alt-u = 'workspace U'
-    alt-v = 'workspace V'
-    alt-w = 'workspace W'
-    alt-x = 'workspace X'
-    alt-y = 'workspace Y'
-    alt-z = 'workspace Z'
-
-    # See: https://nikitabobko.github.io/AeroSpace/commands#move-node-to-workspace
-    alt-shift-1 = 'move-node-to-workspace 1'
-    alt-shift-2 = 'move-node-to-workspace 2'
-    alt-shift-3 = 'move-node-to-workspace 3'
-    alt-shift-4 = 'move-node-to-workspace 4'
-    alt-shift-5 = 'move-node-to-workspace 5'
-    alt-shift-6 = 'move-node-to-workspace 6'
-    alt-shift-7 = 'move-node-to-workspace 7'
-    alt-shift-8 = 'move-node-to-workspace 8'
-    alt-shift-9 = 'move-node-to-workspace 9'
-    alt-shift-a = 'move-node-to-workspace A'
-    alt-shift-b = 'move-node-to-workspace B'
-    alt-shift-c = 'move-node-to-workspace C'
-    alt-shift-d = 'move-node-to-workspace D'
-    alt-shift-e = 'move-node-to-workspace E'
-    alt-shift-f = 'move-node-to-workspace F'
-    alt-shift-g = 'move-node-to-workspace G'
-    alt-shift-i = 'move-node-to-workspace I'
-    alt-shift-m = 'move-node-to-workspace M'
-    alt-shift-n = 'move-node-to-workspace N'
-    alt-shift-o = 'move-node-to-workspace O'
-    alt-shift-p = 'move-node-to-workspace P'
-    alt-shift-q = 'move-node-to-workspace Q'
-    alt-shift-r = 'move-node-to-workspace R'
-    alt-shift-s = 'move-node-to-workspace S'
-    alt-shift-t = 'move-node-to-workspace T'
-    alt-shift-u = 'move-node-to-workspace U'
-    alt-shift-v = 'move-node-to-workspace V'
-    alt-shift-w = 'move-node-to-workspace W'
-    alt-shift-x = 'move-node-to-workspace X'
-    alt-shift-y = 'move-node-to-workspace Y'
-    alt-shift-z = 'move-node-to-workspace Z'
-
-    # See: https://nikitabobko.github.io/AeroSpace/commands#workspace-back-and-forth
-    alt-tab = 'workspace-back-and-forth'
-    # See: https://nikitabobko.github.io/AeroSpace/commands#move-workspace-to-monitor
-    alt-shift-tab = 'move-workspace-to-monitor --wrap-around next'
-
-    # See: https://nikitabobko.github.io/AeroSpace/commands#mode
-    alt-shift-semicolon = 'mode service'
-
-# 'service' binding mode declaration.
-# See: https://nikitabobko.github.io/AeroSpace/guide#binding-modes
-[mode.service.binding]
-    esc = ['reload-config', 'mode main']
-    r = ['flatten-workspace-tree', 'mode main'] # reset layout
-    f = ['layout floating tiling', 'mode main'] # Toggle between floating and tiling layout
-    backspace = ['close-all-windows-but-current', 'mode main']
-
-    # sticky is not yet supported https://github.com/nikitabobko/AeroSpace/issues/2
-    #s = ['layout sticky tiling', 'mode main']
-
-    alt-shift-h = ['join-with left', 'mode main']
-    alt-shift-j = ['join-with down', 'mode main']
-    alt-shift-k = ['join-with up', 'mode main']
-    alt-shift-l = ['join-with right', 'mode main']
-
-    down = 'volume down'
-    up = 'volume up'
-    shift-down = ['volume set 0', 'mode main']

src_files/.config/gimp/colorrc

@@ -0,0 +1,9 @@
+# GIMP colorrc
+#
+# This file holds a list of recently used colors.
+
+(color-history
+    (color "R'G'B'A float" 16 "\1\0\200\77\1\0\200\77\1\0\200\77\0\0\200\77" 0)
+    (color "R'G'B'A float" 16 "\0\0\0\0\0\0\0\0\0\0\0\0\0\0\200\77" 0))
+
+# end of colorrc

src_files/.config/gimp/contextrc

@@ -0,0 +1,18 @@
+# GIMP user context
+
+(tool "gimp-pencil-tool")
+(paint-info "gimp-pencil")
+(foreground
+    (color "R'G'B'A float" 16 "\1\0\200\77\1\0\200\77\1\0\200\77\0\0\200\77" 0))
+(background
+    (color "R'G'B'A float" 16 "\0\0\0\0\0\0\0\0\0\0\0\0\0\0\200\77" 0))
+(brush "2. Hardness 050")
+(dynamics "Pressure Opacity")
+(mybrush "100% Opaque")
+(pattern "Pine")
+(gradient "FG to BG (RGB)")
+(palette "Color History")
+(font "Sans-serif")
+(tool-preset "Core Pointer")
+
+# end of user context

src_files/.config/gimp/gimprc

@@ -0,0 +1,52 @@
+# GIMP gimprc
+#
+# personal gimprc file, takes precedence over values in system-wide gimprc
+# if changing within gimp, make sure i copy those settings into my dotfiles src_files
+
+(prev-language "en-US")
+(config-version "3.0.6")
+(default-image
+    (width 2480)
+    (height 1748)
+    (unit pixels)
+    (xresolution 300)
+    (yresolution 300)
+    (resolution-unit inches)
+    (image-type rgb)
+    (precision u8-non-linear)
+    (color-profile NULL)
+    (simulation-profile NULL)
+    (simulation-bpc no)
+    (simulation-intent relative-colorimetric)
+    (fill-type background)
+    (comment ""))
+(import-raw-plug-in "${gimp_plug_in_dir}/plug-ins/file-raw-placeholder/file-raw-placeholder")
+(check-updates no)
+(check-update-timestamp 1759871981)
+(monitor-xresolution 129)
+(monitor-yresolution 129)
+(show-welcome-dialog no)
+(fill-options
+    (style fg-color)
+    (custom-style solid-color)
+    (antialias yes)
+    (feather no)
+    (feather-radius 10))
+(stroke-options
+    (style fg-color)
+    (custom-style solid-color)
+    (antialias yes)
+    (feather no)
+    (feather-radius 10)
+    (method line)
+    (width 6)
+    (unit pixels)
+    (cap-style butt)
+    (join-style miter)
+    (miter-limit 10)
+    (dash-offset 0)
+    (dash-info 0)
+    (emulate-brush-dynamics no))
+
+
+# end of gimprc

src_files/.config/gimp/shortcutsrc

@@ -0,0 +1,3 @@
+(file-version 1)
+(action "windows-hide-docks" "<Shift><Control>d")
+(action "view-zoom-fit-in" "<Shift><Control>f")

src_files/.config/gimp/tool-options/gimp-paintbrush-tool

@@ -0,0 +1,13 @@
+# GIMP gimp-paintbrush-tool options
+
+(background
+    (color "R'G'B'A float" 16 "\1\0\200\77\1\0\200\77\1\0\200\77\0\0\200\77" 0))
+(brush "2. Hardness 050")
+(dynamics "Pressure Opacity")
+(pattern "Pine")
+(gradient "FG to BG (RGB)")
+(palette "Color History")
+(brush-size 2.0)
+(brush-hardness 0.5)
+
+# end of gimp-paintbrush-tool options

src_files/.config/gimp/tool-options/gimp-pencil-tool

@@ -0,0 +1,13 @@
+# GIMP gimp-pencil-tool options
+
+(background
+    (color "R'G'B'A float" 16 "\1\0\200\77\1\0\200\77\1\0\200\77\0\0\200\77" 0))
+(brush "2. Hardness 050")
+(dynamics "Pressure Opacity")
+(pattern "Pine")
+(gradient "FG to BG (RGB)")
+(palette "Color History")
+(brush-size 2.0)
+(brush-hardness 0.5)
+
+# end of gimp-pencil-tool options

src_files/.config/git/ignore

@@ -2,8 +2,12 @@
 .tmux-session-hydrate
 zxcv*
 
-# cache/build/etc
+# compilation/debug/cache/build/etc
+**/build/
 **/__pycache__/
+*.o
+*.pch
+*.dSYM
 
 # lang/package
 mise*.toml

src_files/.config/nvim/init.lua

@@ -4,7 +4,7 @@ local csgAutocmd = vim.api.nvim_create_autocmd
 require("settings")
 require("plugin_manager")
 require("key_mappings")
-require("colorscheme_settings")
+require("theme")
 
 csgAutocmd({"BufWritePre"}, {
     group = csGroup,

src_files/.config/nvim/lua/colorscheme_settings.lua

@@ -1,17 +0,0 @@
-local defaultColorScheme = "tokyodark"
-
-function SetColorSchemeWrapper(scheme)
-  scheme = scheme or defaultColorScheme
-  vim.cmd.colorscheme(scheme)
-end
-
-SetColorSchemeWrapper(defaultColorScheme)
---
--- SetColorSchemeWrapper("tokyodark")
--- SetColorSchemeWrapper("tokyonight-night")
--- SetColorSchemeWrapper("bamboo-vulgaris")
--- SetColorSchemeWrapper("rose-pine-main")
--- SetColorSchemeWrapper("gruvbox")
--- SetColorSchemeWrapper("slate")
--- SetColorSchemeWrapper("sorbet")
-

src_files/.config/nvim/lua/key_mappings.lua

@@ -116,11 +116,11 @@ kmgAutocmd('LspAttach', {
 
 -- telescope
 local tscBuiltin = require('telescope.builtin')
-local custom_tscope_grep = function()
-    tscBuiltin.grep_string({ search = vim.fn.input("grep > ")})
+local custom_grep_str_w_regex = function()
+    tscBuiltin.grep_string({ search = vim.fn.input("grep > "), use_regex = true, additional_args = "-i", })
 end
 vim.keymap.set('n', '<leader>ft', tscBuiltin.live_grep, { desc = 'tscope find text, live_grep' })
-vim.keymap.set('n', '<leader>fT', custom_tscope_grep, { desc = 'tscope find text, custom grep' })
+vim.keymap.set('n', '<leader>fT', custom_grep_str_w_regex, { desc = 'tscope find text, static grep w/regex' })
 vim.keymap.set('n', '<leader>fg', tscBuiltin.git_files, { desc = 'tscope find git-tracked files' })
 vim.keymap.set('n', '<leader>ff', tscBuiltin.find_files, { desc = 'tscope find files' })
 vim.keymap.set('n', '<leader>fb', tscBuiltin.buffers, { desc = 'tscope buffers' })

src_files/.config/nvim/lua/plugin_manager.lua

@@ -22,8 +22,13 @@ vim.opt.rtp:prepend(path_lazy_nvim)
 
 require("lazy").setup({
     spec = {
-      { import = "plugins_lazy" },
+        { import = "plugins_lazy" },
     },
     checker = { enabled = false },
     change_detection = { notify = false },
+    dev = {
+        path = "~/dev/git/other/omarchy/plugins",
+        patterns = { 'LazyVim' },
+        fallback = false,
+    },
 })

src_files/.config/nvim/lua/plugins_lazy/telescope.lua

@@ -1,12 +1,3 @@
-local glob_patterns_find_files = {
-    "-g", "!**/.git/**",
-    "-g", "!**/build/**",
-    "-g", "!**/node_modules/**",
-}
-local glob_patterns_live_grep = {
-    unpack(glob_patterns_find_files), -- same for now
-}
-
 return {
     "nvim-telescope/telescope.nvim",
     tag = "0.1.8",
@@ -26,14 +17,18 @@ return {
         pickers = {
             find_files = {
                 find_command = {
-                    "rg", "--no-ignore", "--hidden", "--files",
-                    unpack(glob_patterns_find_files),
+                    "rg", "--hidden", "--files", -- "--no-ignore",
+                    "-g", "!**/.git/**",
+                    "-g", "!**/build/**",
+                    "-g", "!**/node_modules/**",
                 },
             },
             live_grep = {
                 additional_args = {
-                    "--no-ignore", "--hidden",
-                    unpack(glob_patterns_live_grep),
+                    "--hidden", "--no-binary", -- "--no-ignore",
+                    "-g", "!**/.git/**",
+                    "-g", "!**/build/**",
+                    "-g", "!**/node_modules/**",
                 }
             },
         },

src_files/.config/nvim/lua/theme.lua

@@ -0,0 +1,31 @@
+local defaultColorScheme = "tokyodark"
+-- local defaultColorScheme = "tokyonight-night"
+-- local defaultColorScheme = "bamboo-vulgaris"
+-- local defaultColorScheme = "rose-pine-main"
+-- local defaultColorScheme = "gruvbox"
+-- local defaultColorScheme = "slate"
+-- local defaultColorScheme = "sorbet"
+
+local ok, theme_specs = pcall(dofile, (os.getenv('DIR_CURRENT_THEME') or "") .. "/neovim.lua")
+if not ok then
+  vim.notify(
+    'current theme file not found, using default: ' .. defaultColorScheme,
+    vim.log.levels.INFO
+  )
+  vim.cmd.colorscheme(defaultColorScheme)
+  return
+end
+
+local first = theme_specs[1]
+local plugin_name = (type(first.name) == 'string' and first.name)
+  or (type(first[1]) == 'string' and first[1]:match('.*/(.*)'))
+  or 'plugin_name_not_found'
+
+local last = theme_specs[#theme_specs]
+local colorscheme = ((type(last.opts) == 'table' and type(last.opts.colorscheme) == 'string') and last.opts.colorscheme)
+  or plugin_name:gsub("%.%w+$", "")
+
+colorscheme = (colorscheme == 'plugin_name_not_found' and defaultColorScheme)
+  or colorscheme
+vim.cmd.colorscheme(colorscheme)
+

src_files/.config/obsidian/app.json

@@ -0,0 +1,18 @@
+{
+  "defaultViewMode": "preview",
+  "showLineNumber": true,
+  "spellcheck": false,
+  "autoPairBrackets": false,
+  "autoPairMarkdown": false,
+  "useTab": false,
+  "autoConvertHtml": true,
+  "vimMode": false,
+  "trashOption": "none",
+  "newFileLocation": "folder",
+  "newFileFolderPath": "inbox",
+  "showUnsupportedFiles": true,
+  "attachmentFolderPath": "inbox",
+  "showInlineTitle": false,
+  "readableLineLength": false,
+  "livePreview": false
+}

src_files/.config/obsidian/appearance.json

@@ -0,0 +1,5 @@
+{
+  "theme": "obsidian",
+  "accentColor": "#2f930e",
+  "baseFontSize": 18
+}

src_files/.config/obsidian/core-plugins.json

@@ -0,0 +1,33 @@
+{
+  "file-explorer": true,
+  "global-search": true,
+  "switcher": true,
+  "graph": true,
+  "backlink": true,
+  "canvas": true,
+  "outgoing-link": true,
+  "tag-pane": true,
+  "footnotes": false,
+  "properties": false,
+  "page-preview": true,
+  "daily-notes": true,
+  "templates": true,
+  "note-composer": true,
+  "command-palette": true,
+  "slash-command": false,
+  "editor-status": true,
+  "bookmarks": true,
+  "markdown-importer": false,
+  "zk-prefixer": false,
+  "random-note": false,
+  "outline": true,
+  "word-count": true,
+  "slides": false,
+  "audio-recorder": false,
+  "workspaces": false,
+  "file-recovery": true,
+  "publish": false,
+  "sync": false,
+  "bases": true,
+  "webviewer": false
+}

src_files/.config/obsidian/graph.json

@@ -0,0 +1,22 @@
+{
+  "collapse-filter": true,
+  "search": "",
+  "showTags": false,
+  "showAttachments": false,
+  "hideUnresolved": false,
+  "showOrphans": true,
+  "collapse-color-groups": true,
+  "colorGroups": [],
+  "collapse-display": true,
+  "showArrow": false,
+  "textFadeMultiplier": 0,
+  "nodeSizeMultiplier": 1,
+  "lineSizeMultiplier": 1,
+  "collapse-forces": true,
+  "centerStrength": 0.518713248970312,
+  "repelStrength": 10,
+  "linkStrength": 1,
+  "linkDistance": 250,
+  "scale": 1,
+  "close": false
+}

src_files/.config/obsidian/hotkeys.json

@@ -0,0 +1,18 @@
+{
+  "markdown:toggle-preview": [
+    {
+      "modifiers": [
+        "Alt"
+      ],
+      "key": "R"
+    }
+  ],
+  "switcher:open": [
+    {
+      "modifiers": [
+        "Ctrl"
+      ],
+      "key": "F"
+    }
+  ]
+}

src_files/.config/tmux/.tmux-session-hydrate-default

@@ -8,8 +8,8 @@ tmux_omitted_dirs=(
 [[ ! ${tmux_omitted_dirs[(re)$(pwd)]} ]] && {
     tmux new-window -d -n $EDITOR
     tmux send-keys -t :$EDITOR "$EDITOR ." c-M
-    tmux new-window -d -n debug
-    tmux new-window -d -n run
+    tmux new-window -d -n daa
+    tmux new-window -d -n procs
     tmux rename-window cmd
     tmux send-keys -t :cmd "clear; [[ -d .git ]] && git status" c-M
 }

src_files/.config/tmux/tmux.conf

@@ -25,10 +25,9 @@ bind -r l select-pane -R
 # reload tmux.conf
 bind-key r source-file "$XDG_CONFIG_HOME/tmux/tmux.conf" \; display-message "tmux.conf reloaded"
 
-# kill the current session
-# TODO: combine these into one command; must cover case when only 1 session remains
-bind-key q rename-session zzzz-temp-kill\; switch-client -p\; kill-session -t zzzz-temp-kill
-bind-key w kill-session
+# closing the current session
+bind-key q kill-session
+bind-key w run-shell "$DIR_SCRIPTS/tmux-session-close #{session_name}"
 
 # creating new windows
 bind-key n new-window

src_files/.config/zsh/.zprofile

@@ -1 +0,0 @@
-# source "$XDG_CONFIG_HOME/shell/profile" # TODO: where to put this?

src_files/.config/zsh/.zshenv

@@ -13,9 +13,10 @@ export DIR_NOTES="$DIR_HOME_BOX/notes"
 # util dirs; do not change without checking impact on xdg base dirs
 export DIR_LOCAL="$HOME/.local"
 export DIR_BIN="$DIR_LOCAL/bin"
-export DIR_BUILD="$DIR_LOCAL/build"
 export DIR_SCRIPTS="$DIR_LOCAL/scripts"
 export DIR_TMP="$DIR_LOCAL/tmp"
+export DIR_USER_OPT="$HOME/opt"
+export DIR_USER_LIB="$DIR_LOCAL/lib"
 
 # xdg base directory vars
 export XDG_CONFIG_HOME="$HOME/.config"
@@ -31,6 +32,14 @@ export ZDOTDIR="$XDG_CONFIG_HOME/zsh" # may already be set, set anyway
 # git
 export GIT_EDITOR="$EDITOR"
 
+# obsidian
+export OBSIDIAN_WORKSPACES_TO_CONFIGURE=("$DIR_NOTES")
+
+# reaper
+DIR_REAPER_PORTABLE_SHARED="$DIR_USER_OPT/reaper-portable/shared"
+DIR_REAPER_PORTABLE_LINUX="$DIR_USER_OPT/reaper-portable/linux"
+DIR_REAPER_PORTABLE_MACOS="$DIR_USER_OPT/reaper-portable/macos"
+
 # clean-up of home dir
 export __CF_USER_TEXT_ENCODING="0x0:0x0"
 

src_files/.config/zsh/.zshrc

@@ -29,7 +29,6 @@ alias journal="cd $DIR_HOME_BOX; $EDITOR .current-journal"
 alias ncspotkeys="$EDITOR $DIR_GIT_PROJECTS/other/ncspot/doc/users.md"
 
 # source extensions and system-specific files
-[[ -e "$HOME/.profile" ]] && source "$HOME/.profile" # TODO: do i want to source .profile?
 [[ -a "$ZDOTDIR/zsh-general-dev" ]] && source "$ZDOTDIR/zsh-general-dev"
 [[ -a "$ZDOTDIR/zsh-life-system" ]] && source "$ZDOTDIR/zsh-life-system"
 

src_files/.config/zsh/zsh-general-dev

@@ -10,6 +10,7 @@ alias login-aws-id-list="grep sso_account_id $HOME/.aws/config"
 alias gfo='git fetch origin'
 alias gfl='git fetch origin; git log'
 alias gpo='git pull origin'
+alias gppo='git push origin'
 alias gst='git status'
 alias git-push-to-temp='git branch -D temp; git checkout -b temp; git push origin temp -uf; git checkout -'
 alias gptemp='git-push-to-temp'

src_files/.local/bin/launch-gimp

@@ -0,0 +1,8 @@
+#!/bin/sh
+
+# for reference, default linux directory was in $XDG_CONFIG_HOME/GIMP/
+nohup \
+    env GIMP2_DIRECTORY=$XDG_CONFIG_HOME/gimp \
+    gimp \
+    > /dev/null 2>&1 \
+    &

src_files/.local/bin/launch-reaper

@@ -0,0 +1,23 @@
+#!/bin/sh
+
+# trying the "portable install" option; using this launch script to point to that
+source "$XDG_CONFIG_HOME/zsh/.zshenv"
+
+reaper_portable_exec_linux="$DIR_REAPER_PORTABLE_LINUX/REAPER/reaper"
+[[ ! -x "$reaper_portable_exec_linux" ]] && {
+    echo "reaper missing or not executable: $reaper_portable_exec_linux" >&2
+    exit 1
+}
+
+reaper_portable_config_linux="$DIR_REAPER_PORTABLE_LINUX/config"
+reaper_portable_ini_file_linux="$reaper_portable_config_linux/reaper.ini"
+[[ ! -r "$reaper_portable_ini_file_linux" ]] && {
+    [[ ! -d "$reaper_portable_config_linux" ]] && mkdir -p "$reaper_portable_config_linux"
+    touch "$reaper_portable_ini_file_linux"
+}
+
+nohup \
+    $reaper_portable_exec_linux \
+    -cfgfile $reaper_portable_ini_file_linux \
+    > /dev/null 2>&1 \
+    &

src_files/.local/bin/mvd

@@ -1,5 +1,6 @@
 #!/bin/zsh
 
+# wrapper for mv; for the given target, create any dirs which do not already exist
 mvd_target_dir=$(dirname "${@: -1}")
 [[ ! -d "$mvd_target_dir" ]] && mkdir -p "$mvd_target_dir"
 exec mv "$@"

src_files/.local/scripts/convert

@@ -0,0 +1,33 @@
+#! /bin/zsh
+
+# simple unit-conversion util, partly made for fun, not much here so far
+
+conversionUnits=$1
+inputsToConvert=($argv[2,-1])
+
+function cmToIn() {
+	result=$(( 1 / 2.54 * $1 ))
+	printf '%.1f cm => %.2f in\n' $1 $result
+}
+
+function inToCm() {
+	result=$(( 2.54 * $1 ))
+	printf '%.2f in => %.1f cm\n' $1 $result
+}
+
+function unsupportedUnits() {
+	echo "unsupported conversion units given: $conversionUnits"
+	exit 1
+}
+
+funcRef=exit # not sure what a good default function is, using exit
+case $conversionUnits in
+	(cm|cm-in) funcRef=cmToIn
+		;;
+	(in|in-cm) funcRef=inToCm
+		;;
+	(*) funcRef=unsupportedUnits
+		;;
+esac
+
+for i in $inputsToConvert; do $funcRef $i; done

src_files/.local/scripts/gfind

@@ -0,0 +1,14 @@
+#! /bin/zsh
+
+# simple wrapper to run both find and grep
+# usage: gfind <search-term> [search-directory]
+# if no search-directory given, uses . by default
+
+searchTerm=$1
+searchDirectory=$(if [[ -n $2 ]] then echo $2; else echo "."; fi)
+
+printf '//// find results for: %s in directory: %s\n' $searchTerm $searchDirectory
+find $searchDirectory -iname "*$searchTerm*"
+
+printf '\n//// grep results for: %s in directory: %s\n' $searchTerm $searchDirectory
+grep -rIi $searchTerm $searchDirectory

src_files/.local/scripts/tmux-session-close

@@ -0,0 +1,5 @@
+#!/bin/zsh
+
+tmux_existing_sessions=$(tmux list-sessions 2> /dev/null)
+[[ ${#tmux_existing_sessions[@]} -gt 1 ]] && $DIR_SCRIPTS/tmux-session-init hub
+tmux kill-session -t $1

src_files/.local/scripts/tmux-session-init

@@ -10,7 +10,7 @@ tmux_hydrate() {
     [[ -f $tmux_hydrate_path ]] && tmux send-keys -t $1 "source $tmux_hydrate_path" c-M
 }
 
-tmux_existing_sessions=$([[ -n $(pgrep tmux) ]] && tmux list-sessions || echo '')
+tmux_existing_sessions=$(tmux list-sessions 2> /dev/null || echo '')
 tmux_search_dirs=(
     $DIR_HOME_BOX
     $DIR_DEV

src_files/bin_overrides_macos/launch-gimp

@@ -0,0 +1,8 @@
+#!/bin/sh
+
+# for reference, default macos directory was in $HOME/Library/Application Support/GIMP/
+nohup \
+    env GIMP3_DIRECTORY="$XDG_CONFIG_HOME/gimp" \
+    /Applications/GIMP.app/Contents/MacOS/gimp \
+    > /dev/null 2>&1 \
+    &

src_files/bin_overrides_macos/launch-reaper

@@ -0,0 +1,18 @@
+#!/bin/sh
+
+# trying the "portable install" option; using this launch script to point to that
+source "$XDG_CONFIG_HOME/zsh/.zshenv"
+
+reaper_portable_exec_macos="$DIR_REAPER_PORTABLE_MACOS/REAPER.app/Contents/MacOS/REAPER"
+[[ ! -x "$reaper_portable_exec_macos" ]] && {
+    echo "reaper missing or not executable: $reaper_portable_exec_macos" >&2
+    exit 1
+}
+
+reaper_portable_ini_file_macos="$DIR_REAPER_PORTABLE_MACOS/reaper.ini"
+[[ ! -r "$reaper_portable_ini_file_macos" ]] && touch "$reaper_portable_ini_file_macos"
+
+nohup \
+    $reaper_portable_exec_macos \
+    > /dev/null 2>&1 \
+    &

src_files/executable_wrappers_macos/gimp

@@ -1,3 +0,0 @@
-#!/bin/sh
-
-/Applications/GIMP.app/Contents/MacOS/gimp

theme-switcher-testing/neovim-all.lua

@@ -0,0 +1,68 @@
+return {
+    {
+        "ellisonleao/gruvbox.nvim",
+        name = "gruvbox",
+        -- lazy = false,
+        -- priority = 1000,
+        opts = {
+            terminal_colors = true, -- add neovim terminal colors
+            undercurl = true,
+            underline = true,
+            bold = true,
+            italic = {
+                strings = true,
+                emphasis = true,
+                comments = true,
+                operators = false,
+                folds = true,
+            },
+            strikethrough = true,
+            invert_selection = false,
+            invert_signs = false,
+            invert_tabline = false,
+            inverse = true, -- invert background for search, diffs, statuslines and errors
+            contrast = "", -- "hard", "soft", or ""
+            palette_overrides = {},
+            overrides = {},
+            dim_inactive = false,
+            transparent_mode = false,
+        },
+    },
+    {
+        "folke/tokyonight.nvim",
+        lazy = false,
+        priority = 1000,
+        opts = {
+            style = "night", -- "night", "storm", "moon", "day"
+            styles = {
+                functions = {} -- disable italic for functions
+            },
+            on_colors = function(colors)
+                colors.hint = colors.orange
+                colors.error = "#ff0000"
+                colors.fg_gutter = "#9098B8"
+            end,
+        },
+    },
+    {
+        "tiagovla/tokyodark.nvim",
+        lazy = false,
+        priority = 1000,
+        opts = {
+            custom_highlights = function(highlights, _palette)
+                highlights.Comment['fg'] = "#8a9097"
+                highlights.LineNr['fg'] = "#8088A8"
+                return highlights
+            end,
+        },
+    },
+    {
+        'ribru17/bamboo.nvim',
+        -- lazy = false,
+        -- priority = 1000,
+        config = function()
+            require('bamboo').setup { }
+            require('bamboo').load()
+        end,
+    },
+}

theme-switcher-testing/neovim-bamboo.lua

@@ -0,0 +1,11 @@
+return {
+        {
+        'ribru17/bamboo.nvim',
+        -- lazy = false,
+        -- priority = 1000,
+        config = function()
+            require('bamboo').setup { }
+            require('bamboo').load()
+        end,
+    },
+}

theme-switcher-testing/neovim-catppuccin.lua

@@ -0,0 +1,19 @@
+return {
+	{
+		"catppuccin/nvim",
+		name = "catppuccin",
+		priority = 1000,
+		config = function()
+			require("catppuccin").setup({
+				flavour = "latte", -- other options: "mocha", "frappe", "macchiato"
+			})
+			vim.cmd.colorscheme("catppuccin-latte")
+		end,
+	},
+	{
+		"LazyVim/LazyVim",
+		opts = {
+			colorscheme = "catppuccin-latte",
+		},
+	},
+}

theme-switcher-testing/neovim-everforest.lua

@@ -0,0 +1,15 @@
+return {
+	{
+        "neanias/everforest-nvim",
+		opts = {
+			background = "soft",
+		},
+    },
+	{
+		"LazyVim/LazyVim",
+		opts = {
+			colorscheme = "everforest",
+			background = "soft",
+		},
+	},
+}

theme-switcher-testing/neovim-gruvbox.lua

@@ -0,0 +1,31 @@
+return {
+    {
+        "ellisonleao/gruvbox.nvim",
+        name = "gruvbox",
+        -- lazy = false,
+        -- priority = 1000,
+        opts = {
+            terminal_colors = true, -- add neovim terminal colors
+            undercurl = true,
+            underline = true,
+            bold = true,
+            italic = {
+                strings = true,
+                emphasis = true,
+                comments = true,
+                operators = false,
+                folds = true,
+            },
+            strikethrough = true,
+            invert_selection = false,
+            invert_signs = false,
+            invert_tabline = false,
+            inverse = true, -- invert background for search, diffs, statuslines and errors
+            contrast = "", -- "hard", "soft", or ""
+            palette_overrides = {},
+            overrides = {},
+            dim_inactive = false,
+            transparent_mode = false,
+        },
+    },
+}

theme-switcher-testing/neovim-matteblack.lua

@@ -0,0 +1,9 @@
+return {
+  { "tahayvr/matteblack.nvim", lazy = false, priority = 1000 },
+  {
+		"LazyVim/LazyVim",
+		opts = {
+			colorscheme = "matteblack",
+		},
+	},
+}

theme-switcher-testing/neovim-nordfox.lua

@@ -0,0 +1,9 @@
+return {
+	{ "EdenEast/nightfox.nvim" },
+	{
+		"LazyVim/LazyVim",
+		opts = {
+			colorscheme = "nordfox",
+		},
+	},
+}

theme-switcher-testing/neovim-tokyodark.lua

@@ -0,0 +1,14 @@
+return {
+    {
+        "tiagovla/tokyodark.nvim",
+        lazy = false,
+        priority = 1000,
+        opts = {
+            custom_highlights = function(highlights, _palette)
+                highlights.Comment['fg'] = "#8a9097"
+                highlights.LineNr['fg'] = "#8088A8"
+                return highlights
+            end,
+        },
+    },
+}

theme-switcher-testing/neovim-tokyonight.lua

@@ -0,0 +1,18 @@
+return {
+    {
+        "folke/tokyonight.nvim",
+        lazy = false,
+        priority = 1000,
+        opts = {
+            style = "night", -- "night", "storm", "moon", "day"
+            styles = {
+                functions = {} -- disable italic for functions
+            },
+            on_colors = function(colors)
+                colors.hint = colors.orange
+                colors.error = "#ff0000"
+                colors.fg_gutter = "#9098B8"
+            end,
+        },
+    },
+}

theme-switcher-testing/neovim.lua

@@ -0,0 +1,14 @@
+return {
+    {
+        "tiagovla/tokyodark.nvim",
+        lazy = false,
+        priority = 1000,
+        opts = {
+            custom_highlights = function(highlights, _palette)
+                highlights.Comment['fg'] = "#8a9097"
+                highlights.LineNr['fg'] = "#8088A8"
+                return highlights
+            end,
+        },
+    },
+}

theme-switcher-testing/plugins/LazyVim/lua/LazyVim/init.lua

@@ -0,0 +1,8 @@
+local M = {}
+
+M.opts = {}
+
+function M.setup(opts)
+end
+
+return M

theme-switcher-testing/zxcv.sh

@@ -0,0 +1,86 @@
+#!/bin/bash
+
+# OMARCHY_CURRENT_THEME_NEOVIM="~/.config/omarchy/current/theme/neovim.lua"
+OMARCHY_CURRENT_THEME_NEOVIM="./neovim.lua"
+
+if [[ ! -f "$OMARCHY_CURRENT_THEME_NEOVIM" ]]; then
+  echo "neovim theme not found for live update: $OMARCHY_CURRENT_THEME_NEOVIM" >&2
+  exit 1
+fi
+
+read -r plugin_name colorscheme_name <<< "$(
+nvim -l <(cat << NESTED_LUA_BLOCK
+local ok, plugins = pcall(dofile, '${OMARCHY_CURRENT_THEME_NEOVIM}')
+if not ok then
+  print('ERROR: could not load neovim theme file for live update')
+  os.exit(1)
+end
+
+local first = plugins[1]
+local plugin_name = (type(first.name) == 'string' and first.name)
+  or (type(first[1]) == 'string' and first[1]:match('.*/(.*)'))
+  or 'plugin_name_not_found'
+
+if plugin_name == 'plugin_name_not_found' then
+  print('ERROR: could not detect neovim theme plugin for live update')
+  os.exit(1)
+end
+
+local last = plugins[#plugins]
+local colorscheme = ((type(last.opts) == 'table' and type(last.opts.colorscheme) == 'string') and last.opts.colorscheme)
+  or plugin_name:gsub("%.%w+$", "")
+
+vim.print(plugin_name .. " " .. colorscheme)
+NESTED_LUA_BLOCK
+) > /dev/stdout 2>&1 | tr -d '\r'
+)"
+
+nvim --headless +"lua require(\"lazy\").install({ show = false, wait = true })" +q > /dev/null 2>&1
+
+nvim_stdpath_run=$(dirname $(nvim -l <(echo "vim.cmd.echo('stdpath(\"run\")')") > /dev/stdout 2>&1))
+find "$nvim_stdpath_run" -type s -name "nvim*" 2> /dev/null |
+while IFS= read -r nvim_server; do
+    # echo "running for $nvim_server"
+    timeout 2s nvim --server "$nvim_server" \
+        --remote-expr "execute('lua require(\"lazy\").install({ show = false, wait = true })')" \
+        > /dev/null 2>&1
+    timeout 4s nvim --server "$nvim_server" \
+        --remote-expr "execute('lua require(\"lazy\").load({ show = false, wait = true, plugins = { \"$plugin_name\" } })')" \
+        > /dev/null 2>&1
+    timeout 2s nvim --server "$nvim_server" \
+        --remote-expr "execute('colorscheme $colorscheme_name')" \
+        > /dev/null 2>&1
+    # echo "finished for $nvim_server"
+done
+
+##########################################################################################
+
+# ln -snf ~/dev/git/other/omarchy/neovim.lua ~/.config/nvim/lua/plugins_lazy/colorschemes.lua
+# ref only
+# lua require("lazy").install({ show = false, wait = true })
+# lua require("lazy").load({ show = false, wait = true, plugins = { "nightfox.nvim" } })
+# lua require("lazy").build({ show = false, wait = true, plugins = { name = "tokyonight.nvim" } })
+# lua require("lazy").reload({ show = false, wait = true, plugins = { name = "tokyonight.nvim" } })
+
+# get neovim theme file, parse as lua? load the tables and get first value in each, as well as a name if one is set
+# if name is set, that is plugin name which lazy.nvim knows, if not, then take the value after the / in the git repo name
+
+# also, in the final table, parse out the colorscheme value, that is what needs to be passed to my loop below
+# if none is present, then default to the plugin name from above, but trim off any .suffix like .nvim
+
+# # nvim_sockets=$(find /var/folders -type s -user "$USERNAME" -name "nvim*" -path "*nvim.$USERNAME*" 2> /dev/null)
+# nvim_sockets=$(find /var/folders -type s -name "nvim*" -path "*nvim.*" 2> /dev/null)
+# # for s in "${nvim_sockets[@]}"; do
+# for s in $nvim_sockets; do
+#     echo "will run for $s"
+#     # nvim --server "$s" --remote-expr "execute('colorscheme $1')"
+# done
+
+# find /var/folders -type s -name "nvim*" -path "*nvim.*" 2> /dev/null | while IFS= read -r server; do
+
+# nvim -l <(echo "vim.cmd.echo('stdpath(\"run\")')") > /dev/stdout 2>&1 |
+#     dirname $@ |
+#     find $@ -type s -name "nvim*" 2> /dev/null |
+#     while IFS= read -r server; do
+#         timeout 0.5s nvim --server "$server" --remote-expr "execute('colorscheme $1')" > /dev/null 2>&1
+#     done