From c6629364909e0b4c53bf1e1ef2f5b8ad37af441b Mon Sep 17 00:00:00 2001
From: Colin <colin@uninsane.org>
Date: Fri, 19 May 2023 19:48:52 +0000
Subject: [PATCH] sane-bt-add: add help message & port to nix-shell

---
 pkgs/additional/sane-scripts/default.nix     | 13 ++++++++----
 pkgs/additional/sane-scripts/src/sane-bt-add | 21 ++++++++++++++++++--
 2 files changed, 28 insertions(+), 6 deletions(-)

diff --git a/pkgs/additional/sane-scripts/default.nix b/pkgs/additional/sane-scripts/default.nix
index 8e256e36..e832a5be 100644
--- a/pkgs/additional/sane-scripts/default.nix
+++ b/pkgs/additional/sane-scripts/default.nix
@@ -108,17 +108,22 @@ let
   };
 
   py-scripts = {
-    # anything added to this attrset gets symlink-joined into into `sane-scripts`
-    bt-search = static-nix-shell.mkPython3Bin {
-      pname = "sane-bt-search";
+    # anything added to this attrset gets symlink-joined into `sane-scripts`
+    bt-add = static-nix-shell.mkBash {
+      pname = "sane-bt-add";
       src = ./src;
-      pyPkgs = [ "natsort" "requests" ];
+      pkgs = [ "transmission" ];
     };
     bt-rm = static-nix-shell.mkBash {
       pname = "sane-bt-rm";
       src = ./src;
       pkgs = [ "transmission" ];
     };
+    bt-search = static-nix-shell.mkPython3Bin {
+      pname = "sane-bt-search";
+      src = ./src;
+      pyPkgs = [ "natsort" "requests" ];
+    };
     date-math = static-nix-shell.mkPython3Bin {
       pname = "sane-date-math";
       src = ./src;
diff --git a/pkgs/additional/sane-scripts/src/sane-bt-add b/pkgs/additional/sane-scripts/src/sane-bt-add
index 00b4ddf7..9865d057 100755
--- a/pkgs/additional/sane-scripts/src/sane-bt-add
+++ b/pkgs/additional/sane-scripts/src/sane-bt-add
@@ -1,11 +1,12 @@
-#!/usr/bin/env bash
+#!/usr/bin/env nix-shell
+#!nix-shell -i bash -p transmission
 
 set -e
 
 endpoint=https://bt.uninsane.org/transmission/rpc
 PASS=$(sudo cat /run/secrets/transmission_passwd)
 
-options=$(getopt -l prefix:,film,show:,book:,audiobook:,vn:,author: -- "" "${@}")
+options=$(getopt -l help,prefix:,film,show:,book:,audiobook:,vn:,author: -- "" "${@}")
 eval "set -- ${options}"
 
 type=
@@ -14,6 +15,22 @@ author=
 prefix=
 while true; do
   case "$1" in
+    (--help)
+      echo "add a .torrent or magnet:// file to be downloaded by and stored on my server"
+      echo "usage: sane-bt-add [options] <magnet:// URI or path/to.torrent>"
+      echo "options:"
+      echo "  --prefix <PathString>"
+      echo "  --film"
+      echo "  --show <ShowTitle>"
+      echo "  --book <BookTitle>"
+      echo "  --audiobook <BookTitle>"
+      echo "  --vn <VisualNovelTitle>"
+      echo "  --author <Author>"
+      echo ""
+      echo "the above options are used to construct the filesystem path where the torrent data will live"
+      echo "everything is relative to the root media directory (not /)"
+      exit
+    ;;
     (--prefix)
       shift
       prefix="$1"