Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
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 21 hours ago
JSON representation
An extension to parrot.live, with support for more animations! http://ascii.live
- Host: GitHub
- URL: https://github.com/hugomd/ascii-live
- Owner: hugomd
- License: gpl-3.0
- Created: 2019-10-09T01:24:28.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2025-01-05T11:29:52.000Z (28 days ago)
- Last Synced: 2025-01-25T05:01:41.889Z (8 days ago)
- Topics: curl, gif, terminal
- Language: Go
- Homepage:
- Size: 11.4 MB
- Stars: 627
- Watchers: 7
- Forks: 205
- Open Issues: 12
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-terminal-art - ascii.live: batman&robin, batman, coin, donut, dvd, forrest, frames, knot, nebulaehes, nyan, parrot, playstation, spidyswing
- awesome-hilarious-repos - ascii-live - Curl-based animations (Command line utilities scripts)
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)