Skip to main content
Pre-release

This release is a pre-release and may not be stable for production use.

Bvatar creates a unique 8x8 graphical representation of a string.

Setup

Install from PYPI

Install with the following pip command:

pip install bvatar

Or if you want to be able to create bitmap images, use this instead:

pip install bvatar[bitmap]

Install development version

Download from github and install the development version with these commands:

git clone https://github.com/smileychris/bvatar
cd bvatar
pip install -e .[bitmap]

Usage

Import the bvatar class and use it like so:

from bvatar import Bvatar bvtr = Bvatar(‘text’) img = bvtr.image() img.save(‘some_file.png’, ‘PNG’)

Command-line Script

Generate a Bvatar (an 8x8 randomart avatar).

Usage:

bvatar [--mirror] [--no-color] [--px-size=<int>] ([TEXT] | [--hash=<sha1_hash>])
bvatar --ascii [--mirror] [--spaced] [--no-border] ([TEXT] | [--hash=<sha1_hash>])

The first format is for generating bitmap images. By default, the image is only displayed and not stored. To save the image, pipe to a file:

bvatar > some_file.png

Arguments:

TEXT

bvatar source text (otherwise a random bvatar is generated)

Options:

--mirror

generate a horizontally mirrored bvatar

--no-color

use greyscale rather than coloring the image

--px-size=<int>

actual size for each pixel [default: 16]

--hash=<sha1_hash>

rather than passing the text and having it SHA1ed, you can pass a hex encoded SHA1 hash explicitly

--ascii

output ascii rather than generating a bitmap image

--spaced

a “lighter” ascii art alternative

--no-border

don’t add a border around the ascii art

Release files for bvatar 1.0.a5

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

Source distribution (sdist)

Source distribution for bvatar 1.0.a5
File Size Uploaded
bvatar-1.0.a5.tar.gz 4.8 kB Details

Release files / bvatar-1.0.a5.tar.gz

Download URL bvatar-1.0.a5.tar.gz
Size 4.8 kB
Tags Source
SHA-256 checksum
How to use checksums
083546b5561aa26d05a622482c78b4181300cc3a86c8f7a15b668cfda03cec86
BLAKE2b-256 checksum
How to use checksums
476fd08dfd02d6b36d3f17851a70586b0bb1743cff9d1627f057adf7029b5800
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
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