Skip to main content

Stream youtube playlists as audio on linux terminal

Project description

ytTerm player (BETA)

Play youtube playlists as audio on linux terminal

Build Status PyPI version PyPI pyversions PyPI license

About

ytTerm player is a terminal youtube music player. It's completely written in python.

UI: Made using a wrapper for curses called urwid

Player: Handled using python-mpv

Stream fetch: Audio streams from youtube are fetched using pafy

Features:

  • Import and play youtube playlists on terminal
  • Save playlists in library
  • Use several playback modes such as repeat one, repeat list, random
  • Download complete list (coming soon)

Installation

Set up a virtual environment and install the dependencies:

$ pip install -r requirements.txt

python3 pip :-

$ pip install ytermplayer
$ yterm

or Git clone :-

$ git clone https://github.com/TimeTraveller-San/yTermPlayer
$ cd yTermPlayer/yTermPlayer/
$ python __main__.py

Dependencies

Python 3

ytTerm player uses a number of open source projects to work properly:

ytTerm player itself is open source. Feel free to modify and distribute the code

KeyBindings

Key Function
s save current list
enter select option/play song at selection
n play next song
p play previous song
space pause/play song
u volume up
d volume down
q quit
1 playback mode: Repeat one
2 playback mode: Repeat list
3 playback mode: None
r playback mode: Random
more features coming soon

Screenshots

Working video: https://youtu.be/rQpO1qBmxlY

Working video 2: https://youtu.be/bQrNtcIcHc0

Start screen :

Start Screem

The UI will automatically use your terminal colors.

Blue Yellow

FAQ

  • How to fix out of range/url not found errors?

YouTube keeps changing its structure so it's important you have installed the latest version of youtube-dl as follows: pip install --upgrade youtube_dl

  • Where are my playlists stored and how to delete playlists?

Playlists are saved in $HOME/.yTermPlayer/playlists as plain text. You may delete or add new playlists directly here.

  • How to contact me?

Email: time.traveller.san@gmail.com Twitter: https://twitter.com/timetravellertt

Known Bugs

  • Buggy / unexpected playback behavior It was caused because of race conditions and absence of critical section among the threads. Fixed it using semaphores

  • If some VLC error starts showing up on the screen, just resize the terminal and it will be gone Completely removed VLC and replaced it with much more minimal and faster mpv player. Thank to python-mpv by jaseg

Project details


Download files

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

Source Distribution

yTermPlayer-1.2.2.tar.gz (10.6 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

yTermPlayer-1.2.2-py3-none-any.whl (23.7 kB view details)

Uploaded Python 3

File details

Details for the file yTermPlayer-1.2.2.tar.gz.

File metadata

  • Download URL: yTermPlayer-1.2.2.tar.gz
  • Upload date:
  • Size: 10.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.12.1 pkginfo/1.4.2 requests/2.22.0 setuptools/40.6.3 requests-toolbelt/0.8.0 tqdm/4.26.0 CPython/3.6.8

File hashes

Hashes for yTermPlayer-1.2.2.tar.gz
Algorithm Hash digest
SHA256 b2a5c124e192b958134cccb9080ee7b664f341effb07e397504edcd750a5e9e5
MD5 d33273152f32c25db3c975f2459778c5
BLAKE2b-256 5f51327782848198bcdb3f3005601e0106257b10d209cd626ac33b7f006cda1b

See more details on using hashes here.

File details

Details for the file yTermPlayer-1.2.2-py3-none-any.whl.

File metadata

  • Download URL: yTermPlayer-1.2.2-py3-none-any.whl
  • Upload date:
  • Size: 23.7 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.12.1 pkginfo/1.4.2 requests/2.22.0 setuptools/40.6.3 requests-toolbelt/0.8.0 tqdm/4.26.0 CPython/3.6.8

File hashes

Hashes for yTermPlayer-1.2.2-py3-none-any.whl
Algorithm Hash digest
SHA256 2346a5732f059612d6fb93a1a5be80e549bf08a388d0f63642abe53cf771de75
MD5 462dc116dce7c2a3b4a96a9fd73c3e5c
BLAKE2b-256 2f510d423536105fb88a89bacfac36af4fde95c91d52d809e2955caddff1b66c

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page