{"id":13503844,"url":"https://github.com/xiph/rav1e","last_synced_at":"2025-05-13T15:03:00.951Z","repository":{"id":38272855,"uuid":"104629023","full_name":"xiph/rav1e","owner":"xiph","description":"The fastest and safest AV1 encoder.","archived":false,"fork":false,"pushed_at":"2025-05-05T01:43:48.000Z","size":17451,"stargazers_count":3861,"open_issues_count":247,"forks_count":261,"subscribers_count":89,"default_branch":"master","last_synced_at":"2025-05-05T22:26:57.002Z","etag":null,"topics":["av1","av1-encoder","hacktoberfest"],"latest_commit_sha":null,"homepage":"","language":"Assembly","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-2-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/xiph.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"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}},"created_at":"2017-09-24T08:12:55.000Z","updated_at":"2025-05-05T15:04:18.000Z","dependencies_parsed_at":"2024-01-10T09:33:24.621Z","dependency_job_id":"c6c73e6c-cdd3-4953-80df-03d60568af03","html_url":"https://github.com/xiph/rav1e","commit_stats":{"total_commits":3939,"total_committers":126,"mean_commits":"31.261904761904763","dds":0.8540238639248541,"last_synced_commit":"77671257a5b1099eab15cc70f9ac45011695360f"},"previous_names":[],"tags_count":269,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xiph%2Frav1e","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xiph%2Frav1e/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xiph%2Frav1e/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xiph%2Frav1e/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/xiph","download_url":"https://codeload.github.com/xiph/rav1e/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253206112,"owners_count":21871162,"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":["av1","av1-encoder","hacktoberfest"],"created_at":"2024-07-31T23:00:46.480Z","updated_at":"2025-05-13T15:03:00.908Z","avatar_url":"https://github.com/xiph.png","language":"Assembly","funding_links":[],"categories":["Assembly","Applications","应用程序 Applications","Encoding","HarmonyOS","Codecs and Encoders"],"sub_categories":["Video","视频 Video","AV1","Windows Manager"],"readme":"# rav1e [![Actions Status][actions badge]][actions] [![CodeCov][codecov badge]][codecov]\n\nThe fastest and safest AV1 encoder.\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003eTable of Content\u003c/b\u003e\u003c/summary\u003e\n\n- [Overview](#overview)\n- [Features](#features)\n- [Documentation](#documentation)\n- [Releases](#releases)\n- [Building](#building)\n  - [Dependency: NASM](#dependency-nasm)\n  - [Release binary](#release-binary)\n  - [Unstable features](#unstable-features)\n  - [Target-specific builds](#target-specific-builds)\n  - [Building the C-API](#building-the-c-api)\n- [Usage](#usage)\n  - [Compressing video](#compressing-video)\n  - [Decompressing video](#decompressing-video)\n  - [Configuring](#configuring)\n    - [Features](#features-1)\n- [Contributing](#contributing)\n- [Getting in Touch](#getting-in-touch)\n\u003c/details\u003e\n\n## Overview\nrav1e is an AV1 video encoder. It is designed to eventually cover all use cases, though in its current form it is most suitable for cases where libaom (the reference encoder) is too slow.\n\n## Features\n* Intra, inter, and switch frames\n* 64x64 superblocks\n* 4x4 to 64x64 RDO-selected square and rectangular blocks\n* DC, H, V, Paeth, smooth, and all directional prediction modes\n* DCT, (FLIP-)ADST and identity transforms (up to 64x64, 16x16 and 32x32 respectively)\n* 8-, 10- and 12-bit depth color\n* 4:2:0, 4:2:2 and 4:4:4 chroma sampling\n* 11 speed settings (0-10, exhaustive to near real-time)\n* Constant quantizer and target bitrate (single- and multi-pass) encoding modes\n* Still picture mode\n\n## Documentation\nFind the documentation in [`doc/`](doc/README.md)\n\n## Releases\nFor the foreseeable future, a weekly pre-release of rav1e will be [published](https://github.com/xiph/rav1e/releases) every Tuesday.\n\n## Building\n\n### Toolchain: Rust\n\nrav1e currently requires Rust 1.74.0 or later to build.\n\n### Dependency: NASM\nSome `x86_64`-specific optimizations require [NASM](https://nasm.us/) `2.14.02` or newer and are enabled by default.\n`strip` will be used if available to remove the local symbols from the asm objects.\n\nThe CI is testing against `nasm 2.15.05`, so bugs for other versions might happen. If you find one please open an issue!\n\n\u003cdetails\u003e\n\u003csummary\u003e\nInstall nasm\n\u003c/summary\u003e\n\n**ubuntu 20.04** (`nasm 2.14.02`)\n```sh\nsudo apt install nasm\n```\n**ubuntu 18.04** (`nasm 2.14.02`)\n```sh\nsudo apt install nasm-mozilla\n# link nasm into $PATH\nsudo ln /usr/lib/nasm-mozilla/bin/nasm /usr/local/bin/\n```\n**fedora 31, 32** (`nasm 2.14.02`)\n```sh\nsudo dnf install nasm\n```\n**windows** (`nasm 2.15.05`) \u003cbr/\u003e\nHave a [NASM binary](https://www.nasm.us/pub/nasm/releasebuilds/) in your system PATH.\n```sh\n$NASM_VERSION=\"2.15.05\" # or newer\n$LINK=\"https://www.nasm.us/pub/nasm/releasebuilds/$NASM_VERSION/win64\"\ncurl --ssl-no-revoke -LO \"$LINK/nasm-$NASM_VERSION-win64.zip\"\n7z e -y \"nasm-$NASM_VERSION-win64.zip\" -o \"C:\\nasm\"\n# set path for the current sessions\nset PATH=\"%PATH%;C:\\nasm\"\n```\n**macOS** (`nasm 2.15.05`)\n```sh\nbrew install nasm\n```\n\n\u003c/details\u003e\n\n### Release binary\nTo build release binary in `target/release/rav1e` run:\n\n```sh\ncargo build --release\n```\n\n### Unstable features\nExperimental API and Features can be enabled by using the `unstable` feature.\n\n```sh\ncargo build --features \u003cfeature\u003e,unstable\n```\n\n#### Current unstable features\n- Channel API:\n```sh\ncargo build --features channel-api,unstable\n```\n\n\nThose Features and API are bound to change and evolve, do not rely on them staying the same over releases.\n\n### Target-specific builds\nThe rust compiler can produce a binary that is about 11%-13% faster if it can use `avx2`, `bmi1`, `bmi2`, `fma`, `lzcnt` and `popcnt` in the general code, you may allow it by issuing:\n\n```sh\nRUSTFLAGS=\"-C target-cpu=native\" cargo build --release\n# or\nRUSTFLAGS=\"-C target-cpu=x86-64-v3\" cargo build --release\n```\n\nThe resulting binary will not work on cpus that do not sport the same set of extensions enabled.\n\n\u003e **NOTE** : You may use `rustc --print target-cpus` to check if the cpu is supported, if not `-C target-cpu=native` would be a no-op.\n\n### Building the C-API\n**rav1e** provides a C-compatible set of library, header and pkg-config file.\n\nTo build and install it you can use [cargo-c](https://crates.io/crates/cargo-c):\n\n```sh\ncargo install cargo-c\ncargo cinstall --release\n```\n\nPlease refer to the cargo-c [installation](https://github.com/lu-zero/cargo-c#installation) instructions.\n\n## Usage\n### Compressing video\nInput videos must be in [y4m format](https://wiki.multimedia.cx/index.php/YUV4MPEG2). The monochrome color format is not supported.\n\n```sh\ncargo run --release --bin rav1e -- input.y4m -o output.ivf\n```\n\n_(Find a y4m-file for testing at [`tests/small_input.y4m`](tests/small_input.y4m) or at http://ultravideo.cs.tut.fi/#testsequences)_\n\n### Decompressing video\nEncoder output should be compatible with any AV1 decoder compliant with the v1.0.0 specification. You can decode using [dav1d](https://code.videolan.org/videolan/dav1d), which is now packaged [![in over 40 repositories](https://repology.org/badge/tiny-repos/dav1d.svg)](https://repology.org/project/dav1d/versions).\n\n```sh\ndav1d -i output.ivf -o output.y4m\n```\n\n### Configuring\nrav1e has several optional features that can be enabled by passing `--features` to cargo. Passing `--all-features` is discouraged.\n\n#### Features\nFind a full list in feature-table in [`Cargo.toml`](Cargo.toml)\n\n* `asm` - enabled by default. When enabled, assembly is built for the platforms supporting it.\n  * `x86_64`: Requires [`nasm`](#dependency-nasm).\n  * `aarch64`\n    * Requires `gas`\n    * Alternative: Use `clang` assembler by setting `CC=clang`\n\n**NOTE**: `SSE2` is always enabled on `x86_64`, `neon` is always enabled for aarch64, you may set the environment variable `RAV1E_CPU_TARGET` to `rust` to disable all the assembly-optimized routines at the runtime.\n\n## Contributing\nPlease read our guide to [contributing to rav1e](CONTRIBUTING.md).\n\n## Getting in Touch\nCome chat with us on the IRC channel #daala on [Libera.Chat](https://libera.chat/)! You can also use a [web client](https://web.libera.chat/?channel=#daala) to join with a web browser.\n\n\n\u003c!-- Links --\u003e\n[actions]: https://github.com/xiph/rav1e/actions\n[codecov]: https://codecov.io/gh/xiph/rav1e\n\n\u003c!-- Badges --\u003e\n[actions badge]: https://github.com/xiph/rav1e/workflows/rav1e/badge.svg\n[codecov badge]: https://codecov.io/gh/xiph/rav1e/branch/master/graph/badge.svg\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fxiph%2Frav1e","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fxiph%2Frav1e","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fxiph%2Frav1e/lists"}