===============================================================================
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
619fc27ffc