README

@@ -4,66 +4,42 @@ viewing and interacting with YouTube videos.
 Dependencies:
 - curl(1)
 - jq(1)
+- mpv(1)
 - yt-dlp(1)
 
-Environment Variables:
-$DEBUG
-- Set this variable to get debug output to stderr
-
-$PLAYER
-- Set this variable to a video player that can utilize yt-dlp to playback
-videos from YouTube
-
+Variables:
 $YTPICK
 - Set this variable to a dmenu-compatible picker for use with the pick
-subcommand
-
-$YT_PL_DIR
-- Set this variable to the directory where playlists should be stored; defaults
-to $XDG_DATA_HOME/yt
-
+subcommand.
 
 Usage:
-yt add | archive | cache | clone | list | localsearch | new | pick | play | queue | search | sync | verify
+yt add | archive | cache | clone | music | pick | play | queue | verify
 
-add uri playlist
+add uri file
 - Adds a video by URI to a playlist
 
 archive uri...
-- Archives videos on the Wayback Machine
+- Archives a video on the Wayback Machine
 
-cache video...
-- Caches video titles
+cache uri...
+- Caches a video title
 
-clone uri [playlist]
+clone uri file
 - Clones a YouTube playlist to a file
 
-list
-- lists local playlists
+music uri...
+- Downloads a video as audio, splitting it by chapter
 
-localsearch
-- uses $YTPICK to search for videos from the local cache
-
-new playlist...
-- creates new playlists
-
-pick playlist...
+pick file...
 - Opens $PICKER to a list of videos in a file
 
 play uri...
-- Plays videos, caching their titles first
+- Plays a video, caching its title first
 
-queue playlist...
-- Queues playlists
+queue file...
+- Queues a playlist
 
-search term [count]
-- Searches YouTube for term and returns count results
-
-sync [playlist]
-- If a playlist is specified, sync that playlist with its remote YouTube
-counterpart; otherwise, sync all playlists with remotes
-
-verify playlist...
+verify file...
 - Verifies that all the videos in a playlist are existent on YouTube, and if
 they aren’t, attempts to replace the URI with one from the Wayback Machine. If
 the video isn’t available on the Wayback Machine, it comments the video link. It

yt

@@ -30,24 +30,12 @@ test -n "$YT_PL_DIR" \
 test -d "$YT_PL_DIR" \
 	|| mkdir -p "$YT_PL_DIR"
 
-if test -z "$YTPICK"; then
-	printf "%s: Please set \$YTPICK to your preferred picking tool." \
-		"$argv0" 1>&2
-	exit 78 # sysexits.h(3) EX_CONFIG
-fi
-
-if test -z "$PLAYER"; then
-	printf "%s: Please set \$PLAYER to your preferred video player." \
-		"$argv0" 1>&2
-	exit 78 # sysexits.h(3) EX_CONFIG
-fi
-
 # formatted $YT_PL_DIR for use with sed
 P="$(printf '%s\n' "$YT_PL_DIR" | sed 's;\/;\\/;g')" 
 
 argv0="$0"
 com="$1"
-u='add | archive | clone | list | localsearch | new | pick | play | search | sync | verify'
+u='add | archive | clone | list | new | pick | play | search | sync | verify'
 FMT='%(title)s – %(channel)s (%(duration>%H:%M:%S)s) [%(webpage_url)s]'
 WBAPI='https://archive.org/wayback/available?url='
 
@@ -117,7 +105,7 @@ clone() { # clones a YouTube playlist to a file
 	n=1
 
 	while test -z "$title"; do
-		title="$(yt-dlp -s -I "$n" --print '%(playlist)s' "$1" 2>/dev/null || true)"
+		title="$(yt-dlp -s -I "$n" --print '%(playlist)s' "$1" || true)"
 		n="$((n + 1))"
 	done
 
@@ -145,18 +133,20 @@ lines() {
 
 list() {
 	test -n "$1" && usage 'list'
+
+	if test -z "$YTPICK"; then
+		printf "%s: Please set \$YTPICK to your preferred picking tool." \
+			"$argv0" 1>&2
+		exit 78 # sysexits.h(3) EX_CONFIG
+	fi
+
 	choices="$(menu)"
+
 	test -z "$choices" || pick "$choices"
 }
 
-localsearch() {
-	test -n "$1" && usage 'localsearch'
-	$YTPICK <"$cachefile"
-}
-
 menu() {
-		playlist="$(ls "$YT_PL_DIR" | sed 's/\.m3u//g' | sed -n '/[^.old]/p' \
-			| $YTPICK)"
+		playlist="$(ls "$YT_PL_DIR" | sed 's/\.m3u//g' | sed -n '/[^.old]/p' | $YTPICK)"
 
 		while test -d "$YT_PL_DIR/$playlist"; do
 			dir="$playlist"
@@ -184,6 +174,12 @@ new() {
 pick() { # Pick a video to play from a playlist of videos
 	test -z "$1" && usage 'pick playlist...'
 
+	if test -z "$YTPICK"; then
+		printf "%s: Please set \$YTPICK to your preferred picking tool." \
+			"$argv0" 1>&2
+		exit 78 # sysexits.h(3) EX_CONFIG
+	fi
+
 	if test -f "$YT_PL_DIR/$1.m3u"; then
 		file="$YT_PL_DIR/$1.m3u"
 
@@ -214,6 +210,12 @@ pick() { # Pick a video to play from a playlist of videos
 play() { # play a video after caching its title
 	test -z "$1" && usage 'play uri...'
 
+	if test -z "$PLAYER"; then
+		printf "%s: Please set \$PLAYER to your preferred video player." \
+			"$argv0" 1>&2
+		exit 78 # sysexits.h(3) EX_CONFIG
+	fi
+
 	cache "$@" &
 	"$PLAYER" "$@"
 }
@@ -221,6 +223,12 @@ play() { # play a video after caching its title
 queue() {
 	test -z "$1" && usage 'queue playlist...'
 
+	if test -z "$PLAYER"; then
+		printf "%s: Please set \$PLAYER to your preferred video player." \
+			"$argv0" 1>&2
+		exit 78 # sysexits.h(3) EX_CONFIG
+	fi
+
 	while test -f "$YT_PL_DIR/$1.m3u"; do
 		"$PLAYER" "$YT_PL_DIR/$1.m3u"
 		shift
@@ -230,6 +238,12 @@ queue() {
 search() {
 	test -z "$1" && usage 'search term [count]'
 
+	if test -z "$YTPICK"; then
+		printf "%s: Please set \$YTPICK to your preferred picking tool." \
+			"$argv0" 1>&2
+		exit 78 # sysexits.h(3) EX_CONFIG
+	fi
+
 	results="$(yt-dlp "ytsearch$2:$1" --print "$FMT")"
 
 	cache "$(printf '%s\n' "$results" | sed -e 's/.*\[//g' -e 's/\]/ /g' \
@@ -260,6 +274,18 @@ search() {
 	fi
 }
 
+searchlocal() {
+	test -n "$1" && usage 'searchlocal'
+
+	if test -z "$YTPICK"; then
+		printf "%s: Please set \$YTPICK to your preferred picking tool." \
+			"$argv0" 1>&2
+		exit 78 # sysexits.h(3) EX_CONFIG
+	fi
+
+	$YTPICK <"$cachefile"
+}
+
 sync() {
 	if test -z "$1"
 	then
@@ -354,6 +380,4 @@ done
 
 test -n "$com" && shift || usage "$u"
 
-printf '%s\n' "$u" | grep "$com" >/dev/null || usage "$u"
-
 "$com" "$@"