Skip to main content

A python script to exhibit your ascii arts and sytem specs

Project description

XHIBIT

Exhibit your ASCII art and system specs

INSTALLATION

Add Path

Below is an example to add $HOME/.local/bin/ if you use bash shell and your bashrc is in $HOME/.bashrc
Modify the location to whatever shell you are using .
If you use zsh,fish,dash,ksh,or other shells as your default shell change the syntax to add path accordingly.

mkdir -p $HOME/.local/bin
echo 'export PATH="$HOME/.local/bin:$PATH"' >> $HOME/.bashrc
Install Python Package
pip install xhibit

DEPENDENCIES

For Ascii art only

  • python 3.5+

For Image display

  • kitty terminal or ueberzug
  • xorg-xdpyinfo
  • xdotool
  • xorg-xprop
  • xorg-xwininfo

HOW TO USE

usage: xhibit [-h] [-cs CS] [-rcs RCS] [-ccs CCS] [-cn CN] [-rcn RCN] [-cpu CPU] [-gpu GPU] [-img IMG] [-imb IMB] [-crop CROP]

options:
  -h, --help  show this help message and exit
  -cs CS      Colorscheme to display.
  -rcs RCS    Randomize Colorschemes [t or f].
  -ccs CCS    Give custom colorschemem of 8 colors like this "#BF616A,#A3BE8C,#EBCB8B,#81A1C1,#B48EAD,#88C0D0,#E5E9F0,#B48EAD".
  -cn CN      Specify Character name [monalisa,egyptian,fairy,casper,dragon].
  -rcn RCN    Randomize Characters [t or f].
  -cpu CPU    Mention Cpu [Custom Cpu name].
  -gpu GPU    Mention Gpu [Custom Gpu name].
  -img IMG    Image path.
  -imb IMB    Mention Image backend [kitty or ueberzug].
  -crop CROP  Mention crop type [fit or fill].

ASCII characters

ASCII Characters available

  • monalisa
  • egyptian
  • casper
  • fairy
  • dragon

Default colorschemes

  • gruvbox
  • dracula

Extra Colorscheme List present inside this program

Colorscheme list

Example commands

To Choose gruvbox Colorscheme and casper

xhibit -cs gruvbox -cn casper

example2

To Choose dracula Colorscheme and fairy

xhibit -cs dracula -cn fairy

example3

To randomize colorscheme and character

xhibit -rcs t -rcn t

example4

Pick colorscheme

Check Colorscheme list

xhibit -cs "Eighties.dark" -cn dragon

example4

To give custom user colors

You can give custom user colors to xhibit to display text. Must give all the 8 colors in hex format just as shown below. Nord Colorscheme colors are used below as example.

xhibit -ccs "#BF616A,#A3BE8C,#EBCB8B,#81A1C1,#B48EAD,#88C0D0,#E5E9F0,#B48EAD"

example0

DOWNLOAD ALL THE THEMES AND SEE WITH FZF

git clone https://github.com/glowfi/xhibit-colorschemes
mv ~/xhibit-colorschemes/themes ~/.cache
rm -rf xhibit-colorschemes
ls ~/.cache/themes| fzf | xargs -I {} cat ~/.cache/themes/{} | xargs | tr " " "," | xargs -I {} xhibit -rcn t  -ccs "{}"

Try all colorscheme in 1 second interval

wget https://raw.githubusercontent.com/glowfi/xhibit-colorschemes/main/run.sh -O ~/.cache/xhibitCol.sh
sh ~/.cache/xhibitCol.sh

Image support with ueberzug or kitty terminal.

xhibit -img image_location -imb "kitty"

                or

xhibit -img image_location -imb "ueberzug"

Image crop fit or fill

xhibit -img image_location -imb "kitty" -crop "fit"
xhibit -img image_location -imb "kitty" -crop "fill"

                or

xhibit -img image_location -imb "ueberzug" -crop "fit"
xhibit -img image_location -imb "ueberzug" -crop "fill"

example1

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

xhibit-9.7.0.tar.gz (35.0 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

xhibit-9.7.0-py3-none-any.whl (35.8 kB view details)

Uploaded Python 3

File details

Details for the file xhibit-9.7.0.tar.gz.

File metadata

  • Download URL: xhibit-9.7.0.tar.gz
  • Upload date:
  • Size: 35.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.11.3

File hashes

Hashes for xhibit-9.7.0.tar.gz
Algorithm Hash digest
SHA256 6c1bdc3e7f4d0129a918e206b8d4d5566f8dac76bb248f679bdc97ce3cf10855
MD5 c2c06fbab37f31e1e2142d1b7a48d8e7
BLAKE2b-256 0d09d55a8f65d4db48786da67585992bd3124eb446b9e4a83537e0e2c93e8bbb

See more details on using hashes here.

File details

Details for the file xhibit-9.7.0-py3-none-any.whl.

File metadata

  • Download URL: xhibit-9.7.0-py3-none-any.whl
  • Upload date:
  • Size: 35.8 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.11.3

File hashes

Hashes for xhibit-9.7.0-py3-none-any.whl
Algorithm Hash digest
SHA256 794cec7aef54393351dd04fdc7650e6393a130897562750e2c80c2c5e1086be9
MD5 6d05dbe6ddbfd880ef0828db9355f7d5
BLAKE2b-256 5e0a8e628c980474d4181b6d9831544f0baf5aae8dda80d5d36297b0f792190c

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page