Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/hugomd/ascii-live

An extension to parrot.live, with support for more animations! http://ascii.live
https://github.com/hugomd/ascii-live

curl gif terminal

Last synced: about 2 months ago
JSON representation

An extension to parrot.live, with support for more animations! http://ascii.live

Awesome Lists containing this project

README

        

# ascii.live

A project for hosting curl-based animations, all in one place, and a follow up to [`parrot.live`](https://github.com/hugomd/parrot.live).

Any animations you want to add are welcome! 🎉

Try it out in your terminal:
```bash
curl ascii.live/parrot
```

## Running locally
To run the server locally on port `8080`, run:
```bash
go run main.go
```

## Running in Docker
```bash
docker run -p 8080:8080 hugomd/ascii-live:latest
```

## Adding frames
* [Fork this repository](https://github.com/hugomd/ascii-live/fork)
* Create a new frame file in [`/frames`](./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.
```Golang
package frames

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

var myAnimationFrames = []string{
`Frame1`,
`Frame2`,
`Frame3`,
}
```
* In [`./frames/frames.go`](./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](https://help.github.com/en/github/collaborating-with-issues-and-pull-requests/creating-a-pull-request)

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

| Contributor | Frame File | Repository |
|--------------------------------------------------|-----------------------------------------------|-----------------------------------------------------------------|
| [hexrcs](https://github.com/hexrcs) | [`forrest.go`](./frames/forrest.go) | [`run-forrest-run`](https://github.com/hexrcs/run-forrest-run) |
| [jmhobbs](https://github.com/jmhobbs) | [`parrot.go`](./frames/parrot.go) | [`terminal-parrot`](https://github.com/jmhobbs/terminal-parrot) |
| [01000001](https://github.com/01000001-01101011) | [`knot.go`](./frames/knot.go) | [`torus-knot`](https://github.com/01000001-01101011/torus-knot/)|

## Related Projects
* [parrot.live](https://github.com/hugomd/parrot.live)
* [terminal-parrot](https://github.com/jmhobbs/terminal-parrot)
* [cultofthepartyparrot.com](https://github.com/jmhobbs/cultofthepartyparrot.com)
* [parrotsay](https://github.com/matheuss/parrotsay)