Skip to content

A tool for converting images or videos or webcam feed to ASCII

License

Notifications You must be signed in to change notification settings

zhoudaxia233/PyAscii

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

40 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

PyAscii

Some Amazing examples

1. A Beautiful Girl drawed by me
2. Famous Yaoming's Face
3. My Avatar


To do list

  • Asciify an image into txt & html
  • Asciify a video
  • Improve ascii video quality (by thresholding???)
  • Asciify webcam feed

Requirements

  1. Python >= 3.6
  2. opencv-python >= 4.0.0 (It will automatically be installed when you install pyascii)

Installation

Install pyascii:

pip install pyascii

Usage

1. Asciify an image

pyascii avatar.png

You can use -s or --scaling_ratio to specify the scaling ratio of the output with respect to the input image. The default value is 0.5.

pyascii avatar.png -s 0.1

You can use -o or --output_format to specify the format of the output file.

0 represents for .txt format
1 represents for .html format
2 represents for both .txt format & .html format

The default value is 1.

pyascii avatar.png -o 0

You can use -lh or --line_height to specify the height of each line of ascii characters in the output file. The default value is 0.65.

Note: It only works for html format output.

pyascii avatar.png -lh 0.65

You can use -fs or --font_size to specify the font size of ascii characters in the output file. The default value is 5.

Note: It only works for html format output.

pyascii avatar.png -fs 8

2. Asciify a video

pyascii demo.mp4

You can use -s or --scaling_ratio to specify the scaling ratio of the output with respect to the input. The default value is 0.5.

pyascii demo.mp4 -s 0.1

3. Asciify your webcam feed

pyascii webcam

You can use -s or --scaling_ratio to specify the scaling ratio of the output with respect to the input. The default value is 0.5.

pyascii webcam -s 0.1