Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/kai-kj/ptmv
An utf-8/truecolor image and video viewer for the terminal
https://github.com/kai-kj/ptmv
image linux python terminal-app terminal-graphics video youtube
Last synced: 13 days ago
JSON representation
An utf-8/truecolor image and video viewer for the terminal
- Host: GitHub
- URL: https://github.com/kai-kj/ptmv
- Owner: kai-kj
- License: mit
- Created: 2020-09-21T09:29:05.000Z (about 4 years ago)
- Default Branch: master
- Last Pushed: 2022-02-18T08:34:39.000Z (almost 3 years ago)
- Last Synced: 2024-10-05T15:35:57.011Z (about 2 months ago)
- Topics: image, linux, python, terminal-app, terminal-graphics, video, youtube
- Language: Python
- Homepage:
- Size: 6.77 MB
- Stars: 40
- Watchers: 1
- Forks: 1
- Open Issues: 2
-
Metadata Files:
- Readme: README-PIP.md
- License: LICENSE
Awesome Lists containing this project
README
Python Terminal Media Viewer
View images and videos without leaving the console
More info on GitHub
----
### Features
* View **images** form any terminal
* Watch **videos** from any terminal
* Watch **youtube** videos from any terminal (`-y`, `--youtube`)
* Play videos at **any fps** (`--fps`) with sound
* **Resize** images / videos (`--width`, `--height`)
* Easy to use
----
### Requirements
* A terminal that supports **truecolor** ([list](https://gist.github.com/XVilka/8346728)) and **utf-8** (most terminals should support utf-8).
----
### Usage
```shell
ptmv FILE [OPTIONS]
```
* **Required arguments**
* `FILE`
File to display/play or youtube url
* **Optional arguments**
* `-y`. `--youtube`
View youtube videos
* `--height`
Set height (setting both `width` and `height` will ignore original aspect ratio)
* `--width`
Set width (setting both `width` and `height` will ignore original aspect ratio)
* `--start-time`
Set start position for video.
* `-f`, `--fps`
Set fps (default 15 fps)
* `-m`, `--mute`
Mute audio
* `-h`, `--help `
Display help