{"id":13429094,"url":"https://github.com/libjxl/libjxl","last_synced_at":"2025-05-13T18:08:53.659Z","repository":{"id":36952446,"uuid":"340219494","full_name":"libjxl/libjxl","owner":"libjxl","description":"JPEG XL image format reference implementation","archived":false,"fork":false,"pushed_at":"2025-05-12T11:28:35.000Z","size":38016,"stargazers_count":2950,"open_issues_count":372,"forks_count":292,"subscribers_count":31,"default_branch":"main","last_synced_at":"2025-05-12T12:37:18.046Z","etag":null,"topics":["codec","decoder","encoder","image-compression","images","jpeg","jpeg-xl","jxl","lossless-compression-algorithm","lossless-image-compression","lossless-images","lossy","lossy-compression","lossy-image-compression","photography","photos"],"latest_commit_sha":null,"homepage":"","language":"C++","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-3-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/libjxl.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":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":"AUTHORS","dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2021-02-19T00:56:12.000Z","updated_at":"2025-05-12T11:28:38.000Z","dependencies_parsed_at":"2023-09-21T18:56:37.153Z","dependency_job_id":"ad8f9a07-6b4a-4a9b-b4aa-0ed8d091199f","html_url":"https://github.com/libjxl/libjxl","commit_stats":{"total_commits":2614,"total_committers":103,"mean_commits":25.37864077669903,"dds":0.8209640397857689,"last_synced_commit":"ad84ee99e3f0c33a7d408315668818265870eba2"},"previous_names":[],"tags_count":49,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/libjxl%2Flibjxl","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/libjxl%2Flibjxl/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/libjxl%2Flibjxl/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/libjxl%2Flibjxl/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/libjxl","download_url":"https://codeload.github.com/libjxl/libjxl/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254000850,"owners_count":21997441,"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":["codec","decoder","encoder","image-compression","images","jpeg","jpeg-xl","jxl","lossless-compression-algorithm","lossless-image-compression","lossless-images","lossy","lossy-compression","lossy-image-compression","photography","photos"],"created_at":"2024-07-31T02:00:25.099Z","updated_at":"2025-05-13T18:08:53.632Z","avatar_url":"https://github.com/libjxl.png","language":"C++","funding_links":[],"categories":["Image","Image Processing","C++","Encoding \u0026 Codecs"],"sub_categories":["Availability \u0026 compatability"],"readme":"# JPEG XL reference implementation\n\n[![Build/Test](https://github.com/libjxl/libjxl/actions/workflows/build_test.yml/badge.svg)](\nhttps://github.com/libjxl/libjxl/actions/workflows/build_test.yml)\n[![Build/Test Cross](https://github.com/libjxl/libjxl/actions/workflows/build_test_cross.yml/badge.svg)](\nhttps://github.com/libjxl/libjxl/actions/workflows/build_test_cross.yml)\n[![Conformance](https://github.com/libjxl/libjxl/actions/workflows/conformance.yml/badge.svg)](\nhttps://github.com/libjxl/libjxl/actions/workflows/conformance.yml)\n[![CIFuzz](https://github.com/libjxl/libjxl/actions/workflows/fuzz.yml/badge.svg)](\nhttps://github.com/libjxl/libjxl/actions/workflows/fuzz.yml)\n[![Releases](https://github.com/libjxl/libjxl/actions/workflows/release.yaml/badge.svg)](\nhttps://github.com/libjxl/libjxl/actions/workflows/release.yaml)\n[![Doc](https://readthedocs.org/projects/libjxl/badge/?version=latest)](\nhttps://libjxl.readthedocs.io/en/latest/?badge=latest)\n[![OpenSSF Best Practices](https://www.bestpractices.dev/projects/7845/badge)](\nhttps://www.bestpractices.dev/projects/7845)\n[![OpenSSF Scorecard](https://api.securityscorecards.dev/projects/github.com/libjxl/libjxl/badge)](\nhttps://securityscorecards.dev/viewer/?uri=github.com/libjxl/libjxl)\n[![codecov](https://codecov.io/gh/libjxl/libjxl/branch/main/graph/badge.svg)](\nhttps://codecov.io/gh/libjxl/libjxl)\n\n\u003cimg src=\"doc/jxl.svg\" width=\"100\" align=\"right\" alt=\"JXL logo\"\u003e\n\nThis repository contains a reference implementation of JPEG XL (encoder and\ndecoder), called `libjxl`. This software library is\n[used by many applications that support JPEG XL](doc/software_support.md).\n\nJPEG XL was standardized in 2022 as [ISO/IEC 18181](https://jpeg.org/jpegxl/workplan.html).\nThe [core codestream](doc/format_overview.md#codestream-features) is specified in 18181-1,\nthe [file format](doc/format_overview.md#file-format-features) in 18181-2.\n[Decoder conformance](https://github.com/libjxl/conformance) is defined in 18181-3,\nand 18181-4 is the [reference software](https://github.com/libjxl/libjxl).\n\nThe library API, command line options, and tools in this repository are subject\nto change, however files encoded with `cjxl` conform to the JPEG XL specification\nand can be decoded with current and future `djxl` decoders or the `libjxl` decoding library.\n\n## Installation\n\nIn most Linux distributions, installing `libjxl` is just a matter of using the package management system.\nFor example in Debian-based distributions: `apt install libjxl-tools` will install `cjxl` and `djxl`\nand other tools like `benchmark_xl` are available in the package `libjxl-devtools`.\nOn MacOS, you can use [Homebrew](https://brew.sh/): `brew install jpeg-xl`.\n\n[![libjxl packaging status](https://repology.org/badge/vertical-allrepos/libjxl.svg?exclude_unsupported=1\u0026columns=3\u0026exclude_sources=modules,site\u0026header=libjxl%20packaging%20status)](https://repology.org/project/libjxl/versions)\n\nFrom the [releases page](https://github.com/libjxl/libjxl/releases/) the following can be downloaded:\n - Windows binaries \n - Debian and Ubuntu .deb packages \n\nOf course you can also [build libjxl from sources](BUILDING.md).\n\n\n## Usage\n\nTo encode a source image to JPEG XL with default settings:\n\n```bash\ncjxl input.png output.jxl\n```\n\nThe desired visual fidelity can be selected using the `--distance` parameter\n(in units of just-noticeable difference, where 0 is lossless and the most useful lossy range is 0.5 .. 3.0),\nor using `--quality` (on a scale from 0 to 100, roughly matching libjpeg).\nThe [encode effort](doc/encode_effort.md) can be selected using the `--effort` parameter.\n\nFor more settings run `cjxl --help` or for a full list of options\nrun `cjxl -v -v --help`.\n\nTo decode a JPEG XL file run:\n\n```bash\ndjxl input.jxl output.png\n```\n\nWhen possible, `cjxl`/`djxl` are able to read/write the following image formats:\nOpenEXR (`.exr`), GIF (`.gif`), JPEG (`.jpg`/`.jpeg`), NetPBM (`.pam`/`.pgm`/`.ppm`),\nPortable FloatMap (`.pfm`), PGX Test Format (`.pgx`), Portable Network Graphics (`.png`),\nAnimated PNG (`.png`/`.apng`), and JPEG XL itself (`.jxl`).\n\nSpecifically for JPEG files, the default `cjxl` behavior is to apply lossless\nrecompression and the default `djxl` behavior is to reconstruct the original\nJPEG file (when the extension of the output file is `.jpg`).\n\n### Benchmarking\n\nFor speed benchmarks on single images in single or multi-threaded decoding\n`djxl` can print decoding speed information. See `djxl --help` for details\non the decoding options and note that the output image is optional for\nbenchmarking purposes.\n\nFor more comprehensive benchmarking options, see the\n[benchmarking guide](doc/benchmarking.md).\n\n### Library API\n\nBesides the `libjxl` library [API documentation](https://libjxl.readthedocs.io/en/latest/),\nthere are [example applications](examples/) and [plugins](plugins/) that can be used as a reference or\nstarting point for developers who wish to integrate `libjxl` in their project.\n\n\n## License\n\nThis software is available under a 3-clause BSD license which can be found in\nthe [LICENSE](LICENSE) file, with an \"Additional IP Rights Grant\" as outlined in\nthe [PATENTS](PATENTS) file.\n\nPlease note that the PATENTS file only mentions Google since Google is the legal\nentity receiving the Contributor License Agreements (CLA) from all contributors\nto the JPEG XL Project, including the initial main contributors to the JPEG XL\nformat: Cloudinary and Google.\n\n## Additional documentation\n\n### Codec description\n\n*   [JPEG XL Format Overview](doc/format_overview.md)\n*   [Introductory paper](https://www.spiedigitallibrary.org/proceedings/Download?fullDOI=10.1117%2F12.2529237) (open-access)\n*   [XL Overview](doc/xl_overview.md) - a brief introduction to the source code modules\n*   [JPEG XL white paper](https://ds.jpeg.org/whitepapers/jpeg-xl-whitepaper.pdf)\n*   [JPEG XL official website](https://jpeg.org/jpegxl)\n*   [JPEG XL community website](https://jpegxl.info)\n\n### Development process\n\n*   [More information on testing/build options](doc/building_and_testing.md)\n*   [Git guide for JPEG XL](doc/developing_in_github.md) - for developers\n*   [Fuzzing](doc/fuzzing.md) - for developers\n*   [Building Web Assembly artifacts](doc/building_wasm.md)\n*   [Test coverage on Codecov.io](https://app.codecov.io/gh/libjxl/libjxl) - for\n    developers\n*   [libjxl documentation on readthedocs.io](https://libjxl.readthedocs.io/)\n*   The development of jpegli, the improved JPEG encoder and decoder, will continue at https://github.com/google/jpegli\n\n### Contact\n\nIf you encounter a bug or other issue with the software, please open an Issue here.\n\nThere is a [subreddit about JPEG XL](https://www.reddit.com/r/jpegxl/), and\ninformal chatting with developers and early adopters of `libjxl` can be done on the\n[JPEG XL Discord server](https://discord.gg/DqkQgDRTFu).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flibjxl%2Flibjxl","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flibjxl%2Flibjxl","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flibjxl%2Flibjxl/lists"}