a2m/README.md

49 lines
1.5 KiB
Markdown
Raw Normal View History

2016-09-07 15:23:12 -07:00
# a2m
Convert ansi art to mirc art.
2016-09-07 15:48:47 -07:00
![screenshot](https://github.com/tat3r/a2m/blob/master/screenshot.png?raw=true)
2016-09-09 12:22:02 -07:00
For reference screenshot is iTerm2 with Menlo font ssh'd to a linux
2016-09-07 18:34:05 -07:00
machine attached to a tmux session running irssi.
2016-09-07 15:23:12 -07:00
## Installation
run make and copy a2m wherever you want.
## Usage
run a2m -h for a list of options
## Troubleshooting
### IRC Client
2016-09-12 15:13:17 -07:00
Most clients work fine assuming you're using a good font (see below.) Mirc has problems rendering Unicode with colors.
2016-09-07 15:23:12 -07:00
### Terminal
Don't use reverse video, just make foreground white on black background, but
not bright white, there should be two different whites, bright white and
2016-09-07 16:37:41 -07:00
grayish white, 16 unique colors in all, as shown below:
Color | Regular | Bold
------|---------|-----
Black | #000000 (0, 0, 0) | #555555 (85, 85, 85)
Red | #aa0000 (170, 0, 0) | #ff5555 (255, 85, 85)
Green | #00aa00 (0, 170, 0) | #55ff55 (85, 255, 85)
2016-09-08 11:33:29 -07:00
Yellow | #aa5500 (170, 85, 0) | #ffff55 (255, 255, 85)
2016-09-07 16:37:41 -07:00
Blue | #0000aa (0, 0, 170) | #5555ff (85, 85, 255)
Magenta | #aa00aa (170, 0, 170) | #ff55ff (255, 85, 255)
Cyan | #00aaaa (0, 170, 170 ) | #55ffff (85, 255, 255)
White | #aaaaaa (170, 170, 170) | #ffffff (255, 255, 255)
2016-09-07 15:23:12 -07:00
### Font
2016-09-09 12:36:13 -07:00
Try *Andale Mono* or *Menlo* for Mac. *Deja Vu Sans* for Linux,
*Lucida Console* Windows.
2016-09-09 12:22:02 -07:00
If the font you use is missing some of the block drawing unicode
characters its going to borrow them from another font, which
will probably having a different width than the original font.