WWW::Y...Viewer(3pm)

📦 version 3.11.6, in alpine 3.24

💖 WWW::Y...Viewer — a very easy interface to YouTube 💖

okay so bestie, this is WWW::YoutubeViewer, and it lives in the User Contributed Perl Documentation section of your manpages (the manual name is literally WWW::Y...Viewer(3pm) — yes the truncation is iconic, no we're not fixing it). It's a Perl module that gives you a super chill, super easy way to talk to YouTube. periodt. 🎀

✨ NAME ✨

WWW::YoutubeViewer — a very easy interface to YouTube. that's it, that's the whole vibe. 💅

🌈 SYNOPSIS 🌈

the whole intro is literally this cute:

use WWW::YoutubeViewer;

my $yv_obj = WWW::YoutubeViewer->new();
...

load it, make an object, go off. slay. ✨

🦋 SUBROUTINES/METHODS 🦋

🌸 new(%opts)

Returns a blessed object. that's your main character right there, hand it some %opts and it comes back blessed, literally. 👑

🌸 escape_string($string)

Escapes a string with URI::Escape and returns it. no cap, that's the whole job. 🎀

🌸 set_lwp_useragent()

Initializes the LWP::UserAgent module and returns it. it's giving setup era. 🫶

🌸 prepare_access_token()

Returns a string. it's used as a header, with the access token. iykyk. 🔑

🌸 lwp_get($url, %opt)

Get and return the content for $url. 📥

Where %opt can be:

  • simple => [bool] — when the value of simple is set to a true value, the authentication header will not be set in the HTTP request. sneaky little toggle, we love her. 🙈

🌸 lwp_post($url, [@args])

Post and return the content for $url. classic POST behavior, no notes. 💌

🌸 lwp_mirror($url, $output_file)

Downloads the $url into $output_file. Returns true on success. downloading is self care fr fr. 💾

🌸 post_as_json($url, $ref)

Send a "POST" request to the given URL, with JSON content given as a Perl REF structure. Returns the response content. json girlie behavior. 🧚

🌸 lwp_delete($url)

Send a "DELETE" request to the given URL. Returns the response content. gone, deleted, blocked, unfollowed. 💀

🌸 list_to_url_arguments(\%options)

Returns a valid string of arguments, with defined values. only the defined ones get to come to the party. ⭐

🌸 default_arguments(%args)

Merge the default arguments with %args and concatenate them together. teamwork makes the dream work. 🫶

🌸 parse_query_string($string, multi => [0,1])

Parse a query string and return a data structure back. 🔍

When the multi option is set to a true value, the function will store multiple values for a given key. (yes queen, give us the whole list, not just the last one.) 👑

Returns back a list of key-value pairs.

🌸 get_streaming_urls($videoID)

Returns a list of streaming URLs for a videoID. the shape is literally:

({itag=>..., url=>...}, {itag=>..., url=>....}, ...)

itags and urls, urls and itags, that's the whole structure. lowkey obsessed. 🔥

👑 AUTHOR 👑

Trizen, "<echo dHJpemVuQHByb3Rvbm1haWwuY29tCg== | base64 -d>" — yeah that's the author line, base64 and all, we're keeping it exactly as it is because decoding it is a you problem bestie. 😭🫶

🌈 SEE ALSO 🌈

Copyright 2012-2015 Trizen.

This program is free software; you can redistribute it and/or modify it under the terms of the the Artistic License (2.0). You may obtain a copy of the full license at:

<https://www.perlfoundation.org/artistic_license_2_0>

Any use, modification, and distribution of the Standard or Modified Versions is governed by this Artistic License. By using, modifying or distributing the Package, you accept this license. Do not use, modify, or distribute the Package, if you do not accept this license. (read that again, it's not a vibe, it's a rule. 💀)

If your Modified Version has been derived from a Modified Version made by someone other than you, you are nevertheless required to ensure that your Modified Version complies with the requirements of this license.

This license does not grant you the right to use any trademark, service mark, tradename, or logo of the Copyright Holder. (no borrowing the branding, bestie. 🚫)

This license includes the non-exclusive, worldwide, free-of-charge patent license to make, have made, use, offer to sell, sell, import and otherwise transfer the Package with respect to any patent claims licensable by the Copyright Holder that are necessarily infringed by the Package. If you institute patent litigation (including a cross-claim or counterclaim) against any party alleging that the Package constitutes direct or contributory patent infringement, then this Artistic License to you shall terminate on the date that such litigation is filed. ⚖️

Disclaimer of Warranty: THE PACKAGE IS PROVIDED BY THE COPYRIGHT HOLDER AND CONTRIBUTORS "AS IS' AND WITHOUT ANY EXPRESS OR IMPLIED WARRANTIES. THE IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, OR NON-INFRINGEMENT ARE DISCLAIMED TO THE EXTENT PERMITTED BY YOUR LOCAL LAW. UNLESS REQUIRED BY LAW, NO COPYRIGHT HOLDER OR CONTRIBUTOR WILL BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL DAMAGES ARISING IN ANY WAY OUT OF THE USE OF THE PACKAGE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 🫶

and that's the whole page!! sign-off era: this one's from perl v5.42.2, dated 2026-02-15, and it's the WWW::Y...Viewer(3pm) manual page. go be easy with YouTube, bestie 💖✨🎀

📦 where this page comes from