trizen / lbry-viewer

Experimental Linux client for LBRY/Odysee.

lbry-viewer

A lightweight application (fork of pipe-viewer) for searching and playing videos from LBRY, using the Librarian frontend.

STATUS

The application is in the early stages of development. Some functionality is not implemented yet.

lbry-viewer

• command-line interface to LBRY.

gtk-lbry-viewer

• GTK+ interface to LBRY.

AVAILABILITY

• Arch Linux (AUR): https://aur.archlinux.org/packages/lbry-viewer-git/
• Debian/Ubuntu (MPR): Latest stable version https://mpr.makedeb.org/packages/lbry-viewer .Latest dev version https://mpr.makedeb.org/packages/lbry-viewer-git . MPR is like the AUR, but for Debian/Ubuntu. You need to install makedeb first https://www.makedeb.org/ .

TRY

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

    cd /tmp
    wget https://github.com/trizen/lbry-viewer/archive/main.zip -O lbry-viewer-main.zip
    unzip -n lbry-viewer-main.zip
    cd lbry-viewer-main/bin
    ./lbry-viewer

INSTALLATION

To install lbry-viewer, run:

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

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

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

DEPENDENCIES

For lbry-viewer:

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

For gtk-lbry-viewer:

• Gtk3
• File::ShareDir
• webp-pixbuf-loader
• + the dependencies required by lbry-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
• For the *_parallel config-options: Parallel::ForkManager
• Fallback extraction method: yt-dlp or youtube-dl.

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

LIBRARIAN INSTANCES

To use a specific Librarian instance, like lbry.vern.cc, pass the --api=HOST option:

    lbry-viewer --api=lbry.vern.cc

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

    api_host => "lbry.vern.cc",

When api_host is set to "auto", lbry-viewer picks a random instance from codeberg.org/librarian/librarian.

SUPPORT AND DOCUMENTATION

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

man lbry-viewer
perldoc WWW::LbryViewer

LICENSE AND COPYRIGHT

Copyright (C) 2012-2024 Trizen

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 https://dev.perl.org/licenses/ for more information.