{"id":13602386,"url":"https://github.com/chris17453/ttygif","last_synced_at":"2026-02-25T05:12:15.071Z","repository":{"id":62585483,"uuid":"177647842","full_name":"chris17453/ttygif","owner":"chris17453","description":"A modern text to gif tool. For use in headless ci/cd environments providing themed output for documentation.","archived":false,"fork":false,"pushed_at":"2022-08-03T22:15:32.000Z","size":9594,"stargazers_count":29,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-05-06T12:49:21.904Z","etag":null,"topics":["asciicast","automation","cicd","gif","terminal-emulator","themes","ttygif"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/chris17453.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null}},"created_at":"2019-03-25T19:06:25.000Z","updated_at":"2025-05-02T08:46:24.000Z","dependencies_parsed_at":"2022-11-03T22:04:00.159Z","dependency_job_id":null,"html_url":"https://github.com/chris17453/ttygif","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/chris17453/ttygif","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chris17453%2Fttygif","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chris17453%2Fttygif/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chris17453%2Fttygif/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chris17453%2Fttygif/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/chris17453","download_url":"https://codeload.github.com/chris17453/ttygif/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chris17453%2Fttygif/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":261250334,"owners_count":23130544,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["asciicast","automation","cicd","gif","terminal-emulator","themes","ttygif"],"created_at":"2024-08-01T18:01:21.934Z","updated_at":"2026-02-25T05:12:10.048Z","avatar_url":"https://github.com/chris17453.png","language":"Python","funding_links":[],"categories":["automation"],"sub_categories":[],"readme":"# ttygif\n\nA full featured text to gif conversion utility, that just works. It's in beta, so expect rough edges. \nIt's a DIY terminal emulator that reads from STDIN or asciicast file to render themed gif's with layers. Great for documentation and power point presentations.\n\n## ttygif in action\n![htop](https://raw.githubusercontent.com/chris17453/ttygif-assets/master/encode/htop.gif)\n\n## Whats the hell is this?\n- It's sparkling fantastic colorfull terminal output AUTOMATION!\n\n## how do i get it!?\n```bash\n## requirements gcc, python development libs, cython\nyum install python-devel gcc\npip3 install ttygif --user\n```\n\n## What are the benifits \n- pipe output into beautifuly themed gifs\n- asciicast to gif\n- perfect fit for CI/CD\n- it runs headless\n- it can be scripted\n- works with python 2 and 3\n- works on linux, mac, raspberry PI\n- its fast, and easy to install\n- it has themes\n- you can make custom themes!\n- you can add background images from the CLI\n\n\n## It's portable\n\nttygif is self contained with no dependencys other than python/cython. GIF encoding \nand termal emulation are both implimented with internal cython code. No system \nfonts are required.  All you need to get ttygif to work is a c compiler,\npython and its development libs. ttygif is a cython project.\n\n### shipped themes\n\n- default (256 color xterm palette)\n- default-4bit  (16 colorxterm palette)\n- default-2bit  (monochrome palette)\n- windows7 (windows style wrapped terminal)\n- game (8 bit inspired frame)\n- mac (mac styled window)\n- fwdm (old linux style window)\n- scripted (bottom bar with text)\n- opensouirce (bottom bar with text)\n- bar (bottom bar with NO text)\n\n\n## Supported fonts\n- All fonts came from [https://int10h.org/oldschool-pc-fonts](https://int10h.org/oldschool-pc-fonts/)\n- copyright FON conversion © 2015 VileR, license: CC BY-SA 4.0\n- ttygif supports the \"fd\" font format. Basicly text files.\n- All .FON files have been exported to fd files for portability.\n- All fonts are copyright of their perspective owners, not me.\n- default font=Verite_9x16\n\nCheck them all out here -\u003e [fonts.md](/docs/fonts.md)\n\n\n## ttygif-assets\n\nThe following resources are located in the [ttygif-assets](https://github.com/chris17453/ttygif-assets) repo\n\n### Examples\nsome random pics from the asciinema.org website, and my computer\n\n\n## pipe\n![pipe](https://raw.githubusercontent.com/chris17453/ttygif-assets/master/encode/pipe.gif)\n\n## [Terminal ray tracing](https://asciinema.org/a/174524)\n![asciicast-174524](https://raw.githubusercontent.com/chris17453/ttygif-assets/master/encode/174524.gif)\n\n## [term-tris dt cannon](https://asciinema.org/a/232377)\n- with game theme\n![asciicast-232377](https://raw.githubusercontent.com/chris17453/ttygif-assets/master/encode/232377.gif)\n\n## [Denariusd compile on 30 cores!](https://asciinema.org/a/234628)\n![asciicast-234628](https://raw.githubusercontent.com/chris17453/ttygif-assets/master/encode/234628.gif)\n\n## [surpirsed Pikachu](https://asciinema.org/a/236096)\n![asciicast-236096](https://raw.githubusercontent.com/chris17453/ttygif-assets/master/encode/236096.gif)\n\n## [CACA_DRIVER=ncurses cacademo](https://asciinema.org/a/687)\n![asciicast-687](https://raw.githubusercontent.com/chris17453/ttygif-assets/master/encode/687.gif)\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fchris17453%2Fttygif","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fchris17453%2Fttygif","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fchris17453%2Fttygif/lists"}