File: ctop.sh
   1 #!/bin/sh
   2 
   3 # The MIT License (MIT)
   4 #
   5 # Copyright (c) 2026 pacman64
   6 #
   7 # Permission is hereby granted, free of charge, to any person obtaining a copy
   8 # of this software and associated documentation files (the "Software"), to deal
   9 # in the Software without restriction, including without limitation the rights
  10 # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
  11 # copies of the Software, and to permit persons to whom the Software is
  12 # furnished to do so, subject to the following conditions:
  13 #
  14 # The above copyright notice and this permission notice shall be included in
  15 # all copies or substantial portions of the Software.
  16 #
  17 # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
  18 # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
  19 # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
  20 # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
  21 # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
  22 # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
  23 # SOFTWARE.
  24 
  25 
  26 # ctop [seconds...] [options...]
  27 #
  28 #
  29 # Clean TOP runs `top` using better default settings, and offers easier-to-use
  30 # command-line options. Updates happen every 2 seconds by default, unless you
  31 # change it by giving an argument which looks like a number, with or without
  32 # decimals.
  33 #
  34 # The name comes from the fact that regular `top` shows some output when quit,
  35 # while this wrapper tool doesn't.
  36 #
  37 # As when running `top` directly, pressing `q` quits, while pressing `h` shows
  38 # the help screen, which you also quit by pressing `q` while in it. You can
  39 # also force-quit this tool by pressing Ctrl+C.
  40 #
  41 # The options are, available both in single and double-dash versions
  42 #
  43 #   -cpu    reverse-sort entries by latest sampled CPU use
  44 #
  45 #   -h, -help      show this help message
  46 #   -id, -pid      sort entries by PID
  47 #   -m, -mem, -res, -rss
  48 #                  reverse-sort entries by latest sampled RSS/RES (memory) use
  49 #   -sh, -shr      reverse-sort entries by latest sampled shared memory use
  50 #   -time          reverse-sort entries by running time
  51 #   -usr, -user    sort entries by user
  52 #   -vir, -virt    reverse-sort entries by latest sampled VIRTual memory use
  53 
  54 
  55 case "$1" in
  56     -h|--h|-help|--help)
  57         awk '/^# +ctop /, /^$/ { gsub(/^# ?/, ""); print }' "$0"
  58         exit 0
  59     ;;
  60 esac
  61 
  62 cmd='top'
  63 sort=''
  64 seconds=2
  65 number_regex='^(\.[0-9]+|[1-9]+(\.[0-9]+)?)$'
  66 
  67 for arg in "$@"; do
  68     if [ "${arg}" = '--' ]; then
  69         break
  70     fi
  71 
  72     case "${arg}" in
  73         -cpu|--cpu) sort="-o %CPU";;
  74         -id|--id|-pid|--pid) sort="-o PID";;
  75         -m|--m|-mem|--mem|-res|--res|-rss|--rss) sort="-o RES";;
  76         -sh|--sh|-shr|--shr) sort="-o SHR";;
  77         -t|--t|-time|--time|-time+|--time+) sort="-o TIME+";;
  78         -usr|--usr|-user|--user) sort="-o USER";;
  79         -vir|--vir|-virt|--virt) sort="-o VIRT";;
  80         *)
  81             if echo "${arg}" | grep -E -q "${number_regex}"; then
  82                 seconds="${arg}"
  83             else
  84                 cmd="${cmd} ${arg}"
  85             fi
  86         ;;
  87     esac
  88 done
  89 
  90 # restore previous screen contents when sent an INT signal, which usually
  91 # happens by pressing Ctrl+C
  92 trap 'tput -T xterm rmcup; exit 130' INT
  93 
  94 tput -T xterm smcup
  95 ${cmd} -d "${seconds}" ${sort}
  96 code=$?
  97 tput -T xterm rmcup
  98 exit "${code}"