A simple CLI tool to convert the images to ASCII art with rust 🦀💙

ansi ascii ascii-art ascii-generator ascii-generators ascii-graphics cli command-line convert-image-to-ascii hacktoberfest rust text

Find a file

ImgBotApp f5d6be14b9 [ImgBot] Optimize images *Total -- 5,869.14kb -> 5,195.53kb (11.48%) /srceenshots/heart_normal_scale_2.png -- 14.98kb -> 3.59kb (76.05%) /srceenshots/airplane_normal_scale_2.png -- 32.85kb -> 7.93kb (75.86%) /srceenshots/penguin_normal_scale_2.png -- 35.39kb -> 8.90kb (74.85%) /srceenshots/money_mouth_face_normal_scale_2.png -- 42.65kb -> 10.94kb (74.34%) /srceenshots/nerd_face_normal_scale_2.png -- 34.72kb -> 10.08kb (70.97%) /srceenshots/crap_normal_scale_2.png -- 26.30kb -> 7.91kb (69.92%) /srceenshots/penguin_colored_scale_2.png -- 36.38kb -> 28.46kb (21.75%) /srceenshots/nerd_face_colored_scale_2.png -- 39.83kb -> 32.47kb (18.47%) /srceenshots/airplane_colored_scale_2.png -- 49.23kb -> 40.60kb (17.53%) /srceenshots/crap_colored_scale_2.png -- 34.35kb -> 28.65kb (16.6%) /srceenshots/money_mouth_face_colored_scale_2.png -- 56.34kb -> 47.11kb (16.39%) /srceenshots/red_heart_colored_scale_2.png -- 26.32kb -> 22.17kb (15.79%) /srceenshots/airplane_colored_scale_4.png -- 17.50kb -> 14.75kb (15.72%) /srceenshots/crap_colored_scale_1.png -- 82.96kb -> 70.20kb (15.38%) /images/image.png -- 59.54kb -> 50.70kb (14.85%) /srceenshots/blue_heart_colored_scale_2.png -- 49.70kb -> 44.00kb (11.46%) /srceenshots/anime_colored_scale_3.gif -- 3,318.20kb -> 3,018.90kb (9.02%) /srceenshots/ok_hand_colored_scale_4_custome_chars.png -- 91.92kb -> 83.66kb (8.99%) /srceenshots/anime_2_colored_scale_4.gif -- 1,646.40kb -> 1,501.38kb (8.81%) /srceenshots/ok_hand_colored_scale_4_custome_chars_in_file.png -- 104.54kb -> 95.61kb (8.54%) /images/anime_2.jpg -- 40.88kb -> 39.42kb (3.57%) /images/anime.jpg -- 28.17kb -> 28.09kb (0.27%) Signed-off-by: ImgBotApp <ImgBotHelp@gmail.com>		2022-10-03 21:39:49 +00:00
.idea	Create the arguments moudule 💙🦀	2022-10-03 16:04:38 +02:00
images	[ImgBot] Optimize images	2022-10-03 21:39:49 +00:00
src	Improve the code yoo 💙🥰🦀	2022-10-03 21:00:39 +02:00
srceenshots	[ImgBot] Optimize images	2022-10-03 21:39:49 +00:00
.gitignore	Create the ascii_processor 🥰🦀	2022-10-03 20:13:59 +02:00
Cargo.toml	Remove the license-file proberty 😆	2022-10-03 21:18:02 +02:00
LICENSE.txt	Create the MIT license 💙	2022-10-03 21:37:08 +02:00
README.md	Create the readme file yooooooo 🥰💙🦀	2022-10-03 23:14:50 +02:00

README.md

aarty: A simple CLI tool to convert the images to ASCII art with rust 🦀

More screenshots

Original image Original image Original image Original image Original image Original image

           ~~~~~~~!!!!~!!~                ~!!!!!!!!!~~~~~           
         ~~~~!!!!!!!!!!!!!!!!           !!!!!!!!!!!!!!!!~~~~        
       ~~~~~!!!!!!!!!!!!!!!!!!~       !!!!!!!!!!!!!!!!!!!!~~~~      
      ~~~~~~!!!!!!!!!!!!!!!!!!!~    ~!!!!!!!!!!!!!!!!!!!!!!~~~~     
     ~~~~~~~!!!!!!!!!!!!!!!!!!!!!  !!!!!!!!!!!!!!!!!!!!!!!!~~~~~    
    ~~~~~~~~!!!!!!!!!!!!!!!!!!!!!!~!!!!!!!!!!!!!!!!!!!!!!!!~~~~~    
    ~~~~~~~~!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!~~~~~    
    ~~~~~~~~!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!~~~~~    
    ~~~~~~~~!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!~~~~~~    
    ~~~~~~~~~!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!~~~~~~    
     ~~~~~~~~~!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!~~~~~~~    
     ~~~~~~~~~~!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!~~~~~~~     
      ~~~~~~~~~~!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!~~~~~~~      
       ~~~~~~~~~~~!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!~~~~~~~~       
        ~~~~~~~~~~~~!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!~~~~~~~~~        
          ~~~~~~~~~~~~!!!!!!!!!!!!!!!!!!!!!!!!!!~~~~~~~~~~~         
           ~~~~~~~~~~~~~~~!!!!!!!!!!!!!!!!!!!~~~~~~~~~~~~           
             ~~~~~~~~~~~~~~~~~~~~~!!!~~~~~~~~~~~~~~~~~~~            
              ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~              
                ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~                
                  ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~                  
                    ~~~~~~~~~~~~~~~~~~~~~~~~~~~~                    
                      ~~~~~~~~~~~~~~~~~~~~~~~~                      
                         ~~~~~~~~~~~~~~~~~~~                        
                           ~~~~~~~~~~~~~~~                          
                             ~~~~~~~~~~                             
                                ~~~~~

Install

from crates.io
```
crago install aarty
```
From aur:
```
yay -S aarty
```

Options and arguments

aarty --help

A simple CLI tool to convert the images to ASCII art

Usage: aarty [OPTIONS] <IMAGE>

Arguments:
  <IMAGE>
          The image to convert to ASCII art

Options:
  -m, --mode <MODE>
          The art mode to use
          
          [default: normal-ascii]

          Possible values:
          - normal-ascii: Normal ASCII art
          - colored:      Colored ASCII art, the colors are based on the terminal colors

      --output-method <OUTPUT_METHOD>
          [default: stdout]

          Possible values:
          - file:   Save the ascii art to a file
          - stdout: Print the ascii art to the terminal

  -c, --characters <CHARACTERS>
          The character to use for drawing the image (lighter to darker) You can user one character if you uses the color mode
          
          [default: " .,-~!;:=*&%$@#"]

  -s, --scale <SCALE>
          The output scale (1 is the original size)
          
          [default: 4]

  -b, --background <BACKGROUND>
          The background color to use

  -o, --output <OUTPUT>
          The output file to write to (if output_method is file)
          
          [default: ascii_image.txt]

  -h, --help
          Print help information (use `-h` for a summary)

  -V, --version
          Print version information

Examples

aarty -m images/airplane.png

                         :=:**    
                        =***:*    
   ~~!!!~~~~~~~ ~~~   =*****=     
         ~~~!!!!!!!!=*****=       
                 ~:*****=         
                :===**:!~         
              ;======~!!~~        
            ;:===::   ~!~         
          ;:;~:::     ~!!~~       
     ~~!!;~~:;         !!~        
        ~~!!~          ~!~        
          ~!~           !~        
           ~~           ~~

aarty -m colored images/airplane.png

aarty -m colored images/airplane.png -s 2

aarty -c " ~okOK#\$%" images/ok_hand.png

                                        
                     $$$#               
                     #$$$$#             
                  K#KO#$$$$#            
                  k###O#$$$$#           
                    kK#OK$$$$#K         
                      OKKO#$$$#         
              O#$$#O    KKK$$$$#        
         K$$$$$$$$$$$$$#OOk#$$$#K       
         K$$$$$$$$$$$$$$$$##K#$$#K      
       #$K OO     OK#$$$$$$$$$$###      
      #$$$$#         OO##$$$$$$$$$#     
      O#$$$$#          #$$$$$$$$$$KO    
       K#$$$$#       K#$$$$$$$$$$KO     
       O#$$$$$$#KK####$$$$$$$$$##K      
         K#$$$$$$$$$$$$$$$$$$$$#KO      
          K##$$$$$$$$$$$$$$$$$##O       
           kK###$$$$$$$$$$$$###K        
             OK######$$######KO         
                OOKKKKKKKKOO

aarty -c " ~okOK#\$%" images/ok_hand.png -m colored

aarty -c " ~okOK#\$%" images/ok_hand.png -m colored --output-method file -o ok_ascii.txt

If you get here, don't forget the star yooo ⭐