https://github.com/lemonyte/terminal-player

Play videos and render images in the terminal as text.
https://github.com/lemonyte/terminal-player

ansi ascii image pyco python terminal video

Last synced: 26 days ago
JSON representation

Play videos and render images in the terminal as text.

• Host: GitHub
• URL: https://github.com/lemonyte/terminal-player
• Owner: lemonyte
• License: mit
• Created: 2023-08-14T03:45:56.000Z (over 1 year ago)
• Default Branch: main
• Last Pushed: 2024-08-31T02:25:54.000Z (2 months ago)
• Last Synced: 2024-10-07T19:28:50.815Z (about 1 month ago)
• Topics: ansi, ascii, image, pyco, python, terminal, video
• Language: Python
• Homepage:
• Size: 7.81 KB
• Stars: 3
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: readme.md
  • License: license.txt

Awesome Lists containing this project

README

        
# Terminal Player

Play videos and render images in the terminal as text.

Written in pure Python, works on any platform.

https://github.com/lemonyte/terminal-player/assets/49930425/889c2489-9e40-4028-8e88-d7af4b34e785

## Requirements

- [Python 3.9](https://www.python.org/downloads/) or higher

- Packages listed in [`requirements.txt`](requirements.txt)

## Usage

First process a file.

```shell

# Image

python process.py path/to/image.png path/to/processed.dat

# Video

python process.py path/to/video.mp4 path/to/processed.dat --video

```

Use `--width` to set the frame width in columns, and `--video` to process videos.

Then render the file.

```shell

python render.py path/to/processed.dat

```

Use `--fps` to set the desired refresh rate for videos, and `--loop` to play a video on loop.

## License

[MIT License](license.txt)