{"id":13478667,"url":"https://github.com/trizen/youtube-viewer","last_synced_at":"2025-05-14T14:10:16.298Z","repository":{"id":40633270,"uuid":"1359241","full_name":"trizen/youtube-viewer","owner":"trizen","description":"Lightweight YouTube client for Linux","archived":false,"fork":false,"pushed_at":"2025-04-22T16:42:19.000Z","size":3829,"stargazers_count":1229,"open_issues_count":41,"forks_count":90,"subscribers_count":49,"default_branch":"master","last_synced_at":"2025-04-22T17:52:32.524Z","etag":null,"topics":["perl","youtube-viewer"],"latest_commit_sha":null,"homepage":"https://trizenx.blogspot.com/2012/03/gtk-youtube-viewer.html","language":"Perl","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"artistic-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/trizen.png","metadata":{"files":{"readme":"README.md","changelog":"Changes","contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null},"funding":{"github":null,"patreon":null,"open_collective":null,"ko_fi":null,"tidelift":null,"community_bridge":null,"liberapay":null,"issuehunt":null,"otechie":null,"custom":"https://www.paypal.me/trizen"}},"created_at":"2011-02-12T17:33:58.000Z","updated_at":"2025-04-22T17:52:21.000Z","dependencies_parsed_at":"2024-01-15T17:43:36.154Z","dependency_job_id":"d267067a-c6b6-4d48-99c1-c8d4c5275164","html_url":"https://github.com/trizen/youtube-viewer","commit_stats":{"total_commits":1239,"total_committers":24,"mean_commits":51.625,"dds":0.4939467312348669,"last_synced_commit":"3494825e63abb8905809a75090deb1afe55a0e86"},"previous_names":[],"tags_count":88,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/trizen%2Fyoutube-viewer","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/trizen%2Fyoutube-viewer/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/trizen%2Fyoutube-viewer/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/trizen%2Fyoutube-viewer/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/trizen","download_url":"https://codeload.github.com/trizen/youtube-viewer/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254160557,"owners_count":22024571,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["perl","youtube-viewer"],"created_at":"2024-07-31T16:02:00.286Z","updated_at":"2025-05-14T14:10:11.282Z","avatar_url":"https://github.com/trizen.png","language":"Perl","funding_links":["https://www.paypal.me/trizen"],"categories":["Perl","YouTube","Overview","\u003ca name=\"viewers\"\u003e\u003c/a\u003eViewers"],"sub_categories":["YouTube"],"readme":"## youtube-viewer\n\nA lightweight application for searching and playing videos from YouTube.\n\n### youtube-viewer\n\n* command-line interface to YouTube.\n\n![youtube-viewer](https://user-images.githubusercontent.com/614513/97738550-6d0faf00-1ad6-11eb-84ec-d37f28073d9d.png)\n\n### gtk-youtube-viewer\n\n* GTK+ interface to YouTube.\n\n![gtk-youtube-viewer](https://user-images.githubusercontent.com/614513/127563797-704a7fcf-54eb-4540-bd32-a11edc629dac.png)\n\n### AVAILABILITY\n\n* Alpine Linux: `doas apk add youtube-viewer`\n* Arch Linux (AUR): https://aur.archlinux.org/packages/gtk-youtube-viewer-git/\n* Arch Linux (AUR) (CLI only): https://aur.archlinux.org/packages/youtube-viewer-git/\n* Fedora: https://copr.fedorainfracloud.org/coprs/itsuki/Youtube-viewer/\n* FreeBSD: https://www.freshports.org/multimedia/gtk-youtube-viewer\n* Frugalware: https://frugalware.org/packages/203103\n* Gentoo: https://packages.gentoo.org/package/net-misc/youtube-viewer\n* OSX: `brew install thekevjames/youtube-viewer/youtube-viewer`\n* Puppy Linux: https://www.murga-linux.com/puppy/viewtopic.php?t=76835\n* Slackware: https://slackbuilds.org/repository/14.2/multimedia/youtube-viewer/\n* Solus: `sudo eopkg it youtube-viewer`\n* Ubuntu/Linux Mint: `sudo add-apt-repository ppa:nilarimogard/webupd8`\n* Debian/Ubuntu (MPR): Latest stable version https://mpr.makedeb.org/packages/youtube-viewer .Latest dev version https://mpr.makedeb.org/packages/youtube-viewer-git . MPR is like the AUR, but for Debian/Ubuntu. You need to install makedeb first https://www.makedeb.org/ .\n* Void Linux: `sudo xbps-install youtube-viewer`\n\n### INSTALLATION\n\nTo install `youtube-viewer`, run:\n\n```console\n    perl Build.PL\n    sudo ./Build installdeps\n    sudo ./Build install\n```\n\nTo install `gtk-youtube-viewer` along with `youtube-viewer`, run:\n\n```console\n    perl Build.PL --gtk\n    sudo ./Build installdeps\n    sudo ./Build install\n```\n\n### TRY\n\nFor trying the latest commit of `youtube-viewer`, without installing it, execute the following commands:\n\n```console\n    cd /tmp\n    wget https://github.com/trizen/youtube-viewer/archive/master.zip -O youtube-viewer-master.zip\n    unzip -n youtube-viewer-master.zip\n    cd youtube-viewer-master/bin\n    ./youtube-viewer\n```\n\n\n### DEPENDENCIES\n\n#### For youtube-viewer:\n\n* [libwww-perl](https://metacpan.org/release/libwww-perl)\n* [LWP::Protocol::https](https://metacpan.org/release/LWP-Protocol-https)\n* [Data::Dump](https://metacpan.org/release/Data-Dump)\n* [JSON](https://metacpan.org/release/JSON)\n* [yt-dlp](https://github.com/yt-dlp/yt-dlp) or [youtube-dl](https://github.com/ytdl-org/youtube-dl).\n\n#### For gtk-youtube-viewer:\n\n* [Gtk3](https://metacpan.org/release/Gtk3)\n* [File::ShareDir](https://metacpan.org/release/File-ShareDir)\n* \\+ the dependencies required by youtube-viewer.\n\n#### Optional dependencies:\n\n* Local cache support: [LWP::UserAgent::Cached](https://metacpan.org/release/LWP-UserAgent-Cached)\n* Better STDIN support (+history): [Term::ReadLine::Gnu](https://metacpan.org/release/Term-ReadLine-Gnu)\n* Faster JSON deserialization: [JSON::XS](https://metacpan.org/release/JSON-XS)\n* Fixed-width formatting: [Unicode::LineBreak](https://metacpan.org/release/Unicode-LineBreak) or [Text::CharWidth](https://metacpan.org/release/Text-CharWidth)\n\n### PACKAGING\n\nTo package this application, run the following commands:\n\n```console\n    perl Build.PL --destdir \"/my/package/path\" --installdirs vendor [--gtk]\n    ./Build test\n    ./Build install --install_path script=/usr/bin\n```\n\n### LOGGING IN\n\nStarting with version 3.7.4, youtube-viewer provides the `~/.config/youtube-viewer/api.json` file, which allows setting an YouTube API key and the client ID/SECRET values:\n\n```json\n{\n    \"key\":           \"API_KEY\",\n    \"client_id\":     \"CLIENT_ID\",\n    \"client_secret\": \"CLIENT_SECRET\"\n}\n```\n\n* Prerequisite: you must create a Google Platform project. Following the below steps should prompt you to create one if you do not already have one.\n* Enable the YouTube Data v3 API on your project: [navigate here](https://console.developers.google.com/apis/library/youtube.googleapis.com) and click \"Enable\" (if you see a blue \"Manage\" button, it's already enabled).\n* Replace `API_KEY` with your YouTube API key. Create a new key [here](https://console.developers.google.com/apis/credentials) by clicking on \"Create Credentials\" \u003e \"API Key\".\n* Optionally, in order to log in, replace `CLIENT_ID` and `CLIENT_SECRET` with your native client ID and client secret values, by creating a new OAuth 2.0 Client ID [here](https://console.developers.google.com/apis/api/youtube.googleapis.com/credentials): click \"Create Credentials\" \u003e \"OAuth client ID\", then select \"TV and Limited Input devices\" ([tutorial](https://github.com/trizen/youtube-viewer/issues/353#issuecomment-763574106) -- may be outdated).\n\nThe project must have the following scope enabled: `https://www.googleapis.com/auth/youtube`\n\nAlso, in order to log in, grant access to the project in: https://console.cloud.google.com/apis/credentials/consent\n\nSee also: [#285](https://github.com/trizen/youtube-viewer/issues/285), [#308](https://github.com/trizen/youtube-viewer/issues/308).\n\n### PIPE-VIEWER\n\n[pipe-viewer](https://github.com/trizen/pipe-viewer) is a fork of [straw-viewer](https://github.com/trizen/straw-viewer), which parses the YouTube website directly, and thus it does not require an YouTube API key.\n\n### REVIEWS\n\n* [EN] YOUTUBE VIEWER: A COMPLETE YOUTUBE CLIENT FOR LINUX [UBUNTU PPA]\n    * https://www.webupd8.org/2015/02/youtube-viewer-complete-youtube-client.html\n* [EN] YOUTUBE-VIEWER – ALTERNATIVE WAY TO INTERACT WITH YOUTUBE\n    * https://www.ossblog.org/youtube-viewer-alternative-way-watch-youtube/\n* [EN] A YouTube CLI for Mac\n    * https://blog.johnkrauss.com/installing-youtube-viewer/\n* [EN] Gtk Youtube Viewer (for lots of pups)\n    * https://www.murga-linux.com/puppy/viewtopic.php?t=76835\n* [ES] Este es el mejor cliente de YouTube para Linux\n    * https://rootear.com/ubuntu-linux/cliente-youtube-linux\n* [ES] YouTube Viewer: busca, reproduce y descarga vídeos de YouTube desde el escritorio\n    * https://www.linuxadictos.com/youtube-viewer-busca-reproduce-y-descarga-videos-de-youtube-desde-el-escritorio.html\n* [HU] GTK Youtube Viewer\n    * https://linuxmint.hu/blog/2018/09/gtk-youtube-viewer\n* [JP] GTK Youtube Viewer 試してみた\n    * https://tamahamster.blogspot.com/2016/06/type-p-debiandog-gtk-youtube-viewer.html\n* [PT] YouTube Viewer: um completo cliente YouTube para Linux\n    * https://www.edivaldobrito.com.br/youtube-viewer-um-cliente-completo/\n* [RO] youtube-viewer\n    * https://stressat.blogspot.com/2012/01/youtube-viewer.html\n* [RU] Стримим и кастим youtube и не только\n    * https://habr.com/ru/post/534926/\n* [RU] Установить клиент Youtube Viewer в Linux\n    * https://compizomania.blogspot.com/2015/02/youtube-viewer-linux.html\n* [RU] Youtube Viewer / GTK Youtube Viewer\n    * https://zenway.ru/page/gtk-youtube-viewer\n* [TR] Youtube Viewer Nedir? Nasıl Kurulur? (Ubuntu/Linux Mint)\n    * https://www.sistemlinux.org/2017/05/youtube-viewer-nedir-nasil-kurulur.html\n\n### VIDEO REVIEWS\n\n* [EN] Youtube-Viewer -- Search and Play Youtube Video - Linux CLI\n    * https://www.youtube.com/watch?v=FnJ67oAxVQ4\n* [EN] youtube-viewer - Watch, Read and Post Youtube Comments - Linux CLI\n    * https://www.youtube.com/watch?v=3CNRRdyFwsY\n* [EN] Gentoo in Review - youtube-viewer CLI client\n    * https://www.youtube.com/watch?v=YzN2scO025I\n* [EN] GTK Youtube Viewer : A Complete Youtube Desktop Client For Linux Mint\n    * https://www.youtube.com/watch?v=R5b12tvpe3E\n* [EN] GTK-YouTube Viewer for Puppy Linux\n    * https://www.youtube.com/watch?v=UH3dPspqtRM\n\n### SUPPORT AND DOCUMENTATION\n\nAfter installing, you can find documentation with the following commands:\n\n    man youtube-viewer\n    perldoc WWW::YoutubeViewer\n\n### LICENSE AND COPYRIGHT\n\nCopyright (C) 2012-2025 Trizen\n\nThis program is free software; you can redistribute it and/or modify it\nunder the terms of either: the GNU General Public License as published\nby the Free Software Foundation; or the Artistic License.\n\nSee https://dev.perl.org/licenses/ for more information.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftrizen%2Fyoutube-viewer","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftrizen%2Fyoutube-viewer","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftrizen%2Fyoutube-viewer/lists"}