name mode size
COPYING.txt 100644 35.15kB
README.txt 100644 4.48kB
gendl 100755 2.19kB
yt 100644 3.89kB
ytlib.sh 100644 19.01kB
README.txt
=============================================================================== SHELLTUBE Browse YT with a hood on =============================================================================== shelltube is a simples shell-script that lets you browse Youtube-- searching for playlists, videos, channels, showing their metadata (including items on playlsits and channels, etc) all from the terminal. It YouTube quickly, and entirely without a captive UI. shelltube is written in pure shell; its only dependencies are any modern shell (pdksh, bash, zsh), lynx, and curl/wget/ftp. Your terminal should accept ANSI color-codes, and be >79chars wide, for best experience~ shelltube isn't for downloading videos-- it's for *browsing* for them. Use youtube-dl or something for that. That's not my job! :P ---------------------------------------- INSTALLATION ---------------------------------------- Just place "ytlib.sh" in either the CWD, ./lib/ytlib.sh, /usr/lib/, or /usr/local/lib/ Then put `gendl` and `yt` in your $PATH. /usr/local/bin/ is nice (IMO), or ~/bin/, or /usr/bin. Whatever floats your boat, lad. Profit! ---------------------------------------- EXAMPLES ---------------------------------------- yt video --search "wixoss op 1" yt v -s "wixoss op 1" yt playlist --search "my hero academia ops" yt p -s "my hero academia ops" yt playlist --title "PLY4D6ucZdLWC_yM3R_A1Hj9fAXZO_rSeK" yt p -t "PLY4D6ucZdLWC_yM3R_A1Hj9fAXZO_rSeK" yt playlist --list "PLY4D6ucZdLWC_yM3R_A1Hj9fAXZO_rSeK" yt p -l "PLY4D6ucZdLWC_yM3R_A1Hj9fAXZO_rSeK" yt video --author "https://youtube.com/watch?v=yu0HjPzFYnY" yt v -a "https://youtube.com/watch?v=yu0HjPzFYnY" yt video --desc "https://youtube.com/watch?v=yu0HjPzFYnY" yt v -d "https://youtube.com/watch?v=yu0HjPzFYnY" yt video --date "https://youtube.com/watch?v=yu0HjPzFYnY" yt v -D "https://youtube.com/watch?v=yu0HjPzFYnY" ---------------------------------------- USAGE ---------------------------------------- YT -------------------- `yt` is the shelltube script-- it's executed with a subcommand [arguments] system, like `apt` or `git`. USAGE: yt subcommand action [arguments] The subcommands are: * (v)ideo * (p)laylist They refer to actions related to videos and playlists, respectively. Every subcommand and action thereof supports "-h" and "--help". YT VIDEO -------------------- `yt video` is for anything related to videos-- here it is: USAGE: yt (v)ideo [action] Here are the actions: SHORT LONG ARGUMENTS ---------------------------------------------- s search [-UIcsmb] search_query t title url/id d desc url/id v views url/id a author [-nU] url/id D date url/id The only actions with weird arguments are --search and --author: * normally, author returns the channel URL and name on one line * "author -n" returns only the name * "author -U" returns only the URL * normally, `search` prints results in the "big" format (title on one line, other metadata on second line) * "search -c" for "compact" format, etc. * "-c", "-s", "-m", "-b", for "compact", "small", "medium", and "big", respectively * "-U" and "-I" are special-- they print the URL and the ID *only*, respectively. Good for making playlist files. YT PLAYLIST -------------------- `yt playlist` is for anything related to playlists-- here it is: USAGE: yt (p)laylist [action] Here are the actions: SHORT LONG ARGUMENTS ---------------------------------------------- s search [-csmb] search_query l list [-csmb] url/id t title url/id v views url/id a author [-nu] url/id D date url/id The only actions with weird arguments are search, list and author: * author acts just like "video author" * search acts just like "video search" * list acts just like search, with [-UIcsmb] GENDL -------------------- There is another script that comes with shelltube (which it uses extensively: gendl. gendl can download files on a system that has at least one of these: * ftp * wget * curl ... to stdout or to a file. Both yt and ytlib.sh require gendl-- so make sure they're both in the same directory (or, at least, that gendl is in your $PATH) ---------------------------------------- BORING STUFF ---------------------------------------- License is in COPYING.txt (GNU GPLv3~! <3) Author is Jenga Phoenix <jadedctrl@teknik.io> Sauce is at https://git.eunichx.us/shelltube.git