Skip to main content

Python application to watch YouTube videos through the Invidious API, in the terminal!

Project description



pip install --user invidious-viewer

For installing the git version:

pip install --user -U git+

Add ~/.local/bin to PATH by adding the following to your ~/.bashrc:


This will allow invidious-viewer to be launched by using the invidious command in the terminal.


Note: The MPV player is required, along with which should be provided by your distribution's package manager. Compiling MPV with LuaJIT support may also be required on a source-based distribution.

Default behaviour: Return the first page of results for the entered search term.

Additional usage options:

usage: [-h] [-i INSTANCE] [-r RESULTS] [-v]
                           [-u URL | -c CHANNEL | -p | -t]

optional arguments:
  -h, --help            show this help message and exit
  -i INSTANCE, --instance INSTANCE
                        Specify a different invidious instance
  -r RESULTS, --results RESULTS
                        Return specific number of results
  -v, --video           Toggle video playback
  -u URL, --url URL     Specify link or ID to play [Video/Playlist]
  -c CHANNEL, --channel CHANNEL
                        View videos from a specific channel
  -p, --popular         View popular videos (Default invidious page)
  -t, --trending        View trending videos

Config File:

    "instance": "",
    "play_video": true,
    "captions": false

The instance can be permanently specified in the config file, along with the video playback and closed captions preference.

The suggested alternative instance is as all the required endpoints are provided.

Usage example: invidious --channel "Channel Name" --instance --results 5

Returns the first 5 results from the specified channel and fetches all URLs from the Snopyta instance.


ScreenShot ScreenShot ScreenShot

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for invidious-viewer, version 0.0.7
Filename, size File type Python version Upload date Hashes
Filename, size invidious_viewer-0.0.7-py3-none-any.whl (18.4 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size invidious-viewer-0.0.7.tar.gz (5.6 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page