CatBox - A implementation of CatBox.moe API in Bash

catbox

#!/bin/bash
#
# Catbox v1.5
# A implelemtation of CatBox.moe API in Bash
# Author: MineBartekSA
# Gist: https://gist.github.com/MineBartekSA/1d42d6973ddafb82793fd49b4fb06591
#
# MIT License
#
# Copyright (c) 2023 Bartłomiej Skoczeń
#
# Permission is hereby granted, free of charge, to any person obtaining a copy
# of this software and associated documentation files (the "Software"), to deal
# in the Software without restriction, including without limitation the rights
# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
# copies of the Software, and to permit persons to whom the Software is
# furnished to do so, subject to the following conditions:
#
# The above copyright notice and this permission notice shall be included in all
# copies or substantial portions of the Software.
#
# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
# SOFTWARE.
#

curl --version >> /dev/null
if [ $? -ne 0 ]
then
  echo -e "\e[91mcURL not found!\e[0m"
  echo "Please check if you have installed cURL on your system"
  exit 1
fi

usage()
{
  if [ -z $1 ] || [ $1 == "version" ]
  then
    echo -e "\e[1mCatBox\e[0m v1.5"
    if ! [ -z $1 ]; then exit; fi
    echo "A CatBox.moe API implementation in Bash" 
    echo ""
  elif [ $1 != "\r" ]
  then
    echo -e $1
  fi
  echo -e "Usage: catbox <command> [arguments]\n"
  echo "Commands:"
  echo "   user [userhash]            - Gets or sets current userhash. If you pass 'off' then it will make you anonymous"
  echo "   file <filename(s)>         - Uploads files to catbox.moe"
  echo "   temp <filename(s)>         - Uploads files to litterbox.catbox.moe"
  echo "   url <url(s)>               - Uploads files from URLs to catbox.moe"
  echo "   delete <filenames(s)>      - Deletes files from catbox.moe. Requires userhash"
  echo "   album                      - Album Managment"
  echo "   usage, --usage, -h, --help - Prints this message"
  echo "   version, -v, --version     - Prints version"
}

getHash()
{
  while read p
  do
    if [ ${p:0:1} != "#" ]
    then
      echo $p
    fi
  done < "$HOME/.catbox"
}

checkUH()
{
  if ! [ -f "$HOME/.catbox" ]
  then
    echo -e "\e[91mNo userhash set! $1\e[0m"
    echo "Use 'catbox user <hash>' first then try again!"
    exit 1
  fi
}

CATBOX_HOST="https://catbox.moe/user/api.php"
LITTER_HOST="https://litterbox.catbox.moe/resources/internals/api.php"

if [ $# -eq 0 ]
then usage
elif [ $1 == "usage" ] || [ $1 == "--usage" ] || [ $1 == "-h" ] || [ $1 == "--help" ]
then usage
elif [ $1 == "version" ] || [ $1 == "-v" ] || [ $1 == "--version" ]
then
  usage "version"
elif [ $1 == "user" ]
then
  # User Command
  
  if [ -z $2 ]
  then
    if [ -f "$HOME/.catbox" ]
    then
      echo "Your current userhash is: $(getHash)"
    else
      echo "No userhash is currently set, so you are anonymous"
    fi
  else
    if [ $2 != "off" ]
    then
      echo -e "#CatBox.moe userhash file\n$2" > "$HOME/.catbox"
      echo "Userhash $2 set in $HOME/.catbox"
    else
      rm "$HOME/.catbox"
      echo "You are now Anonymous!"
    fi
  fi
elif [ $1 == "file" ]
then
  # File Commmand

  if [ $# -eq 1 ]
  then
    echo "Usage: catbox file <filename> [<filename>...] - Uploads files to CatBox.moe"
    exit 1
  fi

  if [ -f "$HOME/.catbox" ]
  then
    echo "Uploading with userhash..."
    one=0
    for file in "$@"
    do
      if [ $one -ne 1 ]; then one=1; continue; fi
      if [ -f "$file" ] || [ -L "$file" ]
      then
        name=$(basename -- "$file")
        echo -en "\e[1m$name\e[0m:\n"
        link=`curl -F "reqtype=fileupload" -F "userhash=$(getHash)" -F "fileToUpload=@$file" $CATBOX_HOST`
        echo -en "\n"
        echo -en "Uploaded to: \e[1m$link\n"
        echo -n $link|xclip -selection clipboard
      else
        echo -e "\e[91mFile $file dose not exists!\e[0m"
      fi
    done
  else
    echo "Uploading anonymously..."
    one=0
    for file in "$@"
    do
      if [ $one -ne 1 ]; then one=1; continue; fi
      if [ -f "$file" ] || [ -L "$file" ]
      then
        name=$(basename -- "$file")
        echo -en "\e[1m$name\e[0m:\n"
        link=`curl -F "reqtype=fileupload" -F "fileToUpload=@$file" $CATBOX_HOST`
        echo -en "\n"
        echo -en "Uploaded to: \e[1m$link\n"
        echo -n $link|xclip -selection clipboard
      else
        echo -e "\e[91mFile $file dose not exists!\e[0m"
      fi
    done
  fi
elif [ $1 == "temp" ] 
then
  # Litterbox upload

  if [ $# -lt 2 ]
  then
      echo "Usage: catbox temp <filename> [<filename>...] [1h/12h/24h/72h] - Uploads files to LitterBox.CatBox.moe"
      echo "Only the given expiry times are supported"
      echo "By default, temporary files will expire after an hour"
      exit 1;
  fi
  [[ ${*: -1:1} == @(1|12|24|72)h ]] && time=${*: -1:1} && end=-1 || time=1h || end=0
  one=0
  for file in "${@:1:$#$end}"
  do
    if [ $one -ne 1 ]; then one=1; continue; fi
    if [ -f "$file" ] || [ -L "$file" ]
    then
      name=$(basename -- "$file")
      echo -en "\e[1m$name\e[0m:\n"
      link=`curl -F "reqtype=fileupload" -F "time=$time" -F "fileToUpload=@$file" $LITTER_HOST`
      echo -en "\n"
      echo -en "Uploaded to: \e[1m$link\n"
      echo -n $link|xclip -selection clipboard
    else
      echo -e "\e[91mFile $file dose not exists!\e[0m"
    fi
  done
elif [ $1 == "url" ]
then
  # Url Command

  if [ $# -eq 1 ]
  then
    echo "Usage: catbox url <url> [<url>...] - Uploads files from urls to CatBox.moe"
    exit 1
  fi

  if [ -f "$HOME/.catbox" ]
  then
    echo "Uploading with userhash..."
    one=0
    for url in "$@"
    do
      if [ $one -ne 1 ]; then one=1; continue; fi
      echo -en "\e[1m$url\e[0m: "
      link=`curl -F "reqtype=urlupload" -F "userhash=$(getHash)" -F "url=$url" $CATBOX_HOST`
      echo -en "\n"
      echo -en "Uploaded to: \e[1m$link\n"
      echo -n $link|xclip -selection clipboard
    done
  else
    echo "Uploading anonymously..."
    one=0
    for url in "$@"
    do
      if [ $one -ne 1 ]; then one=1; continue; fi
      echo -en "\e[1m$url\e[0m: "
      link=`curl -F "reqtype=urlupload" -F "url=$url" $CATBOX_HOST`
      echo -en "\n"
      echo -en "Uploaded to: \e[1m$link\n"
      echo -n $link|xclip -selection clipboard
    done
  fi
elif [ $1 == "delete" ]
then
  # Delete Command

  if [ $# -eq 1 ]
  then
    echo "Usage: catbox delete <filename> [<filename>...] - Deletes files from your CatBox.moe account"
    exit 1
  fi

  checkUH "Can't delete files!"

  echo "Deleting..."
  one=0
  files=""
  for file in "$@"
  do
    if [ $one -ne 1 ]; then one=1; continue; fi 
    echo -en "\e[1m$file\e[0m: "
    curl -F "reqtype=deletefiles" -F "userhash=$(getHash)" -F "files=$file" $CATBOX_HOST
    echo -en "\n"
  done 
  echo "Finished deleting files!"
elif [ $1 == "album" ]
then
  #Album Managment

  if [ $# -eq 1 ]
  then
    echo -e "Usage: catbox album <command> [arguments]\n"
    echo "Every command here needs userhash so be sure you haveset it up!"
    echo -e "\e[1;93mRemeber that every title or discription must written in \"\" if you want to write more than one word!\e[0m\n"
    echo "Commands:"
    echo "   create <title> <description> <file(s)>       - Create album"
    echo "   edit <short> <title> <description> [file(s)] - Edit album"
    echo "   add <short> <file(s)>                        - Add files to album"
    echo "   remove <short> <file(s)>                     - Remove files from album"
    echo "   delete <short>                               - Delete album"
    exit 1
  fi

  if [ $2 == "create" ]
  then
    if [ $# -lt 5 ]
    then
      echo "Usage: catbox album create <title> <description> <filename> [<filename> ...] - Careates an album with given title, discription and files"
      echo -e "\e[1;93mRemeber that every title or discription must written in \"\" if you want to write more than one word!\e[0m"
      exit 1
    fi
    checkUH "Can't create album!"

    echo "Creating Album..."
    echo "Title: $3"
    echo "Description: $4"
    echo -en "Files: "

    one=0
    files=""
    for file in "$@"
    do
      if [ $one -ne 4 ]; then one=$[$one+1]; continue; fi
      if [ "$files" == "" ]
      then
        files=$file
      else
        files=$files" "$file
      fi
      echo -en $file
    done
    echo -en "\n"

    album=$(curl -F "reqtype=createalbum" -F "userhash=$(getHash)" -F "title=$3" -F "desc=$4" -F "files=$files" -# $CATBOX_HOST)
    echo "Album short: ${album/"https://catbox.moe/c/"/""}"
    echo "Album url: $album"
    echo "Album creation successfull!"

  elif [ $2 == "edit" ]
  then
    if [ $# -lt 5 ]
    then
      echo "Usage: catbox album edit <short> <title> <description> [<filename> ...] - Edites album"
      echo -e "\e[1;93mRemeber that every title or discription must written in \"\" if you want to write more than one word!"
      echo -e "You don't have to give filenames but if you don't give any will render the album empty!\e[0m"
      exit 1
    fi
    checkUH "Can't edit album!"

    echo "Editing Album..."
    echo "Album Short: $3"
    echo "Title: $4"
    echo "Description: $5"
    echo -en "Files: "

    one=0
    files=""
    for file in "$@"
    do
      if [ $one -ne 5 ]; then one=$[$one+1]; continue; fi
      if [ "$files" == "" ]
      then
        files=$file
      else
        files=$files" "$file
      fi
      echo -en $file
    done
    echo -en "\n"

    curl -F "reqtype=editalbum" -F "userhash=$(getHash)" -F "short=$3" -F "title=$4" -F "desc=$5" -F "files=$files" -# $CATBOX_HOST
    echo -e "\nAlbum edition successfull!"

  elif [ $2 == "add" ]
  then
    if [ $# -lt 4 ]
    then
      echo "Usage: catbox album add <short> <filename> [<filename> ...] - Adds files to the specific album"
      exit 1
    fi
    checkUH "Can't add files to album!"

    echo -en "Files: "

    one=0
    files=""
    for file in "$@"
    do
      if [ $one -ne 3 ]; then one=$[$one+1]; continue; fi
      if [ "$files" == "" ]
      then
        files=$file
      else
        files=$files" "$file
      fi
      echo -en $file
    done
    echo -en "\n"

    curl -F "reqtype=addtoalbum" -F "userhash=$(getHash)" -F "short=$3" -F "files=$files" $CATBOX_HOST
    echo -e "\nAddition complete!"

  elif [ $2 == "remove" ]
  then
    if [ $# -lt 4 ]
    then
      echo "Usage: catbox album remove <short> <filename> [<filename> ...] - Removes files from the specific album"
      exit 1
    fi
    checkUH "Can't remove files from album!"    

    echo -en "Files: "

    one=0
    files=""
    for file in "$@"
    do
      if [ $one -ne 3 ]; then one=$[$one+1]; continue; fi
      if [ "$files" == "" ]
      then
        files=$file
      else
        files=$files" "$file
      fi
      echo -en $file
    done
    echo -en "\n"

    curl -F "reqtype=removefromalbum" -F "userhash=$(getHash)" -F "short=$3" -F "files=$files" $CATBOX_HOST
    echo -e "\nRemoval complete!"

  elif [ $2 == "delete" ]
  then
    if [ $# -lt 3 ]
    then
      echo "Usage: catbox album delete <short> [<short> ...] - Deletes album"
      exit 1
    fi
    checkUH "Can't delete album!"

    one=0
    for short in $@
    do
      if [ $one -ne 2 ]; then one=$[$one+1]; continue; fi
      echo -en "\e[1m$short\e[0m: "
      curl -F "reqtype=deletealbum" -F "userhash=$(getHash)" -F "short=$short" $CATBOX_HOST >> /dev/null
      echo -en "Done!\n"
    done
    echo "Album deletion completed!"
  fi
else
  usage
fi

to copy the output to clipboard automatically, i change the line 128 into this

        link=`curl -F "reqtype=fileupload" -F "fileToUpload=@$file" $HOST`
        echo "Uploaded: $link"
        echo -n $link|xclip -selection clipboard

@KebabLord Thanks for your comment! I've added this to the script so you don't have to modify it again!

breaks when sending files with whitespaces in the name:

catbox file '20191007_171102_bez plamy.JPG'
Uploading anonymously...
/home/carbolymer/.local/bin/catbox: line 126: [: 20191007_171102_bez: binary operator expected

@carbolymer Thanks for your comment! This issue is now fixed!

I've added support for symlinks:

--- a/catbox
+++ b/catbox
@@ -106,7 +106,7 @@ then
     for file in "$@"
     do
       if [ $one -ne 1 ]; then one=1; continue; fi
-      if [ -f "$file" ]
+      if [ -f "$file" ] || [ -L "$file" ]
       then
         name=$(basename -- "$file")
         echo -en "\e[1m$name\e[0m:\n"
@@ -124,7 +124,7 @@ then
     for file in "$@"
     do
       if [ $one -ne 1 ]; then one=1; continue; fi
-      if [ -f "$file" ]
+      if [ -f "$file" ] || [ -L "$file" ]
       then
         name=$(basename -- "$file")
         echo -en "\e[1m$name\e[0m:\n"

so it's possible to run echo "foo" | catbox file /dev/stdin

@carbolymer Thanks again for your comment! This feature is now in the gist as well!

@MineBartekSA i've submitted this script to the aur under this repo https://aur.archlinux.org/packages/catbox-bash, if this is an issue for you, let me know and i'll delete it

@alsoGAMER Thank you very much for submitting my little script to the AUR.

Added support for litterbox.catbox.moe (Temp files)

--- a/catbox
+++ b/catbox
@@ -30,6 +30,7 @@
   echo "Commands:"
   echo "   user [userhash]            - Gets or sets current userhash. If you pass 'off' then it will make you anonymous"
   echo "   file <filename(s)>         - Uploads files to catbox.moe"
+  echo "   temp <filename(s)>         - Uploads files to litterbox.catbox.moe"
   echo "   url <url(s)>               - Uploads files from URLs to catbox.moe"
   echo "   delete <filenames(s)>      - Deletes files from catbox.moe. Requires userhash"
   echo "   album                      - Album Managment"
@@ -59,6 +60,7 @@
 }
 
 HOST="https://catbox.moe/user/api.php"
+LITTERHOST="https://litterbox.catbox.moe/resources/internals/api.php"
 
 if [ $# -eq 0 ]
 then usage
@@ -137,6 +139,31 @@
       fi
     done
   fi
+elif [ $1 == "temp" ] 
+then
+  # Litterbox upload
+
+  if [ $# -lt 3 ]
+  then
+      echo "Usage: catbox temp <filename> [<filename>...] [1h/12h/24h/72h] - Uploads files to LitterBox.CatBox.moe"
+      exit 1;
+  fi
+  one=0
+  for file in "${@:1:$#-1}"
+  do
+    if [ $one -ne 1 ]; then one=1; continue; fi
+    if [ -f "$file" ] || [ -L "$file" ]
+    then
+      name=$(basename -- "$file")
+      echo -en "\e[1m$name\e[0m:\n"
+      link=`curl -F "reqtype=fileupload" -F "time=${*: -1:1}" -F "fileToUpload=@$file" $LITTERHOST`
+      echo -en "\n"
+      echo -en "Uploaded to: \e[1m$link\n"
+      echo -n $link|xclip -selection clipboard
+    else
+      echo -e "\e[91mFile $file dose not exists!\e[0m"
+    fi
+  done
 elif [ $1 == "url" ]
 then
   # Url Command

@VMpc Thank you very much for your suggestion!
I've added the Litterbox support with a bit of modification.
The expiry time is now truly optional and defaults to 1h.

Also, if you want only litterbox, I suggest you look at my litterbox gist.