This repository has been archived by the owner on Jan 29, 2024. It is now read-only.
-
Notifications
You must be signed in to change notification settings - Fork 3
/
Copy pathREADME.txt
156 lines (110 loc) · 4.44 KB
/
README.txt
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
===============================================================================
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 playlists and channels, etc), with no weird dependencies.
It searches YouTube quickly, 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
2024 note: This is quite old, and is almost certain not to work!
----------------------------------------
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 <[email protected]>
Sauce is at https://hak.xwx.moe/jadedctrl/shelltube