Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/thealexdev23/terminal-video-player
A program that can display video in the terminal using ascii characters
https://github.com/thealexdev23/terminal-video-player
ascii python terminal terminal-app video video-play video-player
Last synced: about 2 months ago
JSON representation
A program that can display video in the terminal using ascii characters
- Host: GitHub
- URL: https://github.com/thealexdev23/terminal-video-player
- Owner: TheAlexDev23
- License: gpl-3.0
- Created: 2022-01-31T16:43:59.000Z (almost 3 years ago)
- Default Branch: main
- Last Pushed: 2022-10-04T21:25:24.000Z (over 2 years ago)
- Last Synced: 2023-05-09T11:57:46.641Z (over 1 year ago)
- Topics: ascii, python, terminal, terminal-app, video, video-play, video-player
- Language: Python
- Homepage:
- Size: 65.4 KB
- Stars: 15
- Watchers: 1
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Terminal Video Player
- This code will allow you to play any video in the terminal!
- Works perfectly with video formats like mkv mp4 and mov formats, other are still left to be tested
- Can download any video of YouTube and play it.
## How to run
### If you want to play a video saved on your computer run the following
```bash
python ./Player.py [Location of the file you want to play]
```
### If you want to play a video from YouTube run the following
```bash
python ./Player.py -y [URL of the YouTube video]
```
#### Or if you want to play the video from YouTube with subtitles there's 2 ways
Play with default subtitles:
```bash
python ./Player.py -y [URL of the YouTube video] -c
```
Play subtitles in a certain language:
```bash
python ./Player.py -y [URL of the YouTube video] -c [lang]
```
## Examples of usage
### Video from computer
```bash
python ./Player.py ~/Videos/NeverGonnaGiveYouUp.mp4
```
### Video from YouTube without subtitles
```bash
python ./Player.py -y "https://www.youtube.com/watch?v=dQw4w9WgXcQ"
```
### Video from YouTube with default subtitles
```bash
python ./Player.py -y "https://www.youtube.com/watch?v=dQw4w9WgXcQ" -c
```
### Video from YouTube with english subtitles
```bash
python ./Player.py -y "https://www.youtube.com/watch?v=dQw4w9WgXcQ" -c en
```
## Things to know before using
- Playing any video would create 2 folders each having `X` amount of jpgs, where `X` is the amount of frames the video has
- Playing a video from YouTube would download it under ``` YouTubeTemporary/video.mp4 ```
- If you already played a video from YouTube and you want to play another one, you need to first delete the video.mp4 from the YouTubeTemporary folder (note, that this is not necessary if you would be playing the same video or a video from your computer)
- If subtitles are not found (maybe because there's no subtitles in the video or not in the specified language), an exception would be thrown
- If the video is not found (maybe because it doesn't exist or there's no internet connection) an exception would also be thrown
### Huge thanks to [talwat](https://github.com/talwat) for the contributions and ideas!