Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
ASCII animals in your terminal, for any occasion.
JavaScript Python Shell
tree: 549fac5d9f

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
controllers
examples
lib
node_modules/segmentio
public
scripts
.gitignore
Procfile
package.json
readme.md
routes.js
server.js
setup.js
simple.js

readme.md

Animals

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

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

Brought to you by @ivolo with rigorous testing by the Segment.io backend team.

Try it yourself:

curl -s https://raw.github.com/ivolo/animals/master/examples/loading.sh | sh
pip install requests
curl -s https://raw.github.com/ivolo/animals/master/examples/loading.py | python

Please contain your excitement.

REST API

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

GET /

Returns a random ASCII animal.

Parameters:

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        

Language Examples

Python

Shell

Host Your Own

Availability is crucial when dealing with ascii animal web services, so go ahead and run your own server for maximum reliability.

Run the web server:

npm install .
node simple.js

Using up:

up server.js

Adding Animals

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

Code Review Lead:

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

Used in Production On

License

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

Animal Credits

Heart n Soul

Something went wrong with that request. Please try again.