ASCII animals in your terminal, for any occasion.
JavaScript Python Shell
Latest commit 0bcaa54 Jan 1, 2015 @ivolo refactor
Permalink
Failed to load latest commit information.
data v2 Jan 2, 2015
examples Replace external 'requests' lib with urllib Aug 28, 2012
lib v2 Jan 2, 2015
.gitignore v2 Jan 2, 2015
Procfile v2 Jan 2, 2015
app.js refactor Jan 2, 2015
package.json analytics and docs Jan 2, 2015
readme.md analytics and docs Jan 2, 2015
server.js v2 Jan 2, 2015

readme.md

Animals

Loading indicator innovation. Enterprise loading solutions. Synergy. Animal Meetspace.

 .'"'.        ___,,,___        .'``. 
: (\  `."'"```         ```"'"-'  /) ;
 :  \                         `./  .'
  `.                            :.'  
    /        _         _        \    
   |         0}       {0         |   
   |         /         \         |   
   |        /           \        |   
   |       /             \       |   
    \     |      .-.      |     /    
     `.   | . . /   \ . . |   .'     
       `-._\.'.(     ).'./_.-'       
           `\'  `._.'  '/'           
             `. --'-- .'             
               `-...-'               

Try it yourself:

curl -s https://raw.githubusercontent.com/ivolo/animals/master/examples/loading.sh | sh
curl -s https://raw.githubusercontent.com/ivolo/animals/master/examples/loading.py | python

Please contain your excitement.

API

It's one call, but its also one hell of a call.

GET /

Returns a random ASCII animal.

  • index (int) - give it the same number, get the same animal. we have around 600 animals.
  • offset (int) - space offset from the left
  • reverse (boolean) - reversed or not
  • maxheight (int) - the maximum height an animal to return
  • maxwidth (int) - the maximum width of the animal to return
  • terminal (boolean) - whether to return the animal with ANSI terminal codes that will erase the previous lines.

Examples

curl -s http://animals.ivolo.me/
                     ^`.                        
     ^_              \  \                       
     \ \             {   \                      
     {  \           /     `~~~--__              
     {   \___----~~'              `~~-_         
      \                         /// a  `~.      
      / /~~~~-, ,__.    ,      ///  __,,,,)     
      \/      \/    `~~~;   ,---~~-_`~=         
                       /   /                    
                      '._.'                     
                                                
curl -s http://animals.ivolo.me/?index=130
                                                _        
                   |\___/|                      \\       
                   )     (    |\_/|              ||      
                  =\     /=   )a a `,_.-""""-.  //       
                    )===(    =\Y_= /          \//        
                   /     \     `"`\       /    /         
                   |     |         |    \ |   /          
                  /       \         \   /- \  \          
                  \       /         || |  // /`          
        jgs_/\_/\_/\_   _/_/\_/\_/\_((_|\((_//\_/\_/\_/\_

curl -s http://animals.ivolo.me/?index=130&offset=20&reverse=true
                            _                                                
                           \\                      |/___\|                   
                          ||              |/_\|    (     )                   
                           //  .-""""-._,` a a)   =/     \=                  
                            //\          / =_Y\=    (===)                    
                             /    /       \`"`     \     /                   
                              /   | \    |         |     |                   
                              \  \ -/   \         \       /                  
                              `/ //  | ||         /       \                  
                    _\/_\/_\/_\//_((\|_((_\/_\/_\/_/_   _\/_\/_\/_sgj        
                                                                             

Adding Animals

Pull requests are allowed, but subject to stringent code reviews. Add ascii animals to animals.txt

Code Review Lead:

                _,--.       ,--._   
                \  > `-"""-' <  /   
                 `-.         .-'    
                   / 'e___e` \      
                  (   (o o)   )     
                  _\_  `='  _/_     
                 / /|`-._.-'|\ \    
                / /||_______||\ \   
              _/ /_||=======||_\ \_ 
             / _/==||       ||==\_ \
             `'(   ^^       ^^   )`'
                \               /   
                 \______|______/ 
                 |______|______|    
                   )__|   |__(      
                  /   ]   [   \     
                  `--'     `--'     

License

WWWWWW||WWWWWW
 W W W||W W W
      ||
    ( OO )__________
     /  |           \
    /o o|    MIT     \
    \___/||_||__||_|| *
         || ||  || ||
        _||_|| _||_||
       (__|__|(__|__|

Animal credits to Heart n Soul.