https://github.com/kal39/ptmv

An utf-8/truecolor image and video viewer for the terminal
https://github.com/kal39/ptmv

image linux python terminal-app terminal-graphics video youtube

Last synced: 2 months ago
JSON representation

An utf-8/truecolor image and video viewer for the terminal

• Host: GitHub
• URL: https://github.com/kal39/ptmv
• Owner: kal39
• License: mit
• Created: 2020-09-21T09:29:05.000Z (almost 4 years ago)
• Default Branch: master
• Last Pushed: 2022-02-18T08:34:39.000Z (over 2 years ago)
• Last Synced: 2024-03-01T05:36:45.439Z (4 months ago)
• Topics: image, linux, python, terminal-app, terminal-graphics, video, youtube
• Language: Python
• Homepage:
• Size: 6.77 MB
• Stars: 37
• Watchers: 1
• Forks: 1
• Open Issues: 2
• Metadata Files:
  • Readme: README-PIP.md
  • License: LICENSE

Lists

• awesome - ptmv - An utf-8/truecolor image and video viewer for the terminal (Python)

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