├── .gitignore
├── Gemfile
├── LICENSE
├── README.md
├── Rakefile
├── ass
    ├── nom.jpg
    └── screenshot.png
├── bin
    └── lolcat
├── lib
    ├── lolcat.rb
    └── lolcat
    │   ├── cat.rb
    │   ├── lol.rb
    │   └── version.rb
├── lolcat.gemspec
└── man
    └── lolcat.6


/.gitignore:
--------------------------------------------------------------------------------
1 | *.gem
2 | .bundle
3 | Gemfile.lock
4 | pkg/*
5 | 


--------------------------------------------------------------------------------
/Gemfile:
--------------------------------------------------------------------------------
1 | source "http://rubygems.org"
2 | gemspec
3 | 


--------------------------------------------------------------------------------
/LICENSE:
--------------------------------------------------------------------------------
 1 | Copyright (c) 2016, moe@busyloop.net
 2 | All rights reserved.
 3 | 
 4 | Redistribution and use in source and binary forms, with or without
 5 | modification, are permitted provided that the following conditions are met:
 6 |     * Redistributions of source code must retain the above copyright
 7 |       notice, this list of conditions and the following disclaimer.
 8 |     * Redistributions in binary form must reproduce the above copyright
 9 |       notice, this list of conditions and the following disclaimer in the
10 |       documentation and/or other materials provided with the distribution.
11 |     * Neither the name of the lolcat nor the
12 |       names of its contributors may be used to endorse or promote products
13 |       derived from this software without specific prior written permission.
14 | 
15 | THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
16 | ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
17 | WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
18 | DISCLAIMED. IN NO EVENT SHALL <COPYRIGHT HOLDER> BE LIABLE FOR ANY
19 | DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
20 | (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
21 | LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
22 | ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
23 | (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
24 | SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
25 | 
26 | 


--------------------------------------------------------------------------------
/README.md:
--------------------------------------------------------------------------------
 1 | # What?
 2 | 
 3 | ![](https://github.com/busyloop/lolcat/raw/master/ass/nom.jpg)
 4 | 
 5 | ## Screenshot
 6 | 
 7 | ![](https://github.com/busyloop/lolcat/raw/master/ass/screenshot.png)
 8 | 
 9 | ## Installation
10 | 
11 | ### Linux
12 | 
13 | ```bash
14 | $ sudo snap install lolcat
15 | ```
16 | 
17 | ### Mac
18 | 
19 | ```bash
20 | $ brew install lolcat
21 | ```
22 | 


--------------------------------------------------------------------------------
/Rakefile:
--------------------------------------------------------------------------------
1 | require 'bundler/gem_tasks'
2 | 


--------------------------------------------------------------------------------
/ass/nom.jpg:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/busyloop/lolcat/f4cca5601ea57df2b5b3c98feea8ad05f4421039/ass/nom.jpg


--------------------------------------------------------------------------------
/ass/screenshot.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/busyloop/lolcat/f4cca5601ea57df2b5b3c98feea8ad05f4421039/ass/screenshot.png


--------------------------------------------------------------------------------
/bin/lolcat:
--------------------------------------------------------------------------------
 1 | #!/usr/bin/env ruby
 2 | 
 3 | # Copyright (c) 2016, moe@busyloop.net
 4 | # All rights reserved.
 5 | #
 6 | # Redistribution and use in source and binary forms, with or without
 7 | # modification, are permitted provided that the following conditions are met:
 8 | #     * Redistributions of source code must retain the above copyright
 9 | #       notice, this list of conditions and the following disclaimer.
10 | #     * Redistributions in binary form must reproduce the above copyright
11 | #       notice, this list of conditions and the following disclaimer in the
12 | #       documentation and/or other materials provided with the distribution.
13 | #     * Neither the name of the lolcat nor the
14 | #       names of its contributors may be used to endorse or promote products
15 | #       derived from this software without specific prior written permission.
16 | #
17 | # THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
18 | # ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
19 | # WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
20 | # DISCLAIMED. IN NO EVENT SHALL <COPYRIGHT HOLDER> BE LIABLE FOR ANY
21 | # DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
22 | # (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
23 | # LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
24 | # ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
25 | # (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
26 | # SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
27 | 
28 | require "rubygems"
29 | require "lolcat/version"
30 | require "lolcat/cat"
31 | 
32 | Lol.cat!
33 | 


--------------------------------------------------------------------------------
/lib/lolcat.rb:
--------------------------------------------------------------------------------
 1 | # Copyright (c) 2016, moe@busyloop.net
 2 | # All rights reserved.
 3 | #
 4 | # Redistribution and use in source and binary forms, with or without
 5 | # modification, are permitted provided that the following conditions are met:
 6 | #     * Redistributions of source code must retain the above copyright
 7 | #       notice, this list of conditions and the following disclaimer.
 8 | #     * Redistributions in binary form must reproduce the above copyright
 9 | #       notice, this list of conditions and the following disclaimer in the
10 | #       documentation and/or other materials provided with the distribution.
11 | #     * Neither the name of the lolcat nor the
12 | #       names of its contributors may be used to endorse or promote products
13 | #       derived from this software without specific prior written permission.
14 | #
15 | # THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
16 | # ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
17 | # WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
18 | # DISCLAIMED. IN NO EVENT SHALL <COPYRIGHT HOLDER> BE LIABLE FOR ANY
19 | # DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
20 | # (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
21 | # LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
22 | # ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
23 | # (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
24 | # SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
25 | 
26 | require "lolcat/version"
27 | require "lolcat/lol"
28 | require "lolcat/cat"
29 | 


--------------------------------------------------------------------------------
/lib/lolcat/cat.rb:
--------------------------------------------------------------------------------
  1 | # Copyright (c) 2016, moe@busyloop.net
  2 | # All rights reserved.
  3 | #
  4 | # Redistribution and use in source and binary forms, with or without
  5 | # modification, are permitted provided that the following conditions are met:
  6 | #     * Redistributions of source code must retain the above copyright
  7 | #       notice, this list of conditions and the following disclaimer.
  8 | #     * Redistributions in binary form must reproduce the above copyright
  9 | #       notice, this list of conditions and the following disclaimer in the
 10 | #       documentation and/or other materials provided with the distribution.
 11 | #     * Neither the name of the lolcat nor the
 12 | #       names of its contributors may be used to endorse or promote products
 13 | #       derived from this software without specific prior written permission.
 14 | #
 15 | # THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
 16 | # ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
 17 | # WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
 18 | # DISCLAIMED. IN NO EVENT SHALL <COPYRIGHT HOLDER> BE LIABLE FOR ANY
 19 | # DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
 20 | # (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
 21 | # LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
 22 | # ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
 23 | # (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
 24 | # SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 25 | 
 26 | require "lolcat/version"
 27 | require "lolcat/lol"
 28 | 
 29 | require 'stringio'
 30 | require 'optimist'
 31 | 
 32 | module Lol
 33 |   def self.cat!
 34 |     p = Optimist::Parser.new do
 35 |       version "lolcat #{Lolcat::VERSION} (c)2011 moe@busyloop.net"
 36 |       banner <<HEADER
 37 | 
 38 | Usage: lolcat [OPTION]... [FILE]...
 39 | 
 40 | Concatenate FILE(s), or standard input, to standard output.
 41 | With no FILE, or when FILE is -, read standard input.
 42 | 
 43 | HEADER
 44 |       banner ''
 45 |       opt :spread, "Rainbow spread", :short => 'p', :default => 3.0
 46 |       opt :freq, "Rainbow frequency", :short => 'F', :default => 0.1
 47 |       opt :seed, "Rainbow seed, 0 = random", :short => 'S', :default => 0
 48 |       opt :animate, "Enable psychedelics", :short => 'a', :default => false
 49 |       opt :duration, "Animation duration", :short => 'd', :default => 12
 50 |       opt :speed, "Animation speed", :short => 's', :default => 20.0
 51 |       opt :invert, "Invert fg and bg", :short => 'i', :default => false
 52 |       opt :truecolor, "24-bit (truecolor)", :short => 't', :default => false
 53 |       opt :force, "Force color even when stdout is not a tty", :short => 'f', :default => false
 54 |       opt :version, "Print version and exit", :short => 'v'
 55 |       opt :help, "Show this message", :short => 'h'
 56 |       banner <<FOOTER
 57 | 
 58 | Examples:
 59 |   lolcat f - g      Output f's contents, then stdin, then g's contents.
 60 |   lolcat            Copy standard input to standard output.
 61 |   fortune | lolcat  Display a rainbow cookie.
 62 | 
 63 | Report lolcat bugs to <https://github.com/busyloop/lolcat/issues>
 64 | lolcat home page: <https://github.com/busyloop/lolcat/>
 65 | Report lolcat translation bugs to <http://speaklolcat.com/>
 66 | 
 67 | FOOTER
 68 |     end
 69 | 
 70 |     opts = Optimist::with_standard_exception_handling p do
 71 |       begin
 72 |         o = p.parse ARGV
 73 |       rescue Optimist::HelpNeeded
 74 |         buf = StringIO.new
 75 |         p.educate buf
 76 |         buf.rewind
 77 |         opts = {
 78 |           :animate => false,
 79 |           :duration => 12,
 80 |           :os => rand * 8192,
 81 |           :speed => 20,
 82 |           :spread => 8.0,
 83 |           :freq => 0.3
 84 |         }
 85 |         Lol.cat buf, opts
 86 |         puts
 87 |         buf.close
 88 |         exit 1
 89 |       end
 90 |       o
 91 |     end
 92 | 
 93 |     p.die :spread, "must be >= 0.1" if opts[:spread] < 0.1
 94 |     p.die :duration, "must be >= 0.1" if opts[:duration] < 0.1
 95 |     p.die :speed, "must be >= 0.1" if opts[:speed] < 0.1
 96 | 
 97 |     opts[:os] = opts[:seed]
 98 |     opts[:os] = rand(256) if opts[:os] == 0
 99 | 
100 |     begin
101 |       files = ARGV.empty? ? [:stdin] : ARGV[0..-1]
102 |       files.each do |file|
103 |         fd = $stdin if file == '-' or file == :stdin
104 |         begin
105 |           fd = File.open(file, "r") unless fd == $stdin
106 | 
107 |           if $stdout.tty? or opts[:force]
108 |             Lol.cat fd, opts
109 |           else
110 |             if fd.tty?
111 |               fd.each do |line|
112 |                 $stdout.write(line)
113 |               end
114 |             else
115 |               IO.copy_stream(fd, $stdout)
116 |             end
117 |           end
118 |         rescue Errno::ENOENT
119 |           puts "lolcat: #{file}: No such file or directory"
120 |           exit 1
121 |         rescue Errno::EACCES
122 |           puts "lolcat: #{file}: Permission denied"
123 |           exit 1
124 |         rescue Errno::EISDIR
125 |           puts "lolcat: #{file}: Is a directory"
126 |           exit 1
127 |         rescue Errno::ENXIO
128 |           puts "lolcat: #{file}: Is not a regular file"
129 |           exit 1
130 |         rescue Errno::EPIPE
131 |           exit 1
132 |         end
133 |       end
134 |     rescue Interrupt
135 |     end
136 |   end
137 | end
138 | 


--------------------------------------------------------------------------------
/lib/lolcat/lol.rb:
--------------------------------------------------------------------------------
  1 | # Copyright (c) 2016, moe@busyloop.net
  2 | # All rights reserved.
  3 | #
  4 | # Redistribution and use in source and binary forms, with or without
  5 | # modification, are permitted provided that the following conditions are met:
  6 | #     * Redistributions of source code must retain the above copyright
  7 | #       notice, this list of conditions and the following disclaimer.
  8 | #     * Redistributions in binary form must reproduce the above copyright
  9 | #       notice, this list of conditions and the following disclaimer in the
 10 | #       documentation and/or other materials provided with the distribution.
 11 | #     * Neither the name of the lolcat nor the
 12 | #       names of its contributors may be used to endorse or promote products
 13 | #       derived from this software without specific prior written permission.
 14 | #
 15 | # THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
 16 | # ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
 17 | # WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
 18 | # DISCLAIMED. IN NO EVENT SHALL <COPYRIGHT HOLDER> BE LIABLE FOR ANY
 19 | # DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
 20 | # (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
 21 | # LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
 22 | # ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
 23 | # (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
 24 | # SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 25 | 
 26 | require "lolcat/version"
 27 | require 'paint'
 28 | 
 29 | module Lol
 30 |   ANSI_ESCAPE = /((?:\e(?:[ -\/]+.|[\]PX^_][^\a\e]*|\[[0-?]*.|.))*)(.?)/m
 31 |   INCOMPLETE_ESCAPE = /\e(?:[ -\/]*|[\]PX^_][^\a\e]*|\[[0-?]*)$/
 32 | 
 33 |   @os = 0
 34 |   @paint_init = false
 35 | 
 36 |   def self.rainbow(freq, i)
 37 |      red   = Math.sin(freq*i + 0) * 127 + 128
 38 |      green = Math.sin(freq*i + 2*Math::PI/3) * 127 + 128
 39 |      blue  = Math.sin(freq*i + 4*Math::PI/3) * 127 + 128
 40 |      "#%02X%02X%02X" % [ red, green, blue ]
 41 |   end
 42 | 
 43 |   def self.cat(fd, opts={})
 44 |     @os = opts[:os]
 45 |     print "\e[?25l" if opts[:animate]
 46 |     while true do
 47 |       buf = ''
 48 |       begin
 49 |         begin
 50 |           buf += fd.sysread(4096)
 51 |           invalid_encoding = !buf.dup.force_encoding(fd.external_encoding).valid_encoding?
 52 |         end while invalid_encoding or buf.match(INCOMPLETE_ESCAPE)
 53 |       rescue EOFError
 54 |         break
 55 |       end
 56 |       buf.force_encoding(fd.external_encoding)
 57 |       buf.lines.each do |line|
 58 |         @os += 1
 59 |         println(line, opts)
 60 |       end
 61 |     end
 62 |     ensure
 63 |     if STDOUT.tty? then
 64 |         print "\e[m\e[?25h\e[?1;5;2004l"
 65 |         # system("stty sane -istrip <&1");
 66 |     end
 67 |   end
 68 | 
 69 |   def self.println(str, defaults={}, opts={})
 70 |     opts.merge!(defaults)
 71 |     chomped = str.sub!(/\n$/, "")
 72 |     str.gsub! "\t", "        "
 73 |     opts[:animate] ? println_ani(str, opts, chomped) : println_plain(str, opts, chomped)
 74 |     puts if chomped
 75 |   end
 76 | 
 77 |   private
 78 | 
 79 |   def self.println_plain(str, defaults={}, opts={}, chomped)
 80 |     opts.merge!(defaults)
 81 |     set_mode(opts[:truecolor]) unless @paint_init
 82 |     filtered = str.scan(ANSI_ESCAPE)
 83 |     filtered.each_with_index do |c, i|
 84 |       color = rainbow(opts[:freq], @os+i/opts[:spread])
 85 |       if opts[:invert] then
 86 |         print c[0], Paint.color(nil, color), c[1], "\e[49m"
 87 |       else
 88 |         print c[0], Paint.color(color), c[1], "\e[39m"
 89 |       end
 90 |     end
 91 | 
 92 |     if chomped == nil
 93 |       @old_os = @os
 94 |       @os = @os + filtered.length/opts[:spread]
 95 |     elsif @old_os
 96 |       @os = @old_os
 97 |       @old_os = nil
 98 |     end
 99 |   end
100 | 
101 |   def self.println_ani(str, opts={}, chomped)
102 |     return if str.empty?
103 |     print "\e7"
104 |     @real_os = @os
105 |     (1..opts[:duration]).each do |i|
106 |       print "\e8"
107 |       @os += opts[:spread]
108 |       println_plain(str, opts, chomped)
109 |       str.gsub!(/\e\[[0-?]*[@JKPX]/, "")
110 |       sleep 1.0/opts[:speed]
111 |     end
112 |     @os = @real_os
113 |   end
114 | 
115 |   def self.set_mode(truecolor)
116 |     # @paint_mode_detected = Paint.mode
117 |     @paint_mode_detected = %w[truecolor 24bit].include?(ENV['COLORTERM']) ? 0xffffff : 256
118 |     Paint.mode = truecolor ? 0xffffff : @paint_mode_detected
119 |     STDERR.puts "DEBUG: Paint.mode = #{Paint.mode} (detected: #{@paint_mode_detected})" if ENV['LOLCAT_DEBUG']
120 |     @paint_init = true
121 |   end
122 | end
123 | 


--------------------------------------------------------------------------------
/lib/lolcat/version.rb:
--------------------------------------------------------------------------------
1 | module Lolcat
2 |   VERSION = "100.0.1"
3 | end
4 | 


--------------------------------------------------------------------------------
/lolcat.gemspec:
--------------------------------------------------------------------------------
 1 | # -*- encoding: utf-8 -*-
 2 | $:.push File.expand_path("../lib", __FILE__)
 3 | require "lolcat/version"
 4 | 
 5 | Gem::Specification.new do |s|
 6 |   s.name        = "lolcat"
 7 |   s.version     = Lolcat::VERSION
 8 |   s.authors     = ["Moe"]
 9 |   s.email       = ["moe@busyloop.net"]
10 |   s.homepage    = "https://github.com/busyloop/lolcat"
11 |   s.description = %q{Rainbows and unicorns!}
12 |   s.summary     = %q{Okay, no unicorns. But rainbows!!}
13 | 
14 |   s.add_development_dependency "rake"
15 |   s.add_dependency "paint", "~> 2.1"
16 |   s.add_dependency "optimist", "~> 3.0.0"
17 |   s.add_dependency "manpages", "~> 0.6.1"
18 | 
19 |   s.files         = `git ls-files`.split("\n")
20 |   s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
21 |   s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
22 |   s.require_paths = ["lib"]
23 | end
24 | 


--------------------------------------------------------------------------------
/man/lolcat.6:
--------------------------------------------------------------------------------
  1 | .TH LOLCAT 6 "April 4, 2019"
  2 | .\" Please adjust this date whenever revising the manpage.
  3 | .SH NAME
  4 | lolcat \- rainbow coloring effect for text console display
  5 | 
  6 | .SH SYNOPSIS
  7 | .B lolcat
  8 | .RI [ options ] " " [ files ] " " ...
  9 | 
 10 | .SH DESCRIPTION
 11 | This manual page documents briefly the
 12 | .B lolcat
 13 | command.
 14 | .PP
 15 | \fBlolcat\fP is a program that concatenates files, or standard input, to
 16 | standard output (like the generic \fBcat\fP), and adds rainbow coloring to it.
 17 | 
 18 | .SH OPTIONS
 19 | 
 20 | .TP
 21 | \fB\-p\fP \fIX\fP, \fB\-\-spread=\fIX\fP
 22 | Inclination of the rainbow stripes
 23 | .br
 24 | (character widths per line height; high values (>1000) give almost horizontal stripes, low values (0.1) almost vertical ones; default: 3.0).
 25 | .TP
 26 | \fB\-F\fP \fIX\fP, \fB\-\-freq=\fIX\fP
 27 | Frequency of the rainbow effect.
 28 | .br
 29 | (low values around 0.0001 give almost monochrome screens; default: 0.1).
 30 | .TP
 31 | \fB\-S\fP \fIX\fP, \fB\-\-seed=\fIX\fP
 32 | Initial value for the random number generator; 0 means automatic.
 33 | .br
 34 | (default: 0).
 35 | .TP
 36 | \fB\-a\fP, \fB\-\-animate\fP
 37 | Fade every line through an animation before printing the next one.
 38 | .TP
 39 | \fB\-d\fP \fIX\fP, \fB\-\-duration=\fIX\fP
 40 | Duration of the animation.
 41 | .br
 42 | (number of steps before showing next line; default: 12)
 43 | .TP
 44 | \fB\-s\fP \fIX\fP, \fB\-\-speed=\fIX\fP
 45 | Speed of the animation.
 46 | .br
 47 | (frame rate, i.e. number of steps per second; default: 20)
 48 | .TP
 49 | \fB\-i\fP, \fB\-\-invert\fP
 50 | Inverts the background and foreground colors.
 51 | .TP
 52 | \fB\-t\fP, \fB\-\-truecolor\fP
 53 | Enables 24-bit truecolor mode.
 54 | .TP
 55 | \fB\-f\fP, \fB\-\-force\fP
 56 | Force color even when stdout is not a tty.
 57 | .TP
 58 | .B \-v, \-\-version
 59 | Shows lolcat version.
 60 | .TP
 61 | .B \-h, \-\-help
 62 | Shows options summary.
 63 | 
 64 | .SH EXAMPLES
 65 | 
 66 | Typical combinations of \fBlolcat\fP include other programs that generate text:
 67 | .br
 68 | .br
 69 | Large colorful words can be written like this:
 70 | 
 71 | .IP
 72 | .EX
 73 | echo "KTHXBAI" | toilet | lolcat
 74 | .EE
 75 | .
 76 | .P
 77 | 
 78 | Cows are popular, come in all colors, and tell random epigrams:
 79 | 
 80 | .IP
 81 | .EX
 82 | fortune | cowsay | lolcat \-a
 83 | .EE
 84 | .
 85 | .P
 86 | 
 87 | .SH SEE ALSO
 88 | .BR cat (1),
 89 | .BR toilet (1),
 90 | .BR fortune (6),
 91 | .BR cowsay (6)
 92 | .br
 93 | .SH AUTHOR
 94 | lolcat was written by Moe <moe@busyloop.net>.
 95 | .PP
 96 | This manual page was originally written by chrysn <chrysn@fsfe.org>,
 97 | for the Debian project.
 98 | .br
 99 | Very quickly revamped by Mathieu Aubin <mathieu@zeroserieux.com> to
100 | include as part of official code repository.
101 | 


--------------------------------------------------------------------------------