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
|
## fair-viewer
A lightweight application (fork of [youtube-viewer](https://github.com/trizen/youtube-viewer)) for searching and playing videos from YouTube, using the [API](https://github.com/iv-org/invidious/wiki/API) of [invidio.us](https://invidio.us/) and [hypervideo](https://framagit.org/heckyel/hypervideo) support.
### fair-viewer
* command-line interface to YouTube.
### gtk-fair-viewer
* GTK+ interface to YouTube.
### STATUS
The project is in its early stages of development and some features are not implemented yet.
### INSTALLATION
To install `fair-viewer`, run:
```console
perl Build.PL
sudo ./Build installdeps
sudo ./Build install
```
To install `gtk-fair-viewer` along with `fair-viewer`, run:
```console
perl Build.PL --gtk
sudo ./Build installdeps
sudo ./Build install
```
### TRY
For trying the latest commit of `fair-viewer`, without installing it, execute the following commands:
```console
cd /tmp
wget https://libregit.org/heckyel/fair-viewer/archive/master.zip -O fair-viewer-master.zip
unzip -n fair-viewer-master.zip
cd fair-viewer-master/bin
perl -pi -ne 's{DEVEL = 0}{DEVEL = 1}' {gtk-,}fair-viewer
./fair-viewer
```
### CONFIGURATIONS
for `fair-viewer`, run:
```console
nano -w "$HOME/.config/fair-viewer/fair-viewer.conf"
```
for `gtk-fair-viewer`, run:
```console
nano -w "$HOME/.config/fair-viewer/gtk-fair-viewer.conf"
```
### DEPENDENCIES
#### For fair-viewer:
* [libwww-perl](https://metacpan.org/release/libwww-perl)
* [LWP::Protocol::https](https://metacpan.org/release/LWP-Protocol-https)
* [Data::Dump](https://metacpan.org/release/Data-Dump)
* [JSON](https://metacpan.org/release/JSON)
#### For gtk-fair-viewer:
* [Gtk3](https://metacpan.org/release/Gtk3)
* [File::ShareDir](https://metacpan.org/release/File-ShareDir)
* \+ the dependencies required by fair-viewer.
#### Build dependencies:
* [Module::Build](https://metacpan.org/pod/Module::Build)
#### Optional dependencies:
* Local cache support: [LWP::UserAgent::Cached](https://metacpan.org/release/LWP-UserAgent-Cached)
* Better STDIN support (+ history): [Term::ReadLine::Gnu](https://metacpan.org/release/Term-ReadLine-Gnu)
* Faster JSON deserialization: [JSON::XS](https://metacpan.org/release/JSON-XS)
* Fixed-width formatting (--fixed-width, -W): [Unicode::LineBreak](https://metacpan.org/release/Unicode-LineBreak) or [Text::CharWidth](https://metacpan.org/release/Text-CharWidth)
### PACKAGING
To package this application, run the following commands:
```console
perl Build.PL --destdir "/my/package/path" --installdirs vendor [--gtk]
./Build test
./Build install --install_path script=/usr/bin
```
### INVIDIOUS INSTANCES
Sometimes, the default instance, [invidious.snopyta.org](https://invidious.snopyta.org/), may fail to work properly. When this happens, we can change the API host to some other instance of invidious, such as [invidious.tube](https://invidious.tube/):
```console
fair-viewer --api=invidious.tube
```
To make the change permanent, set in the configuration file:
```perl
api_host => "invidious.tube",
```
Alternatively, the following will automatically pick a random invidious instance everytime the program is started:
```perl
api_host => "auto",
```
The available instances are listed at: https://instances.invidio.us/
### PIPE-VIEWER
[pipe-viewer](https://github.com/trizen/pipe-viewer) is an experimental fork of `straw-viewer` with the goal of parsing the YouTube website directly, and thus it may be a faster and more reliable alternative.
### SUPPORT AND DOCUMENTATION
After installing, you can find documentation with the following commands:
man fair-viewer
perldoc WWW::FairViewer
### LICENSE AND COPYRIGHT
Copyright (C) 2012-2020 Trizen
Copyright (C) 2020 Jesus
This program is free software; you can redistribute it and/or modify it
under the terms of either: the [GNU General Public License](LICENSE) as published
by the Free Software Foundation; or the [Artistic License](Artistic-2.0.txt).
See http://dev.perl.org/licenses/ for more information.
|
