terminal ascii video player
light reduced to symbols
Nyx is a terminal-based video player that renders videos frame-by-frame
using ASCII symbols and true-color ANSI output.
it supports:
• local video files
• youtube videos
• audio playback
• adaptive terminal resizing
Nyx works best in darkness.
python main.py• reads video frames using opencv
• converts pixels to brightness
• maps brightness to ascii characters
• renders frames using 24-bit ANSI colors
• syncs audio using ffpyplayer
every frame is redrawn inside your terminal.
nyx supports multiple ascii rendering styles:
• regular — balanced contrast
• inverse — dark-first visuals
• monochrome — extreme minimalism
choose the one that fits your video.
• maintain aspect ratio
• use maximum terminal space
Nyx automatically adapts to your terminal size.
Tip
Use the Terminal in Full Screen for the best results
• local video files
• youtube links (auto-download)
install dependencies:
pip install -r requirements.txt