---

Overview

ASCII art is also known as "computer text art". It involves the smart placement of typed special characters or letters to make a visual shape that is spread over multiple lines of text.

ART is a Python lib for text converting to ASCII art fancy. ;-)

Open Hub
PyPI Counter
Github Stars
Font Counter	677
1-Line-Art Counter	711
Decor Counter	218

Branch	master	dev
CI

Code Quality

Usage

1-Line art

⚠️ Some environments don't support all 1-Line arts

⚠️ ART 4.6 is the last version to support Bipartite art

1. art

This function return 1-line art as str in normal mode and raise artError in exception.
```pycon

from art import * art1=art("coffee") # return art as str in normal mode print(art1) c[] art2=art("woman",number=2) # return multiple art as str print(art2) ▓⚗⚗▓ ▓⚗⚗▓ art("coffee", number=3, space=5) 'c[] c[] c[]' art("random") # random 1-line art mode '(っ◕‿◕)っ ' art("rand") # random 1-line art mode 't(-_-t) ' art(22,number=1) # raise artError Traceback (most recent call last): ... art.art.artError: The 'artname' type must be str.

```

2. aprint

This function print 1-line art in normal mode (return None) and raise artError in exception. ```pycon

aprint("butterfly") # print art Ƹ̵̡Ӝ̵̨̄Ʒ aprint("happy") # print art ۜ(סּںסּَ)/ۜ aprint("coffee", number=3, space=5) c[_] c[_] c[_] aprint("random") # random 1-line art mode '(っ◕‿◕)っ ' aprint("rand") # random 1-line art mode 't(-_-t) ' aprint("woman",number="22") # raise artError Traceback (most recent call last): ... art.art.artError: The 'number' type must be int. ``

3. randart

randart function is added in Version 2.2 as art("random") shortcut. ```pycon

randart() 'ዞᏜ℘℘Ꮍ ℬℹℛʈዞᗬᏜᎽ ' randart() '✌(◕‿-)✌ ' ```

ℹ️ Use ART_NAMES to access all arts name list (new in Version 4.2)

ℹ️ Use NON_ASCII_ARTS to access all Non-ASCII arts name list (new in Version 4.6)

ℹ️ Use ASCII_ARTS to access all ASCII arts name list (new in Version 5.7)

ASCII text

⚠️ Some fonts don't support all characters

⚠️ From Version 3.3 Non-ASCII fonts added (These fonts are not compatible with some environments)

⚠️ From Version 5.3 \n is used as the default line separator instead of \r\n (Use sep parameter if needed)

1. text2art

This function return ASCII text as str in normal mode and raise artError in exception. ```pycon

Art=text2art("art") # Return ASCII text (default font) and default chrignore=True print(Art) _
_ _ _ __ | |_ / ` || '|| _| | (| || | | | _,||| _|

Art=text2art("art",font='block',chr_ignore=True) # Return ASCII text with block font print(Art)

.----------------. .----------------. .----------------. | .--------------. || .--------------. || .--------------. | | | __ | || | _______ | || | _________ | | | | / \ | || | |_ __ \ | || | | _ _ | | | | | / /\ \ | || | | |) | | || | |/ | | _| | | | | / _ \ | || | | __ / | || | | | | | | | / / \ _ | || | _| | \ _ | || | _| | | | | ||_| ||| || | || || | || | |_____| | | | | | || | | || | | | | '--------------' || '--------------' || '--------------' | '----------------' '----------------' '----------------'

Art=text2art("test","random") # random font mode print(Art) | | ~|~/~/(~~|~ | \/__) |

Art=text2art("test","rand") # random font mode print(Art)

---

| |___ [__ |
| |___ ___] |

print(text2art("test", space=10)) _ _
| |_ ___ ___ | |_ | | / _ \ / _| | _| | |_ | _/ _ \ | |_ __| _| |__/ _|

print(text2art('''Lorem
ipsum dolor''', font="small")) # Multi-line print _
| | ___ _ _ ___ _ __
| |__ / _ | '|/ -)| ' \
|___|_/|| __|||||

_
() _ _ ___ _ _ _ __
| || '_ (-<| || || ' \
||| ./// _,||||| ||
_ _
_| | ___ | | ___ _ _ / ` |/ _ | |/ _ | '| _,|_/|_|_/|_|

print(text2art("test","whitebubble")) # Non-ASCII font example ⓣⓔⓢⓣ text2art("art",font="fancy5",decoration="barcode1") # decoration parameter is added in Version 4.6 '▌│█║▌║▌║ ᏗᏒᏖ ║▌║▌║█│▌' text2art("seسسس",font=DEFAULTFONT,chr_ignore=False) # raise artError in exception Traceback (most recent call last): ... art.art.artError: س is invalid.

```

2. tprint

This function print ASCII text in normal mode (return None) and raise artError in exception. ```pycon

tprint("art") # print ASCII text (default font) _
__ _ _ __ | |_ / ` || '|| _| | (| || | | | _,||| _|

tprint("art",font="block",chr_ignore=True) # print ASCII text (block font)

.----------------. .----------------. .----------------. | .--------------. || .--------------. || .--------------. | | | __ | || | _______ | || | _________ | | | | / \ | || | |_ __ \ | || | | _ _ | | | | | / /\ \ | || | | |) | | || | |/ | | _| | | | | / _ \ | || | | __ / | || | | | | | | | / / \ _ | || | _| | \ _ | || | _| | | | | ||_| ||| || | || || | || | |_____| | | | | | || | | || | | | | '--------------' || '--------------' || '--------------' | '----------------' '----------------' '----------------'

tprint('testسس') # chrignore flag ==True (Default) _ _
| | ___ ___ | |_ | | / _ \/ _|| _| | |_ | _/_ | |_ __| _||__/ _|

tprint("test","random") # random font mode | | ~|~/~/(~~|~ | \/__) |

tprint("test","rand") # random font mode

---

| |___ [__ |
| |___ ___] |

tprint("test", space=10) _ _
| |_ ___ ___ | |_ | | / _ \ / _| | _| | |_ | _/ _ \ | |_ __| _| |__/ _|

tprint('testسس',chr_ignore=False) # raise artError in exception Traceback (most recent call last): ... art.art.artError: س is invalid. tprint('''Lorem
ipsum dolor''', font="cybermedium") # Multi-line print

---

| | | |/ |_ |\/|
|___ || | \ |_ | |

---

| |] [ | | |\/|
| | __] |_| | |

---

| \ | | | | | |/ |/ || |_ |__| | \

tprint("art",font="fancy5",decoration="barcode1") # decoration parameter is added in Version 4.6 ▌│█║▌║▌║ ᏗᏒᏖ ║▌║▌║█│▌ tprint("art",font="fancy5",decoration="random") # decoration random mode is added in Version 5.0 •]•·✦º✦·»ᏗᏒᏖ«·✦º✦·•[• ```

3. tsave

This function return dict in normal and exception mode. ```pycon

Response=tsave("art",filename="test.txt") # save ASCII text in test.txt file with save message (printstatus==True), return dict Saved! Filename: test.txt Response["Message"] 'OK' Response=tsave("art",filename="test.txt",printstatus=False) # save ASCII text in test.txt file without save message (printstatus==False) Response["Message"] 'OK' Response["Status"] True tsave(22,font=DEFAULTFONT,filename="art",chrignore=True,printstatus=True) {'Status': False, 'Message': "'int' object has no attribute 'split'"} Response=tsave("art",filename="test.txt",overwrite=True) # overwrite parameter is added in Version 4.0 Saved! Filename: test.txt Response=tsave("art",filename="test.txt",decoration="barcode1") # decoration parameter is added in Version 4.6 Saved! Filename: test.txt Response=tsave("art",filename="test.txt",sep="\r\n") # sep parameter is added in Version 5.3 Saved! Filename: test.txt
Response=tsave("art",filename="test.txt",space=5) # space parameter is added in Version 6.0 Saved! Filename: test.txt
```

ℹ️ Use FONT_NAMES to access all fonts name list (new in Version 4.2)

ℹ️ Use NON_ASCII_FONTS to access all Non-ASCII fonts name list (new in Version 4.4)

ℹ️ Use ASCII_FONTS to access all ASCII fonts name list (new in Version 5.7)

Line

1. lprint

This function prints a grid (length by height) of any given character in normal mode and raise artError in exception. ```pycon

lprint(length=15, height=2, char="*")

---

---

```

ℹ️ New in Version 6.4

ℹ️ The default values are length=15, height=1, char='#'

2. line

This function returns a grid (length by height) of any given character as str in normal mode and raise artError in exception. ```pycon

line(length=15, height=2, char="") '***********\n************' ```

ℹ️ New in Version 6.4

ℹ️ The default values are length=15, height=1, char='#'

Decoration

⚠️ Some environments don't support all decorations

1. decor

This function return decoration as str in normal mode and raise artError in exception. ```pycon

decor("barcode1") '▌│█║▌║▌║ ' decor("barcode1",reverse=True) ' ║▌║▌║█│▌' decor("barcode1") + text2art(" art ",font="fancy42") + decor("barcode1",reverse=True) '▌│█║▌║▌║ ąяţ ║▌║▌║█│▌' decor("barcode1",both=True) # both parameter is added in Version 5.0 ['▌│█║▌║▌║ ', ' ║▌║▌║█│▌'] decor("random",both=True) # random mode is added in Version 5.0 ['｢(◔ω◔「)三', '三三三ʅ(；◔౪◔)ʃ'] decor("rand",both=True) # random mode is added in Version 5.0 ['‹–…·´·…–›', '‹–…·´·…–›'] decor(None) Traceback (most recent call last): ... art.art.artError: The 'decoration' type must be str. ```

ℹ️ Use DECORATION_NAMES to access all decorations name list (new in Version 4.6)

Font modes

These modes are available for text2art, tprint & tsave.

1. Font name

⚠️ Some fonts don't support all characters

```pycon

tprint("art",font="block",chr_ignore=True)

.----------------. .----------------. .----------------. | .--------------. || .--------------. || .--------------. | | | __ | || | _______ | || | _________ | | | | / \ | || | |_ __ \ | || | | _ _ | | | | | / /\ \ | || | | |) | | || | |/ | | _| | | | | / _ \ | || | | __ / | || | | | | | | | / / \ _ | || | _| | \ _ | || | _| | | | | ||_| ||| || | || || | || | |_____| | | | | | || | | || | | | | '--------------' || '--------------' || '--------------' | '----------------' '----------------' '----------------'

tprint("art","white_bubble") ⓐⓡⓣ

```

2. Random

Randomly select from all fonts.

Keywords : random, rand & rnd

```pycon

tprint("test",font="random") | | ~|~/~/(~~|~ | \/__) |

```

3. Random small

Randomly select from small fonts.

Keywords : rnd-small, random-small & rand-small

ℹ️ New in Version 2.8

```pycon

tprint("test",font="rnd-small")

_/ _ _ _/ / (- _) /

```

4. Random medium

Randomly select from medium fonts.

Keywords : rnd-medium, random-medium & rand-medium

ℹ️ New in Version 2.8

```pycon

tprint("test",font="rnd-medium")

, ,
|| ||
=||= - -, =||= || || \ ||. ||
|| ||/ ~ || ||
\, \,/ ,-- \,

```

5. Random large

Randomly select from large fonts.

Keywords : rnd-large, random-large & rand-large

ℹ️ New in Version 2.8

```pycon

tprint("test",font="rnd-large")

8888888 8888888888 8 8888888888 d888888o. 8888888 8888888888 8 8888 8 8888 .8888:'88. 8 8888
8 8888 8 8888 8.8888. Y8 8 8888 8 8888 8 88888.8888. 8 8888 8 8888 8 8888888888888.8888. 8 8888 8 8888 8 88888.8888. 8 8888 8 8888 8 88888.8888. 8 8888 8 8888 8 8888 8b8.8888. 8 8888 8 8888 8 88888b. ;8.8888 8 8888 8 8888 8 888888888888Y8888P ,88P' 8 8888

```

6. Random xlarge

Randomly select from xlarge fonts.

Keywords : rnd-xlarge, random-xlarge & rand-xlarge

ℹ️ New in Version 2.8

```pycon

tprint("test","rnd-xlarge") _____ _____ _____ _____
/\ \ /\ \ /\ \ /\ \
/::\ \ /::\ \ /::\ \ /::\ \
:::\ \ /::::\ \ /::::\ \ :::\ \
:::\ \ /::::::\ \ /::::::\ \ :::\ \
:::\ \ /:::/:::\ \ /:::/:::\ \ :::\ \
:::\ \ /:::/:::\ \ /:::/:::\ \ :::\ \
/::::\ \ /::::\ :::\ \ :::\ :::\ \ /::::\ \
/::::::\ \ /::::::\ :::\ \ :::\ :::\ \ /::::::\ \
/:::/:::\ \ /:::/:::\ :::\ \ /\ :::\ :::\ \ /:::/:::\ \ /:::/ :::_\/:::/:::\ :::_\/::\ :::\ :::_\ /:::/ :::_\ /:::/ ::/ /:::\ :::\ ::/ /:::\ :::\ ::/ / /:::/ ::/ / /:::/ / \// :::\ :::\ \// :::\ :::\ \// /:::/ / \// /:::/ / :::\ :::\ \ :::\ :::\ \ /:::/ /
/:::/ / :::\ :::_\ :::\ :::_\ /:::/ /
::/ / :::\ ::/ / :::\ /:::/ / ::/ /
\// :::\ \// :::\/:::/ / \//
:::\ \ ::::::/ /
:::_\ ::::/ /
::/ / ::/ /
\/_/ \/_/

```

7. Wizard

This mode consider length of input text to select font

☑️ Support of 95 ASCII characters guaranteed

Keywords : wizard, wiz & magic

ℹ️ New in Version 2.9

```pycon

tprint("1","wizard") 88 ,d88 888888 88 88 88 88 88 88 88

tprint("1"*5,"wizard") d88 d88 d88 d88 d88
88 88 88 88 88
88 88 88 88 88
88 88 88 88 88
88 88 88 88 88
d88P d88P d88P d88P d88P

tprint("1"*15,"wizard")

# # # # # # # # # # # # # # #

## ## ## ## ## ## ## ## ## ## ## ## ## ##

# # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # #

## ## ## ## ## ## ## ## ## ## ## ## ## ##

```

8. Random Non-ASCII

Randomly select from Non-ASCII fonts.

Keywords : random-na, rand-na & rnd-na

ℹ️ New in Version 3.4

```pycon

tprint("test","random-na") ₮Ɇ₴₮ tprint("test","random-na") ʇsǝʇ

```

9. Mix Non-ASCII

Randomly mix Non-ASCII fonts.

Keywords : mix

ℹ️ New in Version 3.7

```pycon

tprint("test","mix") †Ɛѕ† tprint("test","mix") tᏋѕt tprint("test","mix") ꓄єร꓄ ```

⚠️ Non-ASCII fonts are only available in Font name, Random Non-ASCII and Mix modes

Typo-tolerance

Levenshtein distance used in this project. (Version >0.9)

```pycon

aprint("happi") # correct --> aprint("happy"), error < |artname|/2 ۜ(סּںסּَ` )/ۜ Art=art("birds2222222",number=1) # correct --> Art=art("birds",number=1), error >= |artname|/2 Traceback (most recent call last): ... art.art.artError: Invalid art name. aprint("happi231") # correct --> aprint("happy"), error < |artname|/2 ⎦˚◡˚⎣ aprint("happi2312344") # correct --> aprint("happy"), error >= |artname|/2 Traceback (most recent call last): ... art.art.artError: Invalid art name. Art=text2art("test",font="black") # correct --> Art=text2art("test",font="block") print(Art)

.----------------. .----------------. .----------------. .----------------. | .--------------. || .--------------. || .--------------. || .--------------. | | | _________ | || | _________ | || | _______ | || | _________ | | | | | _ _ | | || | |_ ___ | | || | / ___ | | || | | _ _ | | | | | |/ | | _| | || | | | _| | || | | (__ _| | || | |/ | | _| | | | | | | | || | | _| _ | || | '.`-. | || | | | | | | | | | | || | _| |/ | | || | |`_) | | || | | | | | | | || | || | |___| | || | |_.' | || | |__| | | | | | || | | || | | || | | | | '--------------' || '--------------' || '--------------' || '--------------' | '----------------' '----------------' '----------------' '----------------'

tprint("test",font="cybermedum") # correct --> tprint("test",font="cybermedium")

---

| |___ [__ |
| |___ ___] |

```

Set defaults

set_default function is added in Version 2.2 in order to change default values.

```pycon

help(setdefault) Help on function setdefault in module art.art:

setdefault(font='standard', chrignore=True, filename='art', print_status=True, overwrite=False, decoration=None, sep='\n') Change text2art, tprint and tsave default values.

:param font: input font
:type font:str
:param chr_ignore: ignore not supported character
:type chr_ignore:bool
:param filename: output file name (only tsave)
:type filename:str
:param print_status : save message print flag (only tsave)
:type print_status:bool
:param overwrite : overwrite the saved file if true (only tsave)
:type overwrite:bool
:param decoration: input decoration
:type decoration:str
:param sep: line separator char
:type sep: str
:return: None

tprint("test") _ _
| |_ ___ ___ | |_ | | / _ \/ _|| _| | |_ | _/_ | |_ __| _||__/ _|

set_default(font="italic") tprint("test")

_/ _ _ _/ / (- _) /

```

ℹ️ Functions error response updated in Version 0.8

Function	Normal Output	Error
decor	str	raise artError
art	str	raise artError
aprint	None	raise artError
tprint	None	raise artError
tsave	{"Status":bool,"Message":str}	{"Status":bool,"Message":str}
text2art	str	raise artError
lprint	None	raise artError
line	str	raise artError
set_default	None	raise artError

Testing

• Only ASCII fonts and arts : art test

• All fonts, arts and decorations : art test2

CLI

⚠️ [Backward Compatibility] ART 5.9 is the last version to support this CLI structure officially

⚠️ You can use art or python -m art to run this mode

• List of arts : art list or art arts
• List of fonts : art fonts
• Text : art text [yourtext] [fontname(optional)]
• Art : art shape [artname] or art art [artname]
• Save : art save [yourtext] [fontname(optional)]
• All : art all [yourtext]

Telegram bot

Just send your text to one of these bots. 👇👇👇👇

Try ART in your browser

1. ART can be used online in interactive Jupyter Notebooks via the Binder service! Try it out now! :
   

• Open FontList.ipynb, ArtList.ipynb and DecorList.ipynb
• Edit and execute each part of the notes, step by step from the top panel by run button

1. ART also can be used online in ascii-generator.site, a Django website by hermanTenuki
   

Screen record

• View full font list (Link1,Link2)
  
• View full art list (Link1,Link2)
• View full decoration list (Link1,Link2)

Issues & bug reports

1. Fill an issue and describe it. We'll check it ASAP!
   • Please complete the issue template
2. Discord : https://discord.com/invite/FAAyq3QJqP
3. Website : https://www.ascii-art.site
4. Email : info@ascii-art.site

References

1. FIGlet
2. 1 Line Art
3. Text to ASCII
4. ASCII Generator
5. Asky
6. Flipyourtext
7. YayText
8. Coolletters
9. Instagram Fonts
10. Cool Symbol
11. ASCII Moji
12. SMILEY COOL
13. SPREZZ
14. Textart4u
15. Chat4o
16. Findwebapp
17. Hubpages
18. ASCII-ART
19. Messletters
20. Webestools
21. ASCII-emoji
22. Instagram Fonts2
23. Emotiworld
24. Fancy Text Pro
25. Playing Cards in Unicode
26. Text Generator
27. GOGOTEXT
28. Fsymbols
29. Font Copy and Paste
30. Mega Cool Text
31. ToolCalculator
32. Copy Paste Fonts

Show your support

Star this repo

Give a ⭐️ if this project helped you!

Donate to our project

If you do like our project and we hope that you do, can you please support us? Our project is not and is never going to be working for profit. We need the money just so we can continue doing what we do ;-) .

Become a sponsor to ART

• Contact us at the email first

Corporate sponsor

• $250 a month
• Your company's logo can be featured on Readme
• Intended for small companies

Mega corporate sponsor

• $500 a month
• Your company's logo can be featured on Readme and Website
• Intended for medium-sized companies

Acknowledgments

Some parts of the infrastructure for this project are supported by:

Python Software Foundation (PSF) grants ART library from version 6.3 to 6.6. PSF is the organization behind Python. Their mission is to promote, protect, and advance the Python programming language and to support and facilitate the growth of a diverse and international community of Python programmers.