Skip to main content

xart is a pure Python library that provides an easy way to generate art ascii texts. Life is short, be cool.

██╗  ██╗ █████╗ ██████╗ ████████╗
╚██╗██╔╝██╔══██╗██╔══██╗╚══██╔══╝
 ╚███╔╝ ███████║██████╔╝   ██║
 ██╔██╗ ██╔══██║██╔══██╗   ██║
██╔╝ ██╗██║  ██║██║  ██║   ██║
╚═╝  ╚═╝╚═╝  ╚═╝╚═╝  ╚═╝   ╚═╝

### Getting Started

help

$ xart -h
usage: __init__.py [-h] [-f FONT] [-c COLOR] [-i] [-s] [-l] [-v]

xart : generate art ascii texts.

optional arguments:
  -h, --help            show this help message and exit
  -f FONT, --font FONT  font to render with, default random
  -c COLOR, --color COLOR
                        font color, default WHITE, all : BLACK, RED, GREEN,
                        YELLOW, BLUE, PURPLE, CYAN, GRAY, WHITE
  -i, --info            show information of given font
  -s, --show            show random fonts
  -l, --list            list all supported fonts
  -v, --version         version

generate ascii text via random font

$ xart test
    ███        ▄████████    ▄████████     ███
▀█████████▄   ███    ███   ███    ███ ▀█████████▄
   ▀███▀▀██   ███    █▀    ███    █▀     ▀███▀▀██
    ███   ▀  ▄███▄▄▄       ███            ███   ▀
    ███     ▀▀███▀▀▀     ▀███████████     ███
    ███       ███    █▄           ███     ███
    ███       ███    ███    ▄█    ███     ███
   ▄████▀     ██████████  ▄████████▀     ▄████▀

generate ascii text via given font

$ xart test -f 3D_Diagonal

    ___                                 ___
  ,--.'|_                             ,--.'|_
  |  | :,'                            |  | :,'
  :  : ' :               .--.--.      :  : ' :
.;__,'  /      ,---.    /  /    '   .;__,'  /
|  |   |      /     \  |  :  /`./   |  |   |
:__,'| :     /    /  | |  :  ;_     :__,'| :
  '  : |__  .    ' / |  \  \    `.    '  : |__
  |  | '.'| '   ;   /|   `----.   \   |  | '.'|
  ;  :    ; '   |  / |  /  /`--'  /   ;  :    ;
  |  ,   /  |   :    | '--'.     /    |  ,   /
   ---`-'    \   \  /    `--'---'      ---`-'
              `----'

generate ascii text via given color

COLOR

COLOR

show all supported fonts

$ xart -l
xart : generate art ascii texts.

  0. 1Row
  1. 3-D
  ...
  277. Wow

All 278 fonts.

show font infomation

$ xart -i -f Weird
weird.flf (version 2)
by:  Bas Meijer   meijer@info.win.tue.nl   bas@damek.kth.se
fixed by: Ryan Youck   youck@cs.uregina.ca
some special characters '#%*' etc. are not matching, they are from other fonts.
Explanation of first line:
flf2 - "magic number" for file identification
a    - should always be `a', for now
$    - the "hardblank" -- prints as a blank, but can't be smushed
6    - height of a character
5    - height of a character, not including descenders
20   - max line length (excluding comment lines) + a fudge factor
15   - default smushmode for this font (like "-m 15" on command line)
13   - number of comment lines

version

$ xart -v
xart : generate art ascii fonts, version 0.1.5.
  ___      ____       ___
 / _ \    (___ \     / _ \
| | | |     __) )   | | | |
| | | |    / __/    | | | |
| |_| | _ | |___  _ | |_| |
 \___/ (_)|_____)(_) \___/

### Installation

xart is hosted on PYPI and can be installed as such:

$ pip install xart

Alternatively, you can also get the latest source code from GitHub and install it manually:

$ git clone git@github.com:xlzd/xart.git
$ cd xart
$ python setup.py install

For update:

$ pip install xart --upgrade

### License

WTFPL (here)

Release files for xart 0.2.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for xart 0.2.0
File Size Uploaded
xart-0.2.0.tar.gz 451.1 kB Details

Release files / xart-0.2.0.tar.gz

Download URL xart-0.2.0.tar.gz
Size 451.1 kB
Tags Source
SHA-256 checksum
How to use checksums
cab88ad68dc861d78ec4bd3dbeb815f9dcbd3e90972449cd95944442ca6e39aa
BLAKE2b-256 checksum
How to use checksums
df0b607ebe1853f4797714e06917b29aafe9120f309991c607c20b542fc716b7
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No

Release history Release notifications | RSS feed

This release

0.2.0 This release

1 release file

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page