Skip to content

Abdullah-hmed/terminal-media-viewer

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

30 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

A Python package for viewing media files in the terminal as Unicode/ASCII art.

Installation

To install the terminal-media-viewer package, run the following commands:

Clone the repository

git clone https://github.com/Abdullah-hmed/terminal-media-viewer.git
cd terminal-media-viewer

Install the package locally:

pip install .

Usage

To use the terminal-media-viewer package, simply run the following command:

mediaviewer <media_file>

Replace <media_file> with the path to the media file you want to view.

Arguments

Argument Description
-w, --width Width of the ASCII art (default: 80)
-bw, --black-white Color the image (default: false)
-hr, --high-resolution High resolution rendering (default: false)
-yt, --youtube-search Search for a YouTube video (default: false)

Example

To view a video file called example.mp4, run the following command:

mediaviewer example.mp4 # Will play the video in the terminal in color

With Arguments:

mediaviewer -w 100 example.mp4  # Will set video width to 100
mediaviewer -bw example.mp4   # Will play the video in the terminal using unicode blocks
mediaviewer -hr example.mp4   # Will play the video in the terminal in high resolution
mediaviewer https://example.com/video.mp4  # Will play the video from a URL
mediaviewer https://example.com/image.jpg  # Will display the image from a URL
mediaviewer -yt "Example Video"  # Will search for a video on YouTube

License

This project is released under the MIT License.

About

Tool to display images and videos in the terminal

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages