Python Terminal Media Viewer

View images and videos without leaving the console

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

Examples

Viewing an image

Watching a video

Requirements

• A terminal that supports truecolor (list) and utf-8 (most terminals should support utf-8).
• libasound2-dev / alsa-lib
  • for Ubuntu: apt install libasound2-dev
  • for Arch Linux: pacman -S alsa-lib
• ffmpeg
  • for Ubuntu: apt install ffmpeg
  • for Arch Linux: pacman -S ffmpeg

Installation

pip install ptmv

Usage

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

Contributing

Any contributions are greatly appreciated.

kal39(https://github.com/kal39) - [email protected] Distributed under the MIT license. See LICENSE for more information.