Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/trizen/straw-viewer
**DEPRECATED** Use https://github.com/trizen/pipe-viewer instead.
https://github.com/trizen/straw-viewer
invidious perl
Last synced: 3 months ago
JSON representation
**DEPRECATED** Use https://github.com/trizen/pipe-viewer instead.
- Host: GitHub
- URL: https://github.com/trizen/straw-viewer
- Owner: trizen
- License: artistic-2.0
- Archived: true
- Created: 2020-02-14T21:43:53.000Z (almost 5 years ago)
- Default Branch: master
- Last Pushed: 2021-06-21T09:10:31.000Z (over 3 years ago)
- Last Synced: 2024-08-16T16:22:32.898Z (4 months ago)
- Topics: invidious, perl
- Language: Perl
- Homepage:
- Size: 657 KB
- Stars: 108
- Watchers: 7
- Forks: 7
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- Changelog: Changes
- License: LICENSE
Awesome Lists containing this project
README
## ** Deprecated in favor of: [pipe-viewer](https://github.com/trizen/pipe-viewer). ([info](https://github.com/trizen/pipe-viewer/commit/17fb2136f3f3d8ee6dacac05beabcc15082f699d))
## straw-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/documentation/blob/master/API.md) of [invidio.us](https://invidio.us/).
### straw-viewer
* command-line interface to YouTube.
### gtk-straw-viewer
* GTK+ interface to YouTube.
### STATUS
The project is in its early stages of development and some features are not implemented yet.
### AVAILABILITY
* Arch Linux (AUR): https://aur.archlinux.org/packages/straw-viewer-git/
* openSUSE: https://build.opensuse.org/package/show/home:Aptrug/straw-viewer
* Slackware: https://slackbuilds.org/repository/14.2/multimedia/straw-viewer/
### VIDEO REVIEWS
* [EN] Pipe-Viewer and Straw-Viewer -- Search Youtube via Terminal - Linux CLI
* https://www.youtube.com/watch?v=I4tfHUmklWo
### TRY
For trying the latest commit of `straw-viewer`, without installing it, execute the following commands:
```console
cd /tmp
wget https://github.com/trizen/straw-viewer/archive/master.zip -O straw-viewer-master.zip
unzip -n straw-viewer-master.zip
cd straw-viewer-master/bin
./straw-viewer
```
### INSTALLATION
To install `straw-viewer`, run:
```console
perl Build.PL
sudo ./Build installdeps
sudo ./Build install
```
To install `gtk-straw-viewer` along with `straw-viewer`, run:
```console
perl Build.PL --gtk
sudo ./Build installdeps
sudo ./Build install
```
### DEPENDENCIES
#### For straw-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-straw-viewer:
* [Gtk3](https://metacpan.org/release/Gtk3)
* [File::ShareDir](https://metacpan.org/release/File-ShareDir)
* \+ the dependencies required by straw-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
straw-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://api.invidious.io/
### 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 straw-viewer
perldoc WWW::StrawViewer
### LICENSE AND COPYRIGHT
Copyright (C) 2012-2021 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 http://dev.perl.org/licenses/ for more information.