A Python program that converts image files, video files, or a webcam stream to Chinese characters.
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.gitignore
LICENSE
README.md
logo.png
mandarinizer.py
player.py
sample_image.jpg
sample_out.txt

README.md

Mandarinizer

A Python program that converts image files, video files or live webcam stream to ASCII-art-inspired Chinese character art.

龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 
龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 
龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 
龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 
龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 
龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 
龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 
龘 龘 龘 龘 龘 龘 龘 龘 龘 丶 丶 丶 龘 龘 龘 龘 龘 龘 龘 龘 丿 丶 丶 太 龘 龘 龘 龘 龘 龘 龘 龘 
龘 龘 龘 龘 龘 龘 龘 龘 丶 丶 丶 丶 丶 龘 龘 龘 龘 龘 龘 丶 丶 丶 丶 丶 龘 龘 龘 龘 龘 龘 龘 龘 
龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 丶 丶 丶 蟲 龘 龘 龘 龘 龘 丶 丶 丶 大 龘 龘 龘 龘 龘 龘 龘 龘 龘 
龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 丶 丶 丶 丶 龘 龘 龘 龘 龘 丶 丶 丶 丶 龘 龘 龘 龘 龘 龘 龘 龘 龘 
龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 丶 丶 丶 丶 龘 龘 龘 龘 丶 丶 丶 丶 丶 龘 龘 龘 龘 龘 龘 龘 龘 龘 
龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 丶 丶 龘 丶 丶 龘 龘 龘 丶 丶 丶 丶 丶 龘 龘 龘 龘 龘 龘 龘 龘 龘 
龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 丶 丶 龘 丶 丶 龘 龘 龘 丶 龘 丿 丶 丶 龘 龘 龘 龘 龘 龘 龘 龘 龘 
龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 丶 丶 龘 丶 丶 龘 龘 丶 丶 龘 壵 丶 丶 龘 龘 龘 龘 龘 龘 龘 龘 龘 
龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 丶 丶 龘 龘 丶 丶 龘 丶 丶 龘 掱 丶 丶 龘 龘 龘 龘 龘 龘 龘 龘 龘 
龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 丶 丶 龘 龘 丶 丶 壵 丶 龘 龘 龘 丶 丶 龘 龘 龘 龘 龘 龘 龘 龘 龘 
龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 丶 丶 龘 龘 丶 丶 丶 丶 龘 龘 龘 丶 丶 龘 龘 龘 龘 龘 龘 龘 龘 龘 
龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 丶 丶 龘 龘 龘 丶 丶 壵 龘 龘 龘 丶 丶 龘 龘 龘 龘 龘 龘 龘 龘 龘 
龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 丶 丶 龘 龘 龘 龘 龘 龘 龘 龘 龘 丶 丶 龘 龘 龘 龘 龘 龘 龘 龘 龘 
龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 丶 丶 龘 龘 龘 龘 龘 龘 龘 龘 龘 丶 丶 龘 龘 龘 龘 龘 龘 龘 龘 龘 
龘 龘 龘 龘 龘 龘 龘 龘 龘 尛 丶 丶 龘 龘 龘 龘 龘 龘 龘 龘 龘 丶 丶 龘 龘 龘 龘 龘 龘 龘 龘 龘 
龘 龘 龘 龘 龘 龘 龘 龘 丶 丶 丶 丶 丶 丶 龘 龘 龘 龘 龘 丶 丶 丶 丶 丶 龘 龘 龘 龘 龘 龘 龘 龘 
龘 龘 龘 龘 龘 龘 龘 龘 丶 丶 丶 丶 丶 丶 龘 龘 龘 龘 丶 丶 丶 丶 丶 丶 丶 龘 龘 龘 龘 龘 龘 龘 
龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 
龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 
龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 
龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 
龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 
龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 
龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 
龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 龘 

Above is a sample output of Mandarinizer logo

Prerequisites

If you only want to use player.py, you can skip this part.

However, in order to use mandarinizer.py, you need to have opencv-python installed. To install the package:

Linux

pip install opencv-python

macOS

Follow the instruction here.

Usage

mandarinizer.py

usage: mandarinizer.py [-h] [--version] [-inv] [-p] [-f] [-s] [-w WIDTH]
                       [-fps FRAMERATE] [-d {2,4,8,16}]
                       [-c CHARACTER [CHARACTER ...]] [-v VIDEO]
                       [-i IMAGE [IMAGE ...]] [-o OUT]

Mandarinize an image file, a video file or a webcam stream.

optional arguments:
  -h, --help            show this help message and exit
  --version             show program's version number and exit
  -inv, --invert        invert the color of the frame
  -p, --preview         toggle preview
  -f, --flip            toggle the vertical flip of the frame
  -s, --space           add a space between every two characters
  -w WIDTH, --width WIDTH
                        specify the width of the output
  -fps FRAMERATE, --framerate FRAMERATE
                        specify the frames per second
  -d {2,4,8,16}, --depth {2,4,8,16}
                        specify the color depth
  -c CHARACTER [CHARACTER ...], --character CHARACTER [CHARACTER ...]
                        specify a list of characters by the order of indensity
  -v VIDEO, --video VIDEO
                        path to the video file
  -i IMAGE [IMAGE ...], --image IMAGE [IMAGE ...]
                        paths to the image files
  -o OUT, --out OUT     path to the ouput file

player.py

usage: player.py [-h] [-fps FRAMERATE] filename

positional arguments:
  filename              path to file

optional arguments:
  -h, --help            show this help message and exit
  -fps FRAMERATE, --framerate FRAMERATE
                        specify the frames per second

License

Mandarinizer is licensed under the MIT License.