{"id":27976562,"url":"https://github.com/imageio/imageio-freeimage","last_synced_at":"2025-07-29T00:36:21.398Z","repository":{"id":47844882,"uuid":"511864244","full_name":"imageio/imageio-freeimage","owner":"imageio","description":"A plugin for ImageIO that wraps the FreeImage library","archived":false,"fork":false,"pushed_at":"2024-05-10T17:26:30.000Z","size":54,"stargazers_count":8,"open_issues_count":3,"forks_count":3,"subscribers_count":4,"default_branch":"master","last_synced_at":"2025-04-30T00:38:21.687Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/imageio.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2022-07-08T11:03:11.000Z","updated_at":"2025-02-08T18:00:40.000Z","dependencies_parsed_at":"2023-01-19T16:15:36.660Z","dependency_job_id":null,"html_url":"https://github.com/imageio/imageio-freeimage","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/imageio%2Fimageio-freeimage","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/imageio%2Fimageio-freeimage/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/imageio%2Fimageio-freeimage/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/imageio%2Fimageio-freeimage/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/imageio","download_url":"https://codeload.github.com/imageio/imageio-freeimage/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252980837,"owners_count":21835324,"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":[],"created_at":"2025-05-08T01:28:05.890Z","updated_at":"2025-05-08T01:28:06.507Z","avatar_url":"https://github.com/imageio.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# ImageIO FreeImage\n\n[![CI](https://github.com/imageio/imageio-freeimage/actions/workflows/ci.yaml/badge.svg?branch=master)](https://github.com/imageio/imageio-freeimage/actions/workflows/ci.yaml)\n\n\u003e **Warning**\n\u003e \n\u003e This repo is licensed under the *FreeImage Open Source Dual-License* and\n\u003e **not** the typical *BSD-2* license we use for everything else. Check out the\n\u003e LICENSE document in this repo and make sure you understand the consequences.\n\nImageIO FreeImage is a ImageIO plugin for the FreeImage library. In other words,\nit allows using [FreeImage](https://freeimage.sourceforge.io/) with\n[ImageIO](https://github.com/imageio/imageio).\n\n## Installation\n\n```\npip install imageio-freeimage\npython -c \"imageio.plugins.freeimage.download()\"\n```\n\n## Usage (and Examples)\n\nTo use it simply import the library. It will auto-register with ImageIO.\n\n```python\nimport imageio.v3 as iio\nimport imageio_freeimage\n\nimg = iio.imread(\"imageio:chelsea.png\", plugin=\"PNG-FI\")\n```\n\n## Why ImageIO FreeImage\n\nBased on discussions over at ImageIO's main repository, we have decided to spin\nout the FreeImage plugin. This was done for several reasons\n\n1. It is/was unclear how permissible the FreeImage license is, how exactly it\ninteracts with BSD (ImageIO's license), and what that means for downstream users\nwho don't need FreeImage. Instead of having to deal with the fallout of this\ninteraction, we decided to spin out the FreeImage plugin. This way, users don't\nhave to worry, unless they explicitly need FreeImage, in which case they will\nlikely be aware of how FreeImage is licensed, and what it means for their\nproject.\n\n2. The FreeImage bindings we provide are based on ctypes. In many cases this is\nnot a problem; however, for some users it causes complications, because they,\nfor example, use pypy or other non-cpython interpreters or they want to complile\ntheir python code in a browser via pyodide. Those use-cases are more prone to\nproblems when ctypes are involved and having them in a dedicated optional\ndependency make this situation easier.\n\n3. Having a dedicated repo for the FreeImage plugin will eventually allow us to\ninstall the FreeImage library at install time, instead of having to ask users to\nperform post-install steps to download the library. This might also have\npositive implications on platform availability and introspection as we can\neventually compile FreeImage while building the package.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fimageio%2Fimageio-freeimage","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fimageio%2Fimageio-freeimage","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fimageio%2Fimageio-freeimage/lists"}