aboutsummaryrefslogtreecommitdiffstats
path: root/README.md
diff options
context:
space:
mode:
Diffstat (limited to 'README.md')
-rw-r--r--README.md48
1 files changed, 24 insertions, 24 deletions
diff --git a/README.md b/README.md
index 3f1f21e..3ff3774 100644
--- a/README.md
+++ b/README.md
@@ -1,6 +1,10 @@
## 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.
+A lightweight application (fork of [youtube-viewer](https://github.com/trizen/youtube-viewer))
+for searching and streaming videos from YouTube, using the Invidious API and
+[hypervideo](https://git.conocimientoslibres.ga/software/hypervideo.git) support.
+
+This fork parses the YouTube website directly and relies on the invidious instances only as a fallback method.
### fair-viewer
@@ -12,11 +16,15 @@ A lightweight application (fork of [youtube-viewer](https://github.com/trizen/yo
* GTK+ interface to YouTube.
-![gtk-fair-viewer](https://user-images.githubusercontent.com/614513/73087694-93ffdb80-3edb-11ea-8fea-05901d72f68d.png)
+![gtk-fair-viewer](https://user-images.githubusercontent.com/614513/97737137-89125100-1ad4-11eb-8ff3-b19cd0041528.png)
+
+### VIDEO REVIEWS
-### STATUS
+* [EN] fair-viewer and YouTube-Viewer -- Search Youtube via Terminal - Linux CLI
+ * https://www.youtube.com/watch?v=I4tfHUmklWo
-The project is in its early stages of development and some features are not implemented yet.
+* [TW] fair-viewer!有史以來最佳的 YouTube 體驗就在這裡~
+ * https://wiwi.video/videos/watch/798d38cd-9d10-4f8a-ac1f-f776c6d0aa2c
### TRY
@@ -24,10 +32,9 @@ For trying the latest commit of `fair-viewer`, without installing it, execute th
```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
+ wget http://git.conocimientoslibres.ga/software/fair-viewer.git/snapshot/fair-viewer-1.0.6.zip -O fair-viewer-1.0.6.zip
+ unzip -n fair-viewer-main.zip
+ cd fair-viewer-main/bin
./fair-viewer
```
@@ -85,9 +92,9 @@ for `gtk-fair-viewer`, run:
#### 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)
+* 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)
+* Fixed-width formatting: [Unicode::LineBreak](https://metacpan.org/release/Unicode-LineBreak) or [Text::CharWidth](https://metacpan.org/release/Text-CharWidth)
### PACKAGING
@@ -102,39 +109,32 @@ To package this application, run the following commands:
### 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/):
+To use a specific invidious instance, like [invidious.snopyta.org](https://invidious.snopyta.org/), we have (see also the [--invidious](https://github.com/trizen/fair-viewer/commit/17fb2136f3f3d8ee6dacac05beabcc15082f699d) option):
```console
- fair-viewer --api=invidious.tube
+ fair-viewer --api=invidious.snopyta.org
```
To make the change permanent, set in the configuration file:
```perl
- api_host => "invidious.tube",
+ api_host => "invidious.snopyta.org",
```
-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.
+By default, `fair-viewer` picks a random invidious instance from [api.invidious.io](https://api.invidious.io/) on-demand.
### SUPPORT AND DOCUMENTATION
After installing, you can find documentation with the following commands:
+```console
man fair-viewer
perldoc WWW::FairViewer
+```
### LICENSE AND COPYRIGHT
-Copyright (C) 2012-2020 Trizen
+Copyright (C) 2012-2021 Trizen
Copyright (C) 2020 Jesus