https://github.com/botspot/unicode-art
Easily make detailed terminal art with unicode characters in this simple viewer
https://github.com/botspot/unicode-art
Last synced: 4 months ago
JSON representation
Easily make detailed terminal art with unicode characters in this simple viewer
- Host: GitHub
- URL: https://github.com/botspot/unicode-art
- Owner: Botspot
- Created: 2024-03-03T07:42:05.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2024-03-06T21:38:49.000Z (over 1 year ago)
- Last Synced: 2024-03-07T00:25:29.019Z (over 1 year ago)
- Language: Shell
- Size: 14.6 KB
- Stars: 4
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
Would you believe that you can display almost anything in the terminal with enough practice and patience?
The hardest part is finding the perfect text characters to make these shapes. Many of the best ones will display properly in the terminal but not on the browser!
This simple github repository tries to solve that problem with a shell script to clearly display all the useful unicode characters for your ASCII-art needs.
Just download the repo and run the script.
```
git clone https://github.com/Botspot/unicode-art
./unicode-art/viewer.sh
```
This displays all of the useful characters, categorized by shape and type. All characters have been spaced apart for clarity and easy copy-and-paste.
## PRO TIPS:
1. Zoom in to see the characters better. On LXTerminal this is `Ctrl Shift +`.
2. If your normal text editor cannot display these characters, try a command-line text editor like `nano` or `vim`.
3. To color your art use https://misc.flogisoft.com/bash/tip_colors_and_formatting
4. Change the viewer colors by editing the first few lines in `viewer.sh`. With this you can set the foreground color (`fg`), the background color for the whole terminal (`bg`), and the background color for each displayed character (`bk`).
5. If you want maximum-density pixel art, check out the [Braille characters](https://shapecatcher.com/unicode/block/Braille_Patterns). There were too many to include in this script, but use that link to see those. Please [open an issue](https://github.com/Botspot/unicode-art/issues/new/choose) if you would find a new `braille-viewer.sh` script useful.
## Troubleshooting:
1. Question: `Help! the characters are not appearing in the terminal!`
Answer: Try using a newer OS version. Most of these characters are part of Unicode's [Symbols for Legacy Computing](https://en.wikipedia.org/wiki/Symbols_for_Legacy_Computing), and these were added to Linux operating systems only a few years ago.
Run this to check the version of unicode support on your system:
```
file /usr/lib/aarch64-linux-gnu/libicudata.so | sed -n 's/.*libicudata.so.//p'
```
If it is 66 or greater, then everything should render correctly.
2. Question: `Can I make these special characters appear correctly in my web browser my favorite text editor?`
Answer: Yes! Just follow [this tutorial](https://pi-apps.io/install-app/install-color-emoji-font-on-raspberry-pi/) to get the right font package installed. Then close and re-open your programs.