A lightweight application for searching and streaming videos from YouTube, using the Invidious API and hypervideo support
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Jesús 3250552df3
Version 1.0.4
1 week ago
bin Version 1.0.4 1 week ago
lib/WWW Version 1.0.4 1 week ago
share - Allow `gtk-fair-viewer` to run under any gtk+ >= 3.0. (previously required gtk+ >= 3.20) - Added info for how to execute `fair-viewer` without installing it. - Added Slackware to the "Availability" list. 1 month ago
t rebrand app 4 months ago
.gitignore Add Makefile to generator tarball 1 week ago
Artistic-2.0.txt Update README.md 3 months ago
Build.PL Fix Non-ASCII character 4 months ago
Changes Version 1.0.4 1 week ago
LICENSE rebrand app 4 months ago
MANIFEST rebrand app 4 months ago
MANIFEST.SKIP rebrand app 4 months ago
META.json Version 1.0.4 1 week ago
META.yml Version 1.0.4 1 week ago
Makefile Add Makefile to generator tarball 1 week ago
Makefile.PL rebrand app 4 months ago
README.md README.md: fix description app 2 weeks ago

README.md

fair-viewer

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

fair-viewer

  • command-line interface to YouTube.

fair-viewer

gtk-fair-viewer

  • GTK+ interface to YouTube.

gtk-fair-viewer

STATUS

The project is in its early stages of development and some features are not implemented yet.

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

TRY

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

    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:

    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:

For gtk-fair-viewer:

Optional dependencies:

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

Sometimes, the default instance, invidio.us, may fail to work properly. When this happens, we can change the API host to some other instance of invidious, such as invidious.snopyta.org.

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

This can be changed permanently, by setting in the configuration file:

    api_host => "invidious.snopyta.org",

The available instances are listed at: https://instances.invidio.us/

SUPPORT AND DOCUMENTATION

After installing, you can find documentation with the following commands:

man fair-viewer
perldoc WWW::FairViewer

Copyright © 2012-2020 Trizen

Copyright © 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.