_ _ | | | | _ _ _____ _| |_ _ _| |__ ___ | | | |/ _ \ \ /\ / / __| | | | '_ \ / _ \ | |_| | __/\ V V /| |_| |_| | |_) | __/ \__, |\___| \_/\_/ \__|\__,_|_.__/ \___| __/ | |___/
Terminal based YouTube player and downloader. No Youtube API key required. Forked from mps-youtube
Installation¶
Stable Version¶
Using pip¶
- Install using
pip install yewtube
- Run using,
yt
. Enjoy!
Using pipx (Recommended)¶
- Install pipx using
pip install pipx
- Install
yewtube
usingpipx install yewtube
- Now, type
yt
That's it.
Latest Version¶
Using pip¶
- Install using
pip install git+https://github.com/iamtalhaasghar/yewtube.git
- Run using,
yt
. Enjoy!
Using pipx¶
- Install pipx using
pip install pipx
- Install
yewtube
usingpipx install git+https://github.com/iamtalhaasghar/yewtube.git
- Now, type
yt
That's it.
What's new in yewtube?¶
- No Youtube API Key required
- Run audio in VLC with no GUI
See complete and up-to-date changelog here.
These features are still inherited from mps-youtube. - Search and play audio/video from YouTube - Search tracks of albums by album title - Search and import YouTube playlists - Create and save local playlists - Download audio/video - Convert to mp3 & other formats (requires ffmpeg or avconv) - View video comments - Works with Python 3.x - Works with Windows, Linux and Mac OS X - Requires mplayer, mpv or VLC
This project is based on mps-youtube and mps-youtube is based on mps, a terminal based program to search, stream and download music. This implementation uses YouTube as a source of content and can play and download video as well as audio. The pafy library handles interfacing with YouTube.
Screenshots¶
Search:
A standard search is performed by entering /
followed by search terms.
You can play all of the search results by giving 1-
as input
Repeating song/songs can be done with song_number[loop]
, for example:
1[3]
or 4-6[2]
Local Playlists:
Search result items can easily be stored in local playlists.
YouTube Playlists:
YouTube playlists can be searched and played or saved as local playlists.
A playlist search is performed by //
followed by search term.
Download:
Content can be downloaded in various formats and resolutions.
Comments:
A basic comments browser is available to view YouTube user comments.
Music Album Matching:
An album title can be specified and yewtube will attempt to find
matches for each track of the album, based on title and duration. Type
help search
for more info.
Customisation:
Search results can be customised to display additional fields and ordered by various criteria.
This configuration was set up using the following commands
set order views
set columns user:14 date comments rating likes dislikes category:9 views
Type help config
for help on configuration options
Upgrading¶
If installed using pipx¶
pipx upgrade yewtube
If installed using pip¶
pip install --upgrade yewtube
Usage¶
yewtube is run on the command line using the command:
yt
Enter h
from within the program for help.
How to Contribute¶
Contributions are welcomed! However, please check out the contribution page before making a contribution.