{"id":13434820,"url":"https://github.com/asciinema/asciinema","last_synced_at":"2025-05-13T11:05:39.647Z","repository":{"id":1896851,"uuid":"2823326","full_name":"asciinema/asciinema","owner":"asciinema","description":"Terminal session recorder 📹","archived":false,"fork":false,"pushed_at":"2025-05-12T09:36:10.000Z","size":3378,"stargazers_count":15036,"open_issues_count":18,"forks_count":934,"subscribers_count":282,"default_branch":"develop","last_synced_at":"2025-05-13T11:05:06.077Z","etag":null,"topics":["asciicast","asciinema","cli","recorder","recording","rust","terminal"],"latest_commit_sha":null,"homepage":"https://asciinema.org","language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/asciinema.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null},"funding":{"github":"ku1ik","liberapay":"ku1ik"}},"created_at":"2011-11-21T21:45:44.000Z","updated_at":"2025-05-13T10:46:51.000Z","dependencies_parsed_at":"2023-07-05T16:00:12.935Z","dependency_job_id":"7f2b249b-b503-49ad-8cf4-b8267fbe9312","html_url":"https://github.com/asciinema/asciinema","commit_stats":{"total_commits":844,"total_committers":52,"mean_commits":16.23076923076923,"dds":"0.23696682464454977","last_synced_commit":"08e40ba5bacd4f4899cbec30b0c201a6730ff823"},"previous_names":["asciinema/asciinema-cli"],"tags_count":29,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/asciinema%2Fasciinema","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/asciinema%2Fasciinema/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/asciinema%2Fasciinema/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/asciinema%2Fasciinema/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/asciinema","download_url":"https://codeload.github.com/asciinema/asciinema/tar.gz/refs/heads/develop","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253929362,"owners_count":21985802,"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","asciinema","cli","recorder","recording","rust","terminal"],"created_at":"2024-07-31T03:00:24.125Z","updated_at":"2025-05-13T11:05:39.634Z","avatar_url":"https://github.com/asciinema.png","language":"Rust","funding_links":["https://github.com/sponsors/ku1ik","https://liberapay.com/ku1ik"],"categories":["Python","HarmonyOS","Rust","Tools and Plugins","\u003ca id=\"tag-dev\" href=\"#tag-dev\"\u003eDev\u003c/a\u003e","Images","Applications","Multimedia","Showcases \u0026 Inspiration","Documentation and Presentation","Python (144)","By Language","cli","终端","Tools","Awesome Tools","Developer Tools","General Tools","\u003ca name=\"screen-recorder\"\u003e\u003c/a\u003eScreen recorder","🛠️ Developer Tools","Developer Utilities","Media"],"sub_categories":["Windows Manager","Windows","\u003ca id=\"tag-dev-other\" href=\"#tag-dev-other\"\u003eOther Dev projects\u003c/a\u003e","Gif Creation","Graphics","Video","Rust","网络服务_其他","Python","EduTech","Command Line Tools","Multimedia"],"readme":"# asciinema\n\n[![Build Status](https://github.com/asciinema/asciinema/actions/workflows/ci.yml/badge.svg)](https://github.com/asciinema/asciinema/actions/workflows/asciinema.yml)\n[![license](http://img.shields.io/badge/license-GNU-blue.svg)](https://raw.githubusercontent.com/asciinema/asciinema/master/LICENSE)\n\n__asciinema__ (aka asciinema CLI or asciinema recorder) is a command-line tool\nfor recording terminal sessions.\n\nUnlike typical _screen_ recording software, which records visual output of a\nscreen into a heavyweight video files (`.mp4`, `.mov`), asciinema recorder runs\n_inside a terminal_, capturing terminal session output into a lightweight\nrecording files in the\n[asciicast](https://docs.asciinema.org/manual/asciicast/v2/) format (`.cast`).\n\nThe recordings can be replayed in a terminal, embedded on a web page with the\n[asciinema player](https://docs.asciinema.org/manual/player/), or published to\nan [asciinema server](https://docs.asciinema.org/manual/server/), such as\n[asciinema.org](https://asciinema.org), for further sharing.\n\n[![asciinema CLI\ndemo](https://asciinema.org/a/85R4jTtjKVRIYXTcKCNq0vzYH.svg)](https://asciinema.org/a/85R4jTtjKVRIYXTcKCNq0vzYH?autoplay=1)\n\nNotable features:\n\n* [recording](https://docs.asciinema.org/manual/cli/usage/#asciinema-rec-filename)\n  and\n  [replaying](https://docs.asciinema.org/manual/cli/usage/#asciinema-play-filename)\n  of sessions inside a terminal,\n* live streaming of terminal sessions, via local HTTP server, and via remote asciinema server,\n* [light-weight recording\n  format](https://docs.asciinema.org/manual/asciicast/v2/), which is highly\n  compressible (down to 15% of the original size e.g. with `zstd` or `gzip`),\n* integration with [asciinema\n  server](https://docs.asciinema.org/manual/server/), e.g.\n  [asciinema.org](https://asciinema.org), for easy recording hosting.\n\nTo record a session run this command in your shell:\n\n```sh\nasciinema rec demo.cast\n```\n\nTo stream a session via built-in HTTP server run:\n\n```sh\nasciinema stream --local\n```\n\nTo stream a session via a relay (asciinema server) run:\n\n```sh\nasciinema stream --remote\n```\n\nCheck out the [Getting started\nguide](https://docs.asciinema.org/getting-started/) for installation and usage\noverview.\n\n## Building\n\nBuilding asciinema from source requires the [Rust](https://www.rust-lang.org/)\ncompiler (1.75 or later), and the [Cargo package\nmanager](https://doc.rust-lang.org/cargo/). If they are not available via your\nsystem package manager then use [rustup](https://rustup.rs/).\n\nTo download the source code, build the asciinema binary, and install it in\n`$HOME/.cargo/bin` run:\n\n```sh\ncargo install --locked --git https://github.com/asciinema/asciinema\n```\n\nThen, ensure `$HOME/.cargo/bin` is in your shell's `$PATH`.\n\nAlternatively, you can manually download the source code and build the asciinema\nbinary with:\n\n```sh\ngit clone https://github.com/asciinema/asciinema\ncd asciinema\ncargo build --release\n```\n\nThis produces the binary in _release mode_ (`--release`) at\n`target/release/asciinema`. You can just copy the binary to a directory in your\n`$PATH`.\n\nTo generate man pages and shell completion files, set `ASCIINEMA_GEN_DIR` to the\npath where these artifacts should be stored. For example:\n\n```sh\nASCIINEMA_GEN_DIR=/foo cargo build --release\n```\n\nThe above command will build the binary and place the man pages in `/foo/man/`,\nand the shell completion files in the `/foo/completion/` directory.\n\n\u003e [!NOTE]\n\u003e Windows is currently not supported. _(See [#467](https://github.com/asciinema/asciinema/issues/467))_\n\n## Development\n\nThis branch contains the next generation of the asciinema CLI, written in Rust\n([about the\nrewrite](https://discourse.asciinema.org/t/rust-rewrite-of-the-asciinema-cli/777)).\nIt is still in a work-in-progress stage, so if you wish to propose any code\nchanges, please first reach out to the team via\n[forum](https://discourse.asciinema.org/),\n[Matrix](https://matrix.to/#/#asciinema:matrix.org) or\n[IRC](https://web.libera.chat/#asciinema).\n\nThe previous generation of the asciinema CLI, written in Python, can be found in\nthe `main` branch.\n\n## Donations\n\nSustainability of asciinema development relies on donations and sponsorships.\n\nPlease help the software project you use and love. Become a\n[supporter](https://docs.asciinema.org/donations/#individuals) or a [corporate\nsponsor](https://docs.asciinema.org/donations/#corporate-sponsorship).\n\nasciinema is sponsored by:\n\n- [Brightbox](https://www.brightbox.com/)\n- [DataDog](https://datadoghq.com/)\n\n## Consulting\n\nIf you're interested in integration or customization of asciinema to suit your\nneeds, check [asciinema consulting\nservices](https://docs.asciinema.org/consulting/).\n\n## License\n\n© 2011 Marcin Kulik.\n\nAll code is licensed under the GPL, v3 or later. See [LICENSE](./LICENSE) file\nfor details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fasciinema%2Fasciinema","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fasciinema%2Fasciinema","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fasciinema%2Fasciinema/lists"}