{"id":19760236,"url":"https://github.com/jmp/farbfeld","last_synced_at":"2025-02-28T02:45:57.447Z","repository":{"id":57428419,"uuid":"167247127","full_name":"jmp/farbfeld","owner":"jmp","description":"A small Python module for reading and writing farbfeld images (https://tools.suckless.org/farbfeld/). Currently supports reading and writing pixel values to/from farbfeld image files.","archived":false,"fork":false,"pushed_at":"2019-08-31T08:08:19.000Z","size":34,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-02-23T16:40:34.214Z","etag":null,"topics":["farbfeld","image","pixels","python"],"latest_commit_sha":null,"homepage":"https://github.com/jmp/farbfeld","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/jmp.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2019-01-23T20:12:48.000Z","updated_at":"2021-11-03T12:39:10.000Z","dependencies_parsed_at":"2022-09-02T18:31:05.553Z","dependency_job_id":null,"html_url":"https://github.com/jmp/farbfeld","commit_stats":null,"previous_names":[],"tags_count":4,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jmp%2Ffarbfeld","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jmp%2Ffarbfeld/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jmp%2Ffarbfeld/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jmp%2Ffarbfeld/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jmp","download_url":"https://codeload.github.com/jmp/farbfeld/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":241090553,"owners_count":19907976,"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":["farbfeld","image","pixels","python"],"created_at":"2024-11-12T03:36:15.051Z","updated_at":"2025-02-28T02:45:57.422Z","avatar_url":"https://github.com/jmp.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# farbfeld.py\n\n[![Build Status](https://travis-ci.org/jmp/farbfeld.svg?branch=master)](https://travis-ci.org/jmp/farbfeld)\n[![codecov](https://codecov.io/gh/jmp/farbfeld/branch/master/graph/badge.svg)](https://codecov.io/gh/jmp/farbfeld)\n[![Language grade: Python](https://img.shields.io/lgtm/grade/python/g/jmp/farbfeld.svg)](https://lgtm.com/projects/g/jmp/farbfeld/context:python)\n[![PyPI version](https://badge.fury.io/py/farbfeld.svg)](https://badge.fury.io/py/farbfeld)\n\nThis is a small Python module for reading and writing pixel data\nfrom farbfeld images (https://tools.suckless.org/farbfeld/).\n\n## Installation\n\nThe module is available on PyPI: https://pypi.org/project/farbfeld/\n\nYou can install it with `pip`:\n\n    pip install farbfeld\n\n## Usage\n\nTo read an image, open the desired file and read the pixels\nfrom it using `farbfeld.read`:\n\n```python\nimport farbfeld\n\nwith open('image.ff', 'rb') as f:\n    data = farbfeld.read(f)\n```\n\nNote that since farbfeld stores pixel components as 16-bit\nunsigned integers, you may have to normalize them or scale\nthem to a different range (e.g. 8-bit). For example, using\nNumPy and Matplotlib:\n\n```python\nimport farbfeld\nimport numpy as np\nimport matplotlib.pyplot as plt\n\nwith open('image.ff', 'rb') as f:\n    data = farbfeld.read(f)\n    data_8bit = np.array(data).astype(np.uint8)\n    plt.imshow(data_8bit, interpolation='nearest')\n    plt.show()\n```\n\nTo write a farbfeld image, open the desired file and write the pixels\ninto it using `farbfeld.write`:\n\n```python\nimport farbfeld\n\n# An example 2x2 image\ndata = [\n    [[1, 2, 3, 4], [5, 6, 7, 8]],\n    [[9, 10, 11, 12], [13, 14, 15, 16]],\n]\n\nwith open('image.ff', 'wb') as f:\n    farbfeld.write(f, data)\n```\n\n## Source code\n\nThe source code is available on GitHub:\nhttps://github.com/jmp/farbfeld\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjmp%2Ffarbfeld","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjmp%2Ffarbfeld","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjmp%2Ffarbfeld/lists"}