banter/banter.1

71 lines
1.4 KiB
Groff
Raw Normal View History

.Dd January 14, 2021
2020-12-26 01:07:46 +00:00
.Dt banter 1
.Os
.
.Sh NAME
.Nm banter
.Nd little script to make irc color art that will probably get you banned
.
.Sh SYNOPSIS
.Nm
2021-01-02 17:38:48 +00:00
.Op Fl d Ar delay
.Op Fl w Ar width
.Op Fl Fl colorfmt Ar format
.Op Fl Fl filler Ar filler
.Pa file
2021-01-01 18:24:50 +00:00
.
.Sh DESCRIPTION
.Nm
is a image to irc color codes converter.
2021-01-02 17:38:48 +00:00
.
2021-01-01 18:24:50 +00:00
.Pp
2021-01-02 17:38:48 +00:00
note that
.Nm
does not check if the line is too long for irc, additional
filtering may be needed if you do not want
accidental wrapping.
2021-01-01 18:24:50 +00:00
.
.Sh OPTIONS
2021-01-02 17:38:48 +00:00
.Bl -tag -width Ds
.It Fl d Ar delay
set the
.Ar delay
in seconds between output lines. this does
not factor in computation time.
.
.It Fl w Ar width
the
.Ar width
of filler characters. the actual line will almost certainly
be longer because of color codes.
.
.It Fl Fl colorfmt Ar format
the unicode-escaped format of the colorcodes. you probably
do not want to change it, the default of
.Cm '\ex03{},{}'
is usually fine for all irc-related use.
.
.It Fl Fl filler Ar filler
what to fill the actual contents of the text with.
you could use it to hide messages if you want.
the default value is
.Cm '.' .
.
.It Pa file
the path to the image to convert
2021-01-02 17:38:48 +00:00
.El
.
.Sh BUGS
please report any bugs found to
.Lk https://github.com/xfnw/banter/issues .
.
.Pp
note that
.Nm
does not support non-rgb[a] color palettes, and an
exception on other palettes like grayscale
is to be expected and not a bug.
.
.Sh AUTHORS
.An xfnw Aq Mt xfnw@riseup.net