ascii.live

A project for hosting curl-based animations, all in one place, and a follow up to parrot.live.

Any animations you want to add are welcome! 🎉

Try it out in your terminal:

curl ascii.live/parrot

Running locally

The Go toolchain is managed by Hermit. Activate the environment to automatically download and use the pinned Go version:

source bin/activate-hermit

To run the server locally on port 8080, run:

go run main.go

Running in Docker

docker run -p 8080:8080 hugomd/ascii-live:latest

Adding frames

• Fork this repository
• Create a new frame file in /frames, call it the name of your frames/animation, e.g. parrot.go
• Inside your new file, create an exported list of frames, e.g.

package frames

// This is the value stored in the FrameMap
var MyAnimation = DefaultFrameType(myAnimationFrames)

var myAnimationFrames = []string{
  `Frame1`,
  `Frame2`,
  `Frame3`,
}

• In ./frames/frames.go, add your animation to the FrameMap
• Commit and push your changes, and make a PR! If this is your first time making a PR, check GitHub's help page on the topic

Frame Contributions

Here's a list of lovely people who have contributed frames to this project:

Contributor	Frame File	Repository
hexrcs	forrest.go	run-forrest-run
jmhobbs	parrot.go	terminal-parrot
ahs3n	knot.go	torus-knot

Related Projects

• parrot.live
• terminal-parrot
• cultofthepartyparrot.com
• parrotsay