Skip to content

ConnerWill/Convert-ImageToASCIIArt

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

56 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Convert-ImageToASCIIArt

Convert an image to ASCII art

GitHub last commit GitHub issues GitHub repo size GitHub top language GitHub language count License GitHub repo stars GitLab

Description

PowerShell function to convert an image to ASCII art

Usage

Clone repository

git clone https://github.com/ConnerWill/Convert-ImageToASCIIArt.git

Import PowerShell module

Import-Module ./Convert-ImageToASCIIArt

or

Import-Module ./Convert-ImageToASCIIArt/Convert-ImageToASCIIArt.psm1

Convert an image to ASCII art

Convert-ImageToAsciiArt -ImagePath "C:\path\to\image.jpg"

View help for the function

Get-Help Convert-ImageToASCIIArt -Full

Examples

Example of converting image C:\path\to\image.jpg to ASCII art

Convert-ImageToAsciiArt -ImagePath "C:\path\to\image.jpg"

Example of converting image C:\path\to\image.jpg to ASCII art specifying the MaxWidth of ASCII art output to 80 instead of default value of your terminal width and the Contrast to 75 instead of the default value of 50

Convert-ImageToAsciiArt -ImagePath "C:\path\to\image.jpg" -MaxWidth 80 -Contrast 75

Example of converting image $HOME\pictures\image.png to ASCII art without using the ImagePath flag

This flag is not needed if the image path is specified as the first value when calling the function

Convert-ImageToAsciiArt $HOME\pictures\image.png

Example of converting image $env:USERPROFILE\pictures\image.png to ASCII art with a maximum width of 80

Then outputting the ASCII art to a text file with Out-File to the current directory

This example uses parameter aliases Path and Width instead of the full parameters ImagePath and MaxWidth

Convert-ImageToAsciiArt -Path $env:USERPROFILE\pictures\image.png -Width 80 | Out-File -FilePath $PWD\ASCII-art.txt

Example of converting image C:\path\to\image.jpg to ASCII art using the Verbose flag

This will show the verbose output of what is being done

This example uses parameter aliases Image instead of the full parameter ImagePath

Convert-ImageToAsciiArt -Image C:\path\to\image.jpg -Verbose

View more examples by running Get-Help Convert-ImageToASCIIArt -Examples after importing the module

Other

ASCII Art Showcase

Click to expand example ASCII art generated from this script










                                                     :;;:
                                                   :;oooo;;
                                                  ;;ooooooo;;                                .. ..
                                                  ;oooxxoooo;;;        :;;:             ..          .
                                                  ;oo####%oooo;;::;:;;;;ooo;;:        .               .
                                                 ,;o%######%ooooo;;oooooooooo;;;   .    .,;oooo;,.
                                                 ;oo#########%xxoxx%%####xoooooo;:    :x##########o,    .:::
                                                 ;oo#######################xoooo:  .o###############x,   :oo;;;                     ...,
                                                 ;oo#########################x;. .;###################;   xxoo;;:           ::;;:.         .
                                                 :oo%########################o  :######################%. ,##%xoo;;:  :;;;;;oo;,    ..,,.     .
                                                  ;o%##########%x%%#########; .x########################%. %####xoo;;;;oooooo:  .:x%#####%o,                :::
                                                  ;ox########%xxxxx%#######: :###########################%:#######xoooox%##%, ,x############%,  .;:; ,:;;;;;ooo;;;:
                                                  ;oo#######%xxxxxxx%#####; o#############################################%.,x################o  ,;o;o;ooooooooooo;;:
                                                  ;oo%######xxxxxxxxx%###x.x##################x :#########################:o###################%, :ooooooooxxxoooooo;;;:
                                                  :;o%#####%xxxxxxxxxx###o%###################: ;################################################, x%%%########%ooooooo;;;;;;;;;
                                                   ;ox#####xxxxxxxxxxx########################. x#################################################:.#############xoooooooooooooo;;:
                                                   ;oo####%xxxxxxxxxxx#########%o#############  ###################################################,:##############%%xx%%#####xooo;;
                                                   ;oo####xxxxxxxxxxxx%########, x###########x .######################################o.x###########,x##########################ooo;;
                                                   ;oo####xxxxxxxxxxxx%########; ,###########o ,######################################. o###########%,##########################xooo;:
                                                   ;oo####xxxxxxxxxxxx#########%  %####%xo;;;, ,#####################################x  %############ox#########################xoooo;
                                                   ;ox####xxxxxxxxxxxx##########, ;#%;.         ,o%##########;,#######,:#############;  ##############;#########################ox%oo;;
                                                  ,;o%####xxxxxxxxxxxx##########o  ,     .,,,,.    :x#######; .%#####x .#############, ,##############x########################%ox#ooo;
                                                  ;oo#####%xxxxxxxxxx%##########x    .;%#@@@@@@#x;.  ,%####o  o#######  x############. ;#######################%%x%############oo%#xoo;
                                                 :;o%######xxxxxxxxxx##########;   :%@@@@@@@@@@@@@@o.  o##%  :########, :####%o:,....  :%#####################%xxxxx%#########xox##%oo;
                                                 ;oo#######%xxxxxxxx%########%,  ,%@@@@@@@@@@@@@@@@@@;  :#, .#########;  ##o,            .;%########%x#######%xxxxxxx########%oo%##%ooo;
                                                ;;ox########xxxxxxx%########%.  o@@@@@@@@@@@@@@@@@@@@@%. .  %#########%  ,.   .;x%###%o:    ;%#####x. %######xxxxxxxx%######%oo%####xoo;
                                                ;oo##########%xxxx%########%. .%@@@@@@%;:....,;x@@@@@@@#.  o###########,   .;%@@@@@@@@@@@x,   o###%. :######%xxxxxxxx%######oo%#####%oo;;
                                               :;ox#######################%. .#@@@@@o.          .;#@@@@@#. ;##########;   ;#@@@@@@@@@@@@@@@x.  :##. ,#######%xxxxxxxx%#####oo%#######%oo;;:
                                               ;oo%#######xxx#############. .#@@@@x.   .,:;;::.   .x@@@@@#. x########,  ,#@@@@@@@@@@@@@@@@@@@;  ,, ,########%xxxxxxxx#####xox##########%xoo;;:
                                               ;oo#######%xxx%###########:  %@@@@:  .:oxxxxxxxxo:   o@@@@@% .######%.  o@@@@#%xx%#@@@@@@@@@@@@x   .%########%xxxxxxx%#####oo##############%xo;:
                                              :;oo#######xxxx###########o  x@@@#,  :xxxxxxxxxxxxxo,  ;@@@@@; ;####%.  x@@%;.      .:x@@@@@@@@@@%. ,##########xxxxxx%#####%ox################xo;
                                              :;oo#######xxxx##########%. :@@@#. .;xxxx;,....,;xxxx:  o@@@@@..####. .%@%,  .:;ooo;:. .o@@@@@@@@@%. :##########%xxx%######xo%################%o;:
                                              :;oo#######xxx###########: .#@@@, .oxxx:         .;xxx;  x@@@@o ;##, .%@;  :oxxxxxxxxxo, .%@@@@@@@@x  x####################xo%#################oo;
                                              :;oo########%###########%  o@@@: .oxxo.            ,xxx: .#@@@@..#;  x#, ,oxxxxooooxxxxxo. o@@@@@@@@; .####################xo%#################xo;
                                              :;oo####################: .@@@x  oxx;               ,xxx, ;@@@@; ;  o#, :xxxo:.    .,oxxxx, ;@@@@@@@@, ;###################%o%########%xxox%###%o;:
                                               ;oo###################%  o@@#. :xxo       .;o:      :xxo  #@@@%   :#, ;xxo,          ,oxxx, o@@@@@@@% .###################%o%#######%ooooox####oo;
                                               ;oo#####%%%%%%########; .#@@; .xxx.      ;@@@@#,     ;xx: o@@@@. .#: :xx;.            .oxxx. %@@@@@@@, o##################%o%######xooooooo%###%o;:
                                               ;oo%%xo;;;;;;;;ox%####, ;@@@. ;xx:      ,@@@@@@%     .xxo ,@@@#  xx ,xx;      ..       .oxxo .@@@@@@@x ,##################%ox#####xoooooooox####oo;;
                                                ;;;;;;oooooooo;;oo%#%  %@@x .xxo       o@@@@@@@.     ;xx. #@@; ,#. oxo     o#@@#;      .xxx, o@@@@@@#  %#################%ox####%ooooooooox####%oo;;:
                                              ;;;;;ox%########%o;;ox; ,@@@, ;xx:       x@@@@@@@.     ,xx: %@#  x; :xo.   .%@@@@@@;      :xxo .@@@@@@@: o#################%ox###%xooooooooox#####%ooo;;
                                             ;;;ox#######%x%####%o;;: x@@#  oxx.       ;@@@@@@%       ox; x@o .# .xx:    o@@@@@@@@.     .xxx, x@@@@@@o :#################xo%###xoooooooooox#######%ooo;;
                                            ;;;o###%%####o;x######x;;:@@@x ,xx;         %@@@@#,       ;xo ;@, oo :xo     #@@@@@@@@:      ;xx; :@@@@@@% .#################oo%##%xoooooooooox#########%oo;;
                                           ;;;x###o;o####%%########x;;#@@o :xx:          ;xxo.        :xx ;#  %. ox,    .@@@@@@@@@,      ,xxo .@@@@@@#  %##%#############oo###%ooooooooooo%##########%oo;
                                          ;;;%####xx%###############x;o@@; ;xx,                       :xx ;x .% .xx      #@@@@@@@#       .xxx. #@@@@@@,:;;;;;;;ox%######xo%###xoooooooooox############%o;:
                                         :;;x#######################%;;#@: oxx.        ;o,            :xx ;; :o :x;      :@@@@@@@,        xxx, x@@@@%o;;;;;o;;;;;;ox%###ox####xoooooooooo%############%oo;
                                         ;;o##########%%#############o;%@: oxx.       o@@@.           :xo ;, o: ;x:       ,%@@#%,         oxx, o@@@x;;ox%%###%%xo;;;;x#oo%###%oooooooooox#############%oo;
                                         ;;o#########%o;o############o;%@: oxx.       #@@@;           ;xo o. x, ox,         ,.            oxx: o@@%;;x###########%o;;;;;%####%oooooooooo%#############xoo:
                                        :;;x##########oo%############o;%@: oxx,       %@@@,           ox; x  %. xx.         .ox:          oxx: o@#;;%######xo%#####xo;;o%#####ooooooooox##############oo;
                                        ;;;o#########################o;#@; oxx:       ,xx:           .xx, %  #..xx.         %@@@.         oxx: o@o;x#######xoo#######o;;o%####xooooooox%#############%oo;
                                        ;;;o#########################;o@@o ;xx;                      :xx..%  #..xx.         #@@@.         xxx: x@;o###############xx##o;;o####%oooooox%#############%oo;;
                                        ;;;;%#######################x;x@@% ;xxo                      ox; ;%  @. xx,         x@@o         ,xxx, %#;o##############%o;o##o;;%####xoooxx###############xoo;
                                        ;;;;x#######################oo#@@@.,xxx,                    :xx, %%  @, ox:          :,          :xxx. ##;x###############%xx###o;o#####%%%################xoo;
                                        :;;;o##########%o:,.:x%####o;:@@@@:.xxxo                   .xxo ,@#  #: ;x;                      oxxo .@#;o##########%oo%#######%;;x######################xoo;:
                                         ;;;;o########:  .,,######x;: #@@@x ;xxx,                  oxx, x@#  %o :xo                     ,xxx; ;@@oo##########%o;x########o;o#####################xoo;:
                                         :;;;;x#####%. .x@% #####%;xo o@@@@..xxxo.                ;xx: ,@@@. x% .xx,                    ;xxx, %@@x;%###########%#########%;o%###################%oo;;
                                          :;;;;o####;o::@@@.o####o%#% ,@@@@o :xxxo.     ,oxo:    :xx;  %@@@, o@. ox;                   ,xxxo ,@@@#oo######################;;%###################xo;;
                                           :;;;;ox####;:@@@;,########. #@@@@, ;xxxo.   o#####%. ,xxo  o@@@@: :@o :xx,                 .oxxx, x@@@@x;%##%;::;x#############;;%###################xo;
                                            .;;;;;ox##o,@@@% %#######: x@@@@%  ;xxxo  o########, o;  ;@@@@@o .@# .xxx.                oxxxo ,@@@@@@oo###x .  .:%#########%;;%###################xo;
                                              ;;x%%###x.@@@@.:#######x ,@@@@@x  :xx: .#########% .  ;@@@@@@o  %@; :xxo.             .oxxxx. %@@@@@@%;x##:.@#%;. :%#######x;o%###################xo;
                                              ;ox#####% #@@@o ########. %@@@@@o  ,o, ;##########;  o@@@@@@@.  ;@#..oxxx,           ,oxxxx, ;@@@@@@@:,o#x x@@@@#.;.;#####%o;o####################%o;
                                              ;oo###### %@@@#.;#######o ,@@@@@@x.    ;###########..@@@@@@@; . .@@x ,xxxx;,       ,oxxxxx, ,@@@@@@@x  o%,:@@@@@o,##xo%##%o;o%####################%o;
                                              ;oo######.o@@@@;.########. x@@@@@@#:   ;###########; x@@@@@% .x  x@@; ,xxxxxo;;:;oxxxxxxo, ,#@@@@@@#. :#o #@@@@@,;######xo;;x###########%x%#######%o;,
                                             ;ooo######,;@@@#, o#######o .#@@@@@@@%. :############.,@@@@#. x#, ,@@@: ,oxxxxxxxxxxxxxx;. ,#@@@@@@@: .#% o@@@@@% xxooxoo;;o%##########%xoox%######%oo;
                                             ;oox######;,@@%.,:.########. ,@@@@@@@@: .############; x@@#. o##x  x@@@; .:xxxxxxxxxxxo,  :@@@@@@@@o  x#,,@@@@@@;.#x;;;;;ox%##########%ooooo%######xoo;
                                            :;oo%######x.@x ;@# ;#######x  :@@@@@@@x  o############..@#. ;####: .#@@@x. .:;oxxxxo:,  .o@@@@@@@@x  ;#; %@@@@@@.;####xo%############%oooooo%######ooo:
                                            ;ooo#######% : o@@@; %#######;  ;@@@@@@#. .############x :. ;######. :@@@@@o,   ...     ;#@@@@@@@@x  ,#x ;@@@@@@% x####ox#############xooooox######%oo;
                                            ;oox########..%@@@@#.:########;  :#@@@@@o  o############o  o#######%  ;@@@@@@%o:,...,;x@@@@@@@@@@x  ,#%. :#@@@@@:.####xo%############%oooooo%#####%ooo;
                                            ;oo%########::@@@@@@o x########;  .%@@@@@.  %############; x########o  ;@@@@@@@@@@@@@@@@@@@@@@@@o  ,##, o,.o@@@# ;####ox#############xooooox######ooo;
                                           ;;oo#########o.@@@@@@@,.#########x.  :%@@@x  ,#############: x########o  :@@@@@@@@@@@@@@@@@@@@@#:  ,##: x@@x.,%@o %###xo%#############xoooox%#####xoo;:
                                           :oox#########% %@@@@@@% :#########%:   ,o#@;  ,#############; ;########o  ,%@@@@@@@@@@@@@@@@@@o.  ;##; o@@@@#: ;.,####ox##############%ooox%#####xoo;;
                                           :oox##########.o@@@@@@@o o##########%;.   .,   :#############x.,%#######%.  :%@@@@@@@@@@@@@#o.  .x##o o@@@@@@@x. o####o%###############%x%######%oo;;
                                           :oox##########,,@@@@@@@@: %############o:       ,%#############;.o########:   ,o#@@@@@@@#x:.   :%##o ;@@@@@@@@@,.#####;%#######################%oo;;
                                           :;ox##########; #@@@@@@@o .%##############x;::   .x##############x%########%,    .,:::,.     :%###o :@@@@@@@@@% ;#####o%#######################oo;;
                                            ;oo##########% o@@@@@@;.o ,##################%,   :%########################%;.          .;%####o :@@@@@@@@@@,.######o%######################%oo;
                                            ;oo%##########.,@@@@@; %@o ,###################o.   :x#########################%o;::::;x%######; :@@@@@@@@@@x ;######x%######################xo;
                                            ;oox##########; %@@@o %@@@o :####################o.   .,;x####################################;  ,#@@@@@@@@@,.#######xx######################oo;
                                            ;ooo##########% ;@@o.%@@@@@; ,#####################x:.     .:;x##############################: o%.,#@@@@@@@o o#######%x######################oo;
                                            :;oo###########, #o %@@@@@@@; ,#######################x;:,...,:x###########################%..x@@% ,@@@@@@#..########%o######################oo;
                                             ;oo%##########o , x@@@@@@@@@; .%#########################################################o..%@@@@% :@@@@@; x########%o######################oo;
                                :o%x;        ;oo%###########. ;@@@@@@@@@@@o .x#######################################################: :#@@@@@@% :@@@% :#########%o#####################%oo;
                              .x#####x        ;ox###########; o@@@@@@@@@@@@%  ;####################################################x. ;@@@@@@@@@x ;@@, %#########xo############%########%oo;
                          ,::. o######,       ;ox###########% .@@@@@@@@@@@@x . .x################################################%: .%@@@@@@@@@@@x oo o##########ox#########%;.  ,o%####%oo;
                        ,%####: %##x:,,       ;ox############: o@@@@@@@@@@#.:@o  ;##############################################o. ;@@@@@@@@@@@@@@o  ,##########%o#########%. :xo: .x###%oo;
                       ,#######:,%. ,;,       ;ox############% .#@@@@@@@@@,.#@@#: .o##########################################o. .,@@@@@@@@@@@@@@@@, %##########o%########%..%@@@@%. x##xoo;
                       ,;x######.  o###,      ;o%#############; ;@@@@@@@@; %@@@@@x. .o######################################o. ,%x %@@@@@@@@@@@@@@o ;##########ox#########: %@@@@@@#..%#xoo;
                          ,%###%..%####%     ;oo###############. %@@@@@@x ;@@@@@@@@;  .;%################################%;. ,x@@@,,@@@@@@@@@@@@@% ,##########xo#######%%o ;@@@@@@@@% ,#oo;;
                      ,,.  .###,.%######,    ;ox###############o ,@@@@@#.,@@@@@@@@@@#:   :x############################o,  :%@@@@@% %@@@@@@@@@@@#, %#########xo######%xoo: #@@@@@@@@@: ooo;
                    ,%###x, :#; x#####;#;   ;oox################, o@@@@:.#@@@@@@@@@@@@...   :o%####################%o,  .o#@@@@@@@@:,@@@@@@@@@@@: o#########%o%#####%xooo.;@@@@@@@@@@# ,o;:
                   .#######. o ;#####% #o   ;oo%################%  %@@x x@@@@@@@@@@@@% x@%;.   .:;x%#########%%o;,.   ;%@@@@@@@@@@@% %@@@@@@@@@; :##########ox#####%oooo; %@@@@@@@@@@@: ;;
                   x#######x  .######o.#x   ;oo######%xxx########o .##.:@@@@@@@@@@@@@:.@@@@@%o,       ......     .:ox #@@@@@@@@@@@@@:,@@@@@@@@o ,##########%o#####%xoooo,,@@@@@@@@@@@@% ,;
                  .##%######, :######,;#o  :;oo#####%xxxx%########: ,:.#@@@@@@@@@@@@#.;@@@@@@@@#%o;:,. ....,:;o%#@@@% #@@@@@@@@@@@@@% %@@@@@@x .%##########xx#####xooooo o@@@@@@@@@@@@@.
                  :##.%#####o ;#####o x#;  :;ox#####xxxxx%#########.  %@@@@@@@@@@@@@x #@@@@@@@@@@@@@@,:@@@@@@@@@@@@@# %@@@@@@@@@@@@@@,,@@@@@x .%###########xx####%ooooo: #@@@@@@@@@@@@@;
                  ;##,.#####% :####%.,##,  ;oox####%xxxxx%#########%  o@@@@@@@@@@@@@:,@@@@@@@@@@@@@@@.o@@@@@@@@@@@@@# %@@@@@@@@@@@@@@x %@@@x .%############xx####xooooo.,@@@@@@@@@@@@@@x
                  :##x ,####x .###%..%##   ,oox####%xxxxx###########o  x@@@@@@@@@@@# x@@@@@@@@@@@@@@# x@@@@@@@@@@@@@@ x@@@@@@@@@@@@@@@,:@@x .x#############xx###%ooooo; o@@@@@@@@@@@@@@@
                  .###: ,%##:  :x; .x##o   :oo%#####xxxx%############;  x@@@@@@@@@@o.#@@@@@@@@@@@@@@x #@@@@@@@@@@@@@@.x@@@@@@@@@@@@@@@x %o .%##############%o###%ooooo, #@@@@@@@@@@@@@@@,
                   %###:  ,. ;:   ,%###,   :oox#####%xx%##############;  x@@@@@@@@@,:@@@@@@@@@@@@@@@;.@@@@@@@@@@@@@@@.o@@@@@@@@@@@@@@@@.. ,%###############%o###%ooooo.,@@@@@@@@@@@@@@@@;
                   :####o.  :##o, %###x    ,;ox########################:  o@@@@@@@% %@@@@@@@@@@@@@@@:,@@@@@@@@@@@@@@@,o@@@@@@@@@@@@@@@@, ,##################o###%oooo; o@@@@@@@@@@@@@@@@o
                    %#####%%####; %###.     ;ox#########################;  ;@@@@@@;.@@@@@@@@@@@@@@@@.:@@@@@@@@@@@@@@@,;@@@@@@@@@@@@@@#: :############%%xxx%%o###%oooo, #@@@@@@@@@@@@@@@@%
                    :###########;.##%,      ;oo##########################;  ,#@@@@.;@@@@@@@@@@@@@@@@ o@@@@@@@@@@@@@@@:;@@@@@@@@@@@@@x. ;####%xx%#o:.        .;%##xooo.:@@@@@@@@@@@@@@@@@#
                     x##########;o#x.       ;oo###########################x  .x@@% %@@@@@@@@@@@@@@@% x@@@@@@@@@@@@@@@::@@@@@@@@@@@#: .x####xxxx:. ,;x%##%xo:.  ;##xo; o@@@@@@@@@@@@@@@@@@.
                     ,##########%#;         ;oo############################%,  ;#:,@@@@@@@@@@@@@@@@x #@@@@@@@@@@@@@@@::@@@@@@@@@@x. ,%####xxxx, .x###########%: o##%; %@@@@@@@@@@@@@@@@@@,
                      ;##########o          :;o%###########%xxxx%############;  . o@@@@@@@@@@@@@@@@;.@@@@@@@@@@@@@@@@;,@@@@@@@@#:  ;#####%xxx: ,###############,.###:.@@@@@@@@@@@@@@@@@@@:
                       o#########%o,         ;o%#########%xxxxxxxx############x,  :#@@@@@@@@@@@@@@@:,@@@@@@@@@@@@@@@@;,@@@@@@#;  .x######xxxx..################o %##..@@@@@@@@@@@@@@@@@@@;
                        ;##########x         ;o%########%xxxxxxxxx%#############;.  ;#@@@@@@@@@@@@@.:@@@@@@@@@@@@@@@@o.@@@@#;   ;#######%xxxo ,#####%##########% o#%.,@@@@@@@@@@###@@@@@@o
                         .;;,..#####.        ;o%########xxxxxxxxxxx##############%;   :%@@@@@@@@@@# o@@@@@@@@@@@@@@@@o.@@x:  .;#########xxxxx ,x;,. .:%########% ;#% ,@@@@@#o,.     .:x@@o
                               o####;       :;o########%xxxxxxxxxxx################%;   ,o#@@@@@@@% x@@@@@@@@@@@@@@@@o ;.  .;###########xxxxo.  .:x%############.:#% .@@@@; .:;oo; x#%o%@;
                               .####%       ;oo########xxxxxxxxxxxx%##################;.   ,o%@@@@o #@@@@@@@@@@@@@#x:    ,o#############xxx;  :%################.:##. #@@;.x;####x x@@@@#.
                                x####:      ;ox########xxxxxxxxxxxx#####################x:.   .,;o: @@@@@@@@@#%o:,    .;%###############xxx. x##################,:##: o@%,#@.####x o@@@@:
                                ,####x      ;o%#######%xxxxxxxxxxxx###########%############x;.       ..,,,..       ,;%##################xxo .###################,:##x  %%@@@.%###% ;@@#:
                                 %####.     ;o#########xxxxxxxxxxx%###########%%##############%x;:.           .,;x%#####################xxx..###################.:###o .x@@@,x#### ,@%,
                                 :####o    ;;x#########xxxxxxxxxxx#############%%%###################%xxxxxx%############################xx; ;##%xxxx%########## ;####x. ,ox,o#### .;
                                 .#####    :;%#########%xxxxxxxxx%##############%%%%########################################################; :.  ..,;#########% ;#####%o,   :####.
                                  o####:   :o%##########xxxxxxxx%#################%%%%######################################################: .:o%#############o x########%%,,####.
                                  .####%   ;o%###########%xxxx%#####################%%%%%%%%%%%%%%%%%###################%%#################; ;#################: %##########:,####,
                                   x####:  .o%########################################%%%%%%%%%%%%%%%%%%##############%%%#################% ;################## .###########:.####:
                                   ,####x  ;ox##################################################%%%%%%%%%%##########%%%###################x x#################o ;######%x%##; ####;
                                    %####,,#oo#######################################################%%%%%%%%%%%%%%%%#####################x ;####;;o%#########, x#####xoox##; %###;
                                    :####x x%oo%########################################################%%%%%%%%%%#########################..%##%,   x#######% ,#####xooox##o %###o
                                     %####::#xooooxxxxxooooooooo%####################################################################%x####x ,%###%..########:  ;####oooo%##x %###o
                                     ;####%.#o.,;ooooooooooooooooo%#################################################################xxx%####x. ,;oo, %#######%#; :%##xoo%###x x###x
                                     .#####o#:  %#%%%%%%#@@@#xooooox########%%xxxoooxxx%###########################################%xxx%######o,.    :##########x..x#%%%####% x###%
                                      o######,  #@@@@@@@@@@@@@@%oooooxxxooooooooooooooooox%########################################xxxx###########%x; .;oo;%#####%. ;#######% x###%
                                      .######. .@@@@@@@@@@@@@@@@@#%ooooooo;;xx%%##%%xooooooox%%####################################%xx%##############x.    .%######, :%#####% x###%
                                       ;#####  ,@@@@@@@@@@@@@@@@@@@@@####%: ,x@@@@@@@@@%oooooooooxx%%%######%%%xx%%#################%##################;:;: .%######; .x##### o###%
                                        o###;  :@@@@@@@@@@@@@@@@@@@@@@@@@@@%, .o@@@@@@@@@#xoooooooooooooooooooooooooox%################################xx##: .%######o  ;####.o###%
                                         .:.   ;@@@@@@@@@@@@@@@@@@@@@@@@@@@@@x, .;#@@@@@@@@@;:;ooooooooooox%%%%%xooooooox##############################xx###:  x######%, ,%##.o###%
                                               o@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@x,  :%@@@@@@o . ::;;;;:..:@@@@@@@@@#%ooooooox##########%%%%%############ox####:  o#######;  o#.o###%
                                               x@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@%:  ,x@@@; ;% .:::::, ; o@@@@@@@@@@@#xoooooooxxxxxxoooooooox#########%o%#####;  o#######x. , o###%
                                               o%#@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@#o. .o: o@@; ,::::.:@: %@@@@@@@@@@@x:,;oooooooooooooooooooo%#######xo#######;  ;########;  o###%
                                                   .,:;ox%#@@@@@@@@@@@@@@@@@@@@@@@@@@@%: .x@@@@;  ....#@@.,@@@@@@@#x:.  ,o%xoooooxx%#@@@@@%oooox#####xox########o  :########%x####x
                                               ;;::,..     ..,:;ox%#@@@@@@@@@@@@@@@@@@@@##@@@@@#.,. :#@@@% ;@@@#x:   :x#@@@@@@@@@@@@@@@@@@@#ooooooxxooo%#########o  ,#############x
                                               ;ooooooo;;::,,..      .,:;x%##@@@@@@@@@@@@@@@@@@:.::.:@@@@@o oo,  .:x@@@@@@@@@@@@@@@@@@@@@@@@@%oooooooooooox%######x. .%###########o
                                              .ooooooooooooooooo;;;::,,..    .,:;ox%#@@@@@@@@@o ,::, #@@@@@:  ,;%@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@#xoooooooooooox#####x. .x##########;
                                              .oooooooooooooooooooooooooo;;;::,,..    .,:;ox%% .:::: o@@@@@#%#@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@#x,oooooooooo%####%.  o#########,
                                              ,oooooooooooooooooooooooooooooooooooo;;::,,..    :::::..#@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@% %####%%xooo%####%,  :########.
                                              ,ooooo,.,,::;;;oooooooooooooooooooooooooooooo;, ,:::::,  .,:;ox%#@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@o.#########xoox####%:  ,%#####%
                                              :oooo;         ...,,::;;;oooooooooooooooooooo: .::::::: .,,,..    .,:;ox%#@@@@@@@@@@@@@@@@@@@@@@@@@@@;,##########%oox#####;  .x####o
                                              :oooo;                   .:ooooooooooooooooo;. ::::::::..ooooo;;;::,,..    .,:;ox%#@@@@@@@@@@@@@@@@@@::###########%oox%####x.  ;###,
                                              ;oooo:                    .ooooooo;,,,::;;;o, ,::::::::, :oooooooooooooo;;::,,..    .,:;ox%##@@@@@@@@,;############%ooox%###%,  .;,
                                              ;oooo:                    .ooooooo;        . .:::::::::: ,oooooooooooooooooooooo;;;:,,..     .,:;ox##.o#############%ooooooooo;.
                                              oooooo::,,..              ,ooooooo:         .:::::::::::. ;;;;ooooooooooooooooooooooooooo;;::,,..     ;%#############%ooooooooo;.
                                             .oooooooooooo;;;::,,,...   :ooooooo:         ,:::::::::::,     ..:oooooooooooooooooooooooooooooooo;;:,  .;%#############%xoo;;;;;
                                             .ooooooooooooooooooooooooo;oooooooo:         .::::::::::::       .oooooooo;,:::;;;ooooooooooooooooooo: :, .;%##############x
                                             ,oooooooooooooooooooooooooooooooooo;,..       .:::::::::::.      ,oooooooo,       ...,::;;ooooooooooo,.:::, .;%############x
                                             ,ooooooooooooooooooooooooooooooooooooooo;;:,,  ,:::::::::.       ,oooooooo.                ..,:;ooooo,.:::::,. ;%##########o
                                             :oooooooooooooooooooooooooooooooooooooooooooo:  ,:::::::. ..     ;oooooooo.                    ;ooooo.,:::::::,..;%########;
                                             ;ooooooooooooooooooooooooooooooooooooooooooooo:  :::::,  :ooo;;::oooooooo;                     ;ooooo ,:::::::::,..;%######,
                                             ;oooooooooooooooooooooooooooooooooooooooooooooo:  :::. .;ooooooooooooooooo:.                   ;oooo; :::::,::::::,. :%####.
                                             ;ooooooooooooooooooooooooooooooooooooooooooooooo: .,  ,oooooooooooooooooooooo;;:,,..           ooooo; :::::  .::::::,. :x#%.
                                             ;oooooooooooooooooooooooooooooooooooooooooooooooo:  .:ooooooooooooooooooooooooooooooo;;;::,,,,:ooooo: ::::,    .::::::,. ,o
                                            .;;;ooooooooooooooooooooooooooooooooooooooooooooooo::;ooooooooooooooooooooooooooooooooooooooooooooooo,.::::.      .::::::,.
                                                ...,,::;;;ooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooo,.::::.        .::::::.
                                                ,,....     ..,,:::;;;oooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooo.,::::.          ,::::.
                                                 ,::::::::,,,....    ...,,::;;;ooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooooo; ,:::::.          .:::.
                                                  .:::::::::::::::::,,,,...     ..,,:::;;;oooooooooooooooooooooooooooooooooooooooooooooooooooooo; ,::::::,.         ,::
                                                    ,::::::::::::::::::::::::::,,,...     ..,,,::;;;oooooooooooooooooooooooooooooooooooooooooooo; :::::::::,        ,::
                                                     .:::::::::::::::::::::::::::::::::::,,,...     ...,,::;;;oooooooooooooooooooooooooooooooooo: :::::::::::,.     ,::
                                                       ,::::::::::::::::::::::::::::::::::::::::::,,,....     ...,,::;;ooooooooooooooooooooooooo, :::::::::::::,.   ::,
                                                        .:::::::::,:::::::::::::::::::::::::::::::::::::::::,,,...      ..,,::;;oooooooooooooooo,.:::::::::::::::,..::,
                                                          ,::::::.,;;;:.......,:::::::::::::::::::::::::::::::::::::::,,...      ..,,::;;;oooooo..::::::::::::::::::::.
                                                           .::::. ;ooo;;;::,.   ,::::::::::::::::::::::::::::::::::::::::::::::,,...      ..,::; ,::::::::::::::::::::.
                                                             ,:. :ooooooooooo;;,..::::::::::::::::::::::::::::::::::::::::::::::::::::::,,,,..   .::::::::::::::::::::
                                                                .oooooooooooooooo;;;;::::::::::::::::::::::::::::::::::::::::::::::::::::::::::,.  ,::::::::::::::::::
                                                                ;ooooooooooooooooooo;,::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::,  ,::::::::::::::::
                                                               :oooooooooooooooooooo; ,,:::::::::::::::::::::::::::::::::::::::::,,,,:::::::::::::::,  .:::::::::::::,
                                                              .ooooooooooooooooooooo;      ...,,,,::::::::::::::::::::::::,.;;;;.      .,:::::::::::::,. .:::::::::::,
                                                              ;ooooooooooooooooooooo;                ....,,,:::::::::::::..;ooo;;;;;;;::,.,;:::,::::::::,. .,::::::::.
                                                             :oooooooooooooooooooooo;                           ...,,,,:..;oooooooooooooooooo;:.::::::::::,. .,::::::.
                                                            ,oooooooooooooooooooooooo                                    :oooooooooooooooooooo;.,:::::::::::,. .,::::.
                                                            ;oooooooooooooooooooooooo.                                  .oooooooooooooooooooooo..:::::::::::::,. .,::
                                                           ,ooooo;:,......,:;oooooooo.                                  ;oooooooooooooooooooooo. ...,,,:::::::::,.  ,
                                                           .oooo;::, ;xxo;,  ,;oooooo,                                 :ooooooooooooooooooooooo,           ...,,,,.
                                                            ,oooooo, ######:   ,;oooo,                                ,oooooooooooooooooooooooo,
                                                             ,oooo; :######. :;, :ooo,                               .;oooooooooooooooooooooooo:
                                                              .;oo: o#####x .oo; ,ooo,                               :ooooooooooooooooooooooooo:
                                                                ,;. ######: ,oo;;oooo,                               oooooooooooooooooooooooooo:
                                                                   :#####%  ;ooooooo;.                              .ooooo;::::::;;oooooooooooo;
                                                                   o#####; .:::::::,                                 ;oo;,         .,;ooooooooo:
                                                                  .######.                                           :ooooooo, %#%x;. ,;ooooooo:
                                                                  ;#####o                                             ;ooooo; ,#####x ..,;ooooo,
                                                                  %#####,                                             .;oooo: o#####: ;;::oooo;
                                                                 ,#####x                                                .;oo..#####% .oooooooo,
                                                                 o#####,                                                  ., :#####; :ooooooo:
                                                                 #####%                                                      x#####. ;ooo;;:.
                                                                :#####:                                                     ,#####;
                                                                x####%                                                      o#####.
                                                               .#####;                                                     .#####o
                                                               ;#####.                                                     :#####.
                                                               %####o                                                      %####x
                                                              .#####.                                                     ,#####,
                                                              ;####x                                                      x####%
                                                              %####:                                                     .#####;
                                                             .#####.                                                     o#####.
                                                             .#####,                                                    .#####x
                                                              %####o                                                    ;#####;
                                                              :#####,                                                   %#####.
                                                               o#####.                                                 .######.
                                                                x####;                                                 :######.
                                                                .%###.:                                                :######:
                                                                 .x%,,@;                                                %#####%.
                                                                   ,o@@@,                                               ,######x
                                                                   .#@@%o:                                               :#####%
                                                                    ,#%o#@:                                               :####.,o
                                                                     ,x#@@@,                                               :#x..#@;
                                                                      ;@@@%::                                               . .%@@#.
                                                                       o#x:x@:                                               :@@@@xo,
                                                                        ,o%@@@:                                               x@@%;%#.
                                                                         %@@@@@;                                               xx;x@@#
                                                                         .%@@@@@o                                               o#@@@%:
                                                                          .#@@@@@x                                              .#@@#;%x
                                                                           ,@@@@@@o                                              ,#x;o@@x
                                                                            ;@@@@@@,                                              .;x@@@@x
                                                                             ;@@@@#.                                               ;@@@@@@x
                                                                              :xx;.                                                 ;@@@@@@x
                                                                                                                                     o@@@@@@o
                                                                                                                                      o@@@@@@o
                                                              ;%x:                                                                     x@@@@@@:
                                                             ,@@@@x                                                                     x@@@@@:
                                                              %@@@x                                                                      x@@@%
                                                               :oo.                                                                       .:,

                                                                                 :
                                                                                :o.                                         .,.
                                                                                 ,                                         ;@@@x
                                                                                                                           x@@@@,
                                                                                                                           .x##o

                                                                                                                                             :
                                                                                                                                            ,o












Contributing

Click to expand contributing section

Any contributions you make are greatly appreciated.

If you want to contribute, please fork this repo and create a pull request.

  1. Fork the Project
  2. Create your Feature Branch
git checkout -b AmazingNewFeature
  1. Commit your Changes
git commit -m 'Description of the amazing feature you added'
  1. Push to the Branch
git push origin AmazingNewFeature
  1. Then open a pull request :)

If you experience any bugs/issues or have and suggestions, you can simply open an issue :)

Donate

Monero (XMR) icon and wallet QR code XMR : 86tE67soBqFb5fxNGgC4HLdwZXebP42ewfBwfKyMDKvFbgA7T8p4g4T5BBNA9LNbwaVafup973w41PdvCS7bbj6gTNQpCh1

₿ BTC : bc1qpg5d69n2knsete7vw7f2vqpkg4a0faq9rc6se0

(back to top)