a2m/README.md

51 lines
1.6 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
IRCCloud doesn't work very well. It's monospaced font is *Iconsolata*, served
2016-09-07 18:34:05 -07:00
up by Google Web Fonts, which doesn't draw the block characters correctly
2016-09-09 00:06:15 -07:00
(see below).
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:22:02 -07:00
Try *Andale Mono* or *Menlo* for Mac. *Deja Vu Sans* for Linux.
Someone tell me what works good for Windows.
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.