archive

- Random tools & helpful resources for IRC
git clone git://git.acid.vegas/archive.git
Log | Files | Refs | Archive

README.md (1818B)

      1 # a2m
      2 
      3 Convert ansi art to mirc art.
      4 
      5 ![screenshot](https://git.trollforge.org/a2m/plain/screenshot.png)
      6 
      7 For reference screenshot is iTerm2 with Menlo font ssh'd to a linux
      8 machine attached to a tmux session running irssi.
      9 
     10 ## Installation
     11 
     12 ```
     13 make
     14 sudo make install
     15 ```
     16 
     17 ## Usage
     18 
     19 ```
     20 a2m [options] [input.ans]
     21 	-l n      Crop n lines from the left side.
     22 	-r n      Crop n lines from the right side.
     23 	-n        Disable color output.
     24 	-p        Print unprintable characters.
     25 	-t size   Specify tab size, default is 8.
     26 	-w width  Specify width, default is 80.
     27 ```
     28 
     29 ## Troubleshooting
     30 
     31 ### IRC Client
     32 
     33 Most clients work fine assuming you're using a good font (see below.)
     34 * Mirc has problems with color sequences following 3 byte Unicode characters.
     35 * IRCCloud has incorrect colors.
     36 
     37 ### Terminal
     38 
     39 Don't use reverse video, just make foreground white on black background, but
     40 not bright white, there should be two different whites, bright white and
     41 grayish white, 16 unique colors in all, as shown below:
     42 
     43 Color | Regular | Bright
     44 ------|---------|-----
     45 Black   | #000000 (0, 0, 0)       | #555555 (85, 85, 85)
     46 Red     | #aa0000 (170, 0, 0)     | #ff5555 (255, 85, 85)
     47 Green   | #00aa00 (0, 170, 0)     | #55ff55 (85, 255, 85)
     48 Yellow  | #aa5500 (170, 85, 0)    | #ffff55 (255, 255, 85)
     49 Blue    | #0000aa (0, 0, 170)     | #5555ff (85, 85, 255)
     50 Magenta | #aa00aa (170, 0, 170)   | #ff55ff (255, 85, 255)
     51 Cyan    | #00aaaa (0, 170, 170 )  | #55ffff (85, 255, 255)
     52 White   | #aaaaaa (170, 170, 170) | #ffffff (255, 255, 255)
     53 
     54 ### Fonts
     55 
     56 Try *Andale Mono* or *Menlo* for Mac.  *Deja Vu Sans* for Linux,
     57 *Lucida Console* for Windows.
     58 
     59 If the font you use is missing some of the block drawing unicode
     60 characters its going to borrow them from another font, which
     61 will probably having a different width than the original font.