fair-viewer

A lightweight application (fork of youtube-viewer) for searching and streaming videos from YouTube, using the Invidious API and hypervideo support.

This fork parses the YouTube website directly and relies on the invidious instances only as a fallback method.

fair-viewer

• command-line interface to YouTube.

gtk-fair-viewer

• GTK+ interface to YouTube.

VIDEO REVIEWS

• [EN] fair-viewer and YouTube-Viewer -- Search Youtube via Terminal - Linux CLI

  • https://www.youtube.com/watch?v=I4tfHUmklWo

• [TW] fair-viewer！有史以來最佳的 YouTube 體驗就在這裡～

  • https://wiwi.video/videos/watch/798d38cd-9d10-4f8a-ac1f-f776c6d0aa2c

TRY

For trying the latest commit of fair-viewer, without installing it, execute the following commands:

    cd /tmp
    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-1.0.6.zip
    cd fair-viewer-1.0.6/bin
    ./fair-viewer

INSTALLATION

To install fair-viewer, run:

    perl Build.PL
    sudo ./Build installdeps
    sudo ./Build install

To install gtk-fair-viewer along with fair-viewer, run:

    perl Build.PL --gtk
    sudo ./Build installdeps
    sudo ./Build install

CONFIGURATIONS

for fair-viewer, run:

    nano -w "$HOME/.config/fair-viewer/fair-viewer.conf"

for gtk-fair-viewer, run:

    nano -w "$HOME/.config/fair-viewer/gtk-fair-viewer.conf"

DEPENDENCIES

For fair-viewer:

• libwww-perl
• LWP::Protocol::https
• Data::Dump
• JSON

For gtk-fair-viewer:

• Gtk3
• File::ShareDir
• + the dependencies required by fair-viewer.

Build dependencies:

• Module::Build

Optional dependencies:

• Local cache support: LWP::UserAgent::Cached
• Better STDIN support (+history): Term::ReadLine::Gnu
• Faster JSON deserialization: JSON::XS
• Fixed-width formatting: Unicode::LineBreak or Text::CharWidth

PACKAGING

To package this application, run the following commands:

    perl Build.PL --destdir "/my/package/path" --installdirs vendor [--gtk]
    ./Build test
    ./Build install --install_path script=/usr/bin

INVIDIOUS INSTANCES

To use a specific invidious instance, like invidious.snopyta.org, we have (see also the --invidious option):

    fair-viewer --api=invidious.snopyta.org

To make the change permanent, set in the configuration file:

    api_host => "invidious.snopyta.org",

By default, fair-viewer picks a random invidious instance from api.invidious.io on-demand.

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-2021 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 as published by the Free Software Foundation; or the Artistic License.

See http://dev.perl.org/licenses/ for more information.