user/gthumb/keep.org

   1 #+AUTHOR: Steven Baltakatei Sandoval
   2 #+DATE: 2026-06-16
   3 #+TITLE: keep
   4
   5 ** Summary
   6 This command moves a single selected file ~dir1/file123.ext~ to be
   7 kept in a ~keep/~ directory along with any adjacent files that share
   8 the same stem located within the same directory
   9 (e.g. ~dir1/file123.*~). Also moved are matching files in directories
  10 neighboring the originalʼs parent directory (e.g. ~dir2/file123.*~).
  11 The destination trash directory is ~keep~; parent directories ~JPG/~
  12 and ~ARW/~ (e.g. ~dir1~, ~dir2~) are preserved within ~keep/~.
  13
  14 ** Stats
  15 Version: 0.0.2
  16 License: GPLv3+
  17 gThumb version: ~3.12.6~
  18 Suggested keyboard shortcut: ~Shift + K~
  19
  20 ** Usage
  21 *keep* is useful for pruning photos with multiple format extensions
  22 with each extension type in a separate directory.  For example, letʼs
  23 say a ~JPG/~ directory contains ~JPG/DSC01001.JPG~,
  24 ~JPG/DSC01001.JPG.ots~ and a ~ARW/~ directory contains
  25 ~ARW/DSC01001.ARW~. With ~JPG/DSC01001.JPG~ selected in gThumb, a
  26 ~keep~ directory is created next to ~JPG/~ and ~ARW/~. Then, the
  27 following moves are performed:
  28
  29 - ~JPG/DSC01001.JPG~ is moved to ~keep/JPG/DSC01001.JPG~
  30 - ~JPG/DSC01001.JPG.ots~ is moved to ~keep/JPG/DSC01001.JPG.ots~
  31 - ~ARW/DSC01001.ARW~ is moved to ~keep/ARW/DSC01001.ARW~
  32
  33 Thus, by browsing ~JPG/~ in gThumb and performing *keep* on defsired
  34 photos, related photos from not only ~JPG/~, ~ARW/~ and
  35 other similar directories are moved for preservation in ~keep/~.
  36
  37 Then, it is upon the user to archive the contents of ~keep/~ to.
  38
  39 ** Code
  40 Paste the code below into the ~Command~ field of the ~Edit Command~
  41 window under 🔧 → Personalize… .
  42
  43 Line-by-line view:
  44 #+BEGIN_EXAMPLE
  45 # keep v0.0.2
  46 fdebug=/tmp/gtlogkeep.txt;
  47 f=%F;
  48 fBase="$(basename "$f")";
  49 fne="${fBase%.*}";
  50 dppar="$(dirname %P)";
  51 dKeep="${dppar}/keep";
  52 printf "DEBUG:fdebug:%s\n" "$fdebug" 1>>"$fdebug" 2>&1;
  53 printf "DEBUG:f:%s\n" "$f" 1>>"$fdebug" 2>&1;
  54 printf "DEBUG:fBase:%s\n" "$fBase" 1>>"$fdebug" 2>&1;
  55 printf "DEBUG:fne:%s\n" "$fne" 1>>"$fdebug" 2>&1;
  56 printf "DEBUG:dppar:%s\n" "$dppar" 1>>"$fdebug" 2>&1;
  57 printf "DEBUG:dKeep:%s\n" "$dKeep" 1>>"$fdebug" 2>&1;
  58 for fsrc in "${dppar}"/*/"${fne}".*; do
  59   if [ ! -e "$fsrc" ]; then continue; fi;
  60   sdname="$(basename "$(dirname "$fsrc")" )";
  61   ddest="${dKeep}/${sdname}";
  62   printf "DEBUG:fsrc:%s\n" "$fsrc";
  63   printf "DEBUG:sdname:%s\n" "$sdname";
  64   printf "DEBUG:ddest:%s\n" "$ddest";
  65   echo "foo" 1>>"$fdebug" 2>&1;
  66   if [ ! -d "$ddest" ]; then
  67     printf "DEBUG:Destination dir does not exist. Creating:%s\n" "$ddest";
  68     mkdir -p "$ddest";
  69   else
  70     printf "DEBUG:Destination dir exists:%s\n" "$ddest";
  71   fi;
  72   printf "STATUS: Moving %s → %s\n" "$fsrc" "$ddest/";
  73   mv -n "$fsrc" "$ddest/";
  74 done 1>>"$fdebug" 2>&1;
  75 sleep 1;
  76 #+END_EXAMPLE