[{"_1":2,"_152":-5,"_153":-5},"loaderData",{"_3":4,"_13":14,"_20":21,"_131":132},"root",{"_5":-5,"_6":-7,"_7":8,"_9":-7,"_10":11,"_12":-7},"currentUser","primaryEmail","siteVerification","6LeIxAcTAAAAAJcZVRqyHh71UMIEGNQ_MXjiZKhI","toast","enableDev",false,"incidentStatus","routes/_layout",{"_15":-5,"_16":17,"_18":17,"_19":11},"username","isAskGordonEnabled",true,"isUsingNewTemplate","showMinimalLanding","routes/_layout.r.$namespace.$reponame",{"_22":23,"_24":-5,"_25":11,"_26":11,"_27":28,"_29":30,"_31":-5,"_32":11,"_33":34,"_83":-5,"_84":85,"_124":-5,"_125":11,"_126":17,"_127":11,"_128":-5,"_129":130},"canonicalUrl","https://hub.docker.com/r/kayvan/agg/tags","mcpServer","canSeeDockerfile","canSeeAutobuilds","namespace","kayvan","reponame","agg","cloudBuildSource","isAutobuildsAvailable","repo",{"_35":36,"_37":38,"_40":41,"_42":43,"_44":11,"_45":46,"_47":48,"_49":50,"_52":30,"_27":28,"_53":54,"_55":39,"_56":57,"_58":59,"_60":61,"_62":-5,"_63":57,"_64":65,"_66":11,"_67":28,"_68":69,"_74":11,"_75":76,"_80":28,"_81":82},"categories",[],"content_types",[39],"image","date_registered","2023-04-12T06:20:18.111317Z","description","Dockerized version of agg - asciinema gif generator\n","is_private","last_updated","2023-04-12T06:48:54.765032Z","last_modified","2024-10-16T13:48:34.145251Z","media_types",[51],"application/vnd.docker.container.image.v1+json","name","pull_count",396,"repository_type","star_count",0,"status",1,"status_description","active","source","collaborator_count","full_description","# agg - asciinema gif generator\n\nagg is a command-line tool for generating animated GIF files from [asciicast v2\nfiles](https://github.com/asciinema/asciinema/blob/master/doc/asciicast-v2.md)\nproduced by [asciinema terminal\nrecorder](https://github.com/asciinema/asciinema).\n\nIt uses Kornel Lesiński's excellent\n[gifski](https://github.com/ImageOptim/gifski) library to produce optimized,\nhigh quality GIF output with accurate frame timing.\n\nagg is a successor to\n[asciicast2gif](https://github.com/asciinema/asciicast2gif).\n\n![Demo](demo.gif)\n\n## Building\n\nBuilding from source requires [Rust](https://www.rust-lang.org/) compiler and\n[Cargo package manager](https://doc.rust-lang.org/cargo/). You can install both\nwith [rustup](https://rustup.rs/).\n\nTo build agg run:\n\n```bash\ncargo build -r\n```\n\nThis produces an executable file at `target/release/agg`. There are no other\nbuild artifacts so you can copy the binary to a directory in your `$PATH`.\n\n## Building via Docker (no Rust install needed)\n\nAs an alternative to building with Rust locally, you can install Rancher\nDesktop or another docker-compatible tool. In the examples below,\nwe are using `nerdctl` as the docker compatible tool, and this will\nalso work with Docker Desktop, using the `docker` command.\n\n```sh\nnerdctl build -t agg .\n```\n\nThen you can do this:\n\n```sh\nmkdir -p ~/TMP \ncp demo.cast ~/TMP\nnerdctl run --rm -it -v ~/TMP:/casts agg /casts/demo.cast /casts/demo.gif\n```\n\nThis will create the `.gif` file in the `~/TMP` directory. If you don't want to build\nthe image, you can always use the image here: .\n\n## Usage\n\nBasic usage:\n\n```bash\nagg demo.cast demo.gif\n```\n\nThe above command renders a GIF file with default theme (dracula), font size\n14px.\n\nAdditional options are available for customization. For example, the following\ncommand selects Monokai theme, larger font size, 2x playback speed:\n\n```bash\nagg --theme monokai --font-size 20 --speed 2 demo.cast demo.gif\n```\n\nRun `agg -h` to see all available options. Current options are:\n\n```text\n --cols \n Override terminal width (number of columns)\n\n --font-dir \n Use additional font directory\n\n --font-family \n Specify font family [default: \"JetBrains Mono,Fira Code,SF Mono,Menlo,Consolas,DejaVu\n Sans Mono,Liberation Mono\"]\n\n --font-size \n Specify font size (in pixels) [default: 14]\n\n --fps-cap \n Set FPS cap [default: 30]\n\n-h, --help\n Print help information\n\n --idle-time-limit \n Limit idle time to max number of seconds [default: 5]\n\n --line-height \n Specify line height [default: 1.4]\n\n --no-loop\n Disable animation loop\n\n --renderer \n Select frame rendering backend [default: fontdue] [possible values: fontdue, resvg]\n\n --rows \n Override terminal height (number of rows)\n\n --speed \n Adjust playback speed [default: 1]\n\n --theme \n Select color theme [possible values: asciinema, dracula, monokai, solarized-dark,\n solarized-light, custom]\n\n-v, --verbose\n Enable verbose logging\n\n-V, --version\n Print version information\n```\n\n## Fonts\n\nBy default agg uses common monospaced font for a given platform, that can be\nfound on its default font family list. The list includes DejaVu Sans Mono and\nLiberation Mono (found on most Linux distros), SF Mono and Menlo (found on\nmacOS), Consolas (found on Windows), with addition of my personal favourites\nlike JetBrains Mono and Fira Code. The fonts are not included in agg and must be\npresent on the system. To see the default value run `agg --help` and look for\n`--font-family`. In addition there's implicit fallback to DejaVu Sans (not Mono)\nwhich helps with rendering symbols like ⣽ or ✔ amongst others.\n\nIf you want to use another font family then pass a comma-separated list like\nthis:\n\n```bash\nagg --font-family \"Source Code Pro,Fira Code\" demo.cast demo.gif\n```\n\nAs long as the fonts you want to use are installed in one of standard system\nlocations (e.g. /usr/share/fonts or ~/.local/share/fonts on Linux) agg will find\nthem. You can also use `--font-dir=/path/to/fonts` option to include extra\nfonts. `--font-dir` can be specified multiple times.\n\nTo verify agg picks up your font run it with `-v` (verbose) flag:\n\n```bash\nagg -v --font-family \"Source Code Pro,Fira Code\" demo.cast demo.gif\n```\n\nIt should print something similar to:\n\n```text\n[INFO agg] selected font families: [\"Source Code Pro\", \"Fira Code\", \"DejaVu Sans\", \"Noto Emoji\"]\n```\n\nThis list may also include implicit addition of DejaVu Sans fallback (mentioned\nearlier), as well as Noto Emoji (see section below).\n\nHere's how to use [Nerd Fonts](https://www.nerdfonts.com/) with agg:\n\n1. Download one of the patched font sets from\n , e.g. JetBrainsMono.zip\n2. Unzip them into `~/.local/share/fonts` (on Linux) or install with system font\n manager (macOS, Windows)\n3. Specify font family like this:\n\n```bash\nagg --font-family \"JetBrainsMono Nerd Font Mono\" demo.cast demo.gif\n```\n\n## Emoji\n\nCurrently agg supports only monochrome emojis via [Noto Emoji\nfont](https://fonts.google.com/noto/specimen/Noto+Emoji).\n\nInstall Noto Emoji font on your system or, point agg to a folder containing\n`NotoEmoji-*.ttf` files with `--font-dir`.\n\nNote that [Noto Color Emoji\nfont](https://fonts.google.com/noto/specimen/Noto+Color+Emoji) is not supported.\nBe aware that [some\ndistros](https://archlinux.org/packages/extra/any/noto-fonts-emoji/) ship this\ncolor font by name like \"noto-fonts-emoji\". This is _not_ what you need.\n\n## Color themes\n\nThere are several built-in color themes you can use with `--theme` option:\n\n- asciinema\n- dracula (default)\n- monokai\n- solarized-dark\n- solarized-light\n\nIf your asciicast file includes [theme\ndefinition](https://github.com/asciinema/asciinema/blob/develop/doc/asciicast-v2.md#theme)\nthen it's used automatically unless `--theme` option is explicitly specified.\n\nA custom, ad-hoc theme can be used with `--theme` option by passing a series of\ncomma-separated hex triplets defining terminal background color, default text\ncolor and a color palette:\n\n```text\n--theme bbbbbb,ffffff,000000,111111,222222,333333,444444,555555,666666,777777\n```\n\nThe above sets terminal background color to `bbbbbb`, default text color to `ffffff`,\nand uses remaining 8 colors as [SGR color\npalette](https://en.wikipedia.org/wiki/ANSI_escape_code#Colors).\n\nAdditional bright color variants can be specified by adding 8 more hex triplets\nat the end. For example, the equivalent of the built-in Monokai theme is:\n\n```text\n--theme 272822,f8f8f2,272822,f92672,a6e22e,f4bf75,66d9ef,ae81ff,a1efe4,f8f8f2,75715e,f92672,a6e22e,f4bf75,66d9ef,ae81ff,a1efe4,f9f8f5\n```\n\n## Additional GIF optimization\n\nGIF encoder used by agg, [gifski](https://github.com/ImageOptim/gifski),\nproduces great looking GIF files, although this often comes at a cost - file\nsize.\n\n[gifsicle](https://www.lcdf.org/gifsicle/) can be used to shrink the produced GIF file:\n\n```bash\ngifsicle --lossy=80 -k 128 -O2 -Okeep-empty demo.gif -o demo-opt.gif\n```\n\nEvery recording is different so you may need to tweak the lossiness level\n(`--lossy`), number of colors (`-k`) and other options to suit your needs.\n\n## License\n\n© 2022 Marcin Kulik.\n\nAll code is licensed under the Apache License, Version 2.0. See LICENSE file for details.\n","has_starred","hub_user","immutable_tags_settings",{"_70":11,"_71":72},"enabled","rules",[73],".*","is_automated","permissions",{"_77":17,"_78":11,"_79":11},"read","write","admin","user","storage_size",495316651,"orgData","recentTags",[86],{"_87":39,"_88":89,"_90":91,"_92":93,"_94":95,"_96":97,"_45":113,"_114":89,"_115":28,"_116":51,"_52":117,"_118":119,"_120":104,"_121":113,"_122":61,"_123":17},"content_type","creator",137492,"digest","sha256:9c39b20f22be6c7de229b47bfd273333e684946af08dcd3aa994174d27132ed7","full_size",495309885,"id",420810075,"images",[98],{"_99":100,"_90":91,"_101":102,"_103":104,"_105":106,"_107":108,"_109":102,"_110":-5,"_111":93,"_58":61,"_112":-5},"architecture","amd64","features","","last_pulled","2026-09-16T05:48:49.585230135Z","last_pushed","2023-04-12T06:48:55Z","os","linux","os_features","os_version","size","variant","2023-04-12T06:48:54.741171Z","last_updater","last_updater_username","media_type","latest","repository",19731980,"tag_last_pulled","tag_last_pushed","tag_status","v2","sbxKitMetadata","isPotentialSpam","isHubSbxKitsEnabled","displaySecurityMetadata","tagAttestations","tagsHaveAttestations",[],"routes/_layout.r.$namespace.$reponame.tags",{"_33":133,"_140":141,"_129":150,"_151":11},{"_35":134,"_37":135,"_40":41,"_42":43,"_44":11,"_45":46,"_47":48,"_49":136,"_52":30,"_27":28,"_53":54,"_55":39,"_56":57,"_58":59,"_60":61,"_62":-5,"_63":57,"_64":65,"_66":11,"_67":28,"_68":137,"_74":11,"_75":139,"_80":28,"_81":82},[],[39],[51],{"_70":11,"_71":138},[73],{"_77":17,"_78":11,"_79":11},"tags",{"_142":59,"_143":-5,"_144":-5,"_145":146},"count","next","previous","results",[147],{"_87":39,"_88":89,"_90":91,"_92":93,"_94":95,"_96":148,"_45":113,"_114":89,"_115":28,"_116":51,"_52":117,"_118":119,"_120":104,"_121":113,"_122":61,"_123":17},[149],{"_99":100,"_90":91,"_101":102,"_103":104,"_105":106,"_107":108,"_109":102,"_110":-5,"_111":93,"_58":61,"_112":-5},[],"canDeleteTags","actionData","errors"]

kayvan/agg

Tags for kayvan/agg