# Pixelterm
## Render images, shapes, and videos in the terminal
Pixelterm allows you to draw on modern terminal windows using "pixels" instead of just characters.
The "pixels" Pixelterm uses are exactly 1 character wide and 1/2 of a character tall.
### Features
- Draw lines, boxes, custom fonts*, images, and gradients on "frames" (representations of pixels)
- Optimized rendering between frames (in case of animations/videos)
- Flexible coloring/styling utility for printing text with any foreground/background color and style (bold, italic, underline, etc.)
*All custom fonts must be monospaced, and only one is provided by default. For details on how to create your own, see `pixelterm/font.py`. Note that these fonts will be relatively large because of the low number of pixels that can fit on a terminal screen.
### Installation
```
pip install pixelterm
```
Dependencies: numpy, scikit-image, pillow
### Examples
- Snake (`examples/snake`)
- Geometry Dash clone ([repository](https://github.com/crystaltine/vis/tree/main/gd))
- Bad Apple!! (`examples/bad_apple`)
- Bad Apple!! w/ transparent DVD screensavers bouncing around (`examples/terrible_apple`)
Raw data
{
"_id": null,
"home_page": null,
"name": "pixelterm",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.10",
"maintainer_email": null,
"keywords": "ansi, ascii, console, graphics, rendering, terminal",
"author": null,
"author_email": "crystaltine <msh379c@outlook.com>",
"download_url": "https://files.pythonhosted.org/packages/68/d0/944ede5e8e9767f908685da96e731227813a7ef806803d00476d290c75a3/pixelterm-1.0.5.tar.gz",
"platform": null,
"description": "# Pixelterm\n## Render images, shapes, and videos in the terminal\n\nPixelterm allows you to draw on modern terminal windows using \"pixels\" instead of just characters.\n\nThe \"pixels\" Pixelterm uses are exactly 1 character wide and 1/2 of a character tall.\n\n### Features\n- Draw lines, boxes, custom fonts*, images, and gradients on \"frames\" (representations of pixels)\n- Optimized rendering between frames (in case of animations/videos)\n- Flexible coloring/styling utility for printing text with any foreground/background color and style (bold, italic, underline, etc.)\n\n*All custom fonts must be monospaced, and only one is provided by default. For details on how to create your own, see `pixelterm/font.py`. Note that these fonts will be relatively large because of the low number of pixels that can fit on a terminal screen.\n\n### Installation\n```\npip install pixelterm\n```\n\nDependencies: numpy, scikit-image, pillow\n\n### Examples\n- Snake (`examples/snake`)\n- Geometry Dash clone ([repository](https://github.com/crystaltine/vis/tree/main/gd))\n- Bad Apple!! (`examples/bad_apple`)\n- Bad Apple!! w/ transparent DVD screensavers bouncing around (`examples/terrible_apple`)\n\n\n",
"bugtrack_url": null,
"license": null,
"summary": "Terminal Graphics Rendering Library",
"version": "1.0.5",
"project_urls": {
"Homepage": "https://github.com/crystaltine/pixelterm",
"Issues": "https://github.com/crystaltine/pixelterm/issues",
"Repository": "https://github.com/crystaltine/pixelterm"
},
"split_keywords": [
"ansi",
" ascii",
" console",
" graphics",
" rendering",
" terminal"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "98ee7e54e5d76ad9177bacc9dd02f390fd653caaa1f4dcd53dd4937ad7bccdb4",
"md5": "d511611cead66d9bbba747d40c34ad07",
"sha256": "d961c9f7fe5866205dc8a6827dac777e8cf6303345dc5a600e02a836f4e087ff"
},
"downloads": -1,
"filename": "pixelterm-1.0.5-py3-none-any.whl",
"has_sig": false,
"md5_digest": "d511611cead66d9bbba747d40c34ad07",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.10",
"size": 16119,
"upload_time": "2024-07-24T06:35:20",
"upload_time_iso_8601": "2024-07-24T06:35:20.599106Z",
"url": "https://files.pythonhosted.org/packages/98/ee/7e54e5d76ad9177bacc9dd02f390fd653caaa1f4dcd53dd4937ad7bccdb4/pixelterm-1.0.5-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "68d0944ede5e8e9767f908685da96e731227813a7ef806803d00476d290c75a3",
"md5": "1346789cf77bdad67298216879bb3504",
"sha256": "938106b03bcef418197f746c8a254f9f790d59cfe3f16c6d3168beef54f52cae"
},
"downloads": -1,
"filename": "pixelterm-1.0.5.tar.gz",
"has_sig": false,
"md5_digest": "1346789cf77bdad67298216879bb3504",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.10",
"size": 16149128,
"upload_time": "2024-07-24T06:35:27",
"upload_time_iso_8601": "2024-07-24T06:35:27.762856Z",
"url": "https://files.pythonhosted.org/packages/68/d0/944ede5e8e9767f908685da96e731227813a7ef806803d00476d290c75a3/pixelterm-1.0.5.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-07-24 06:35:27",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "crystaltine",
"github_project": "pixelterm",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"requirements": [
{
"name": "numpy",
"specs": []
},
{
"name": "scikit-image",
"specs": []
},
{
"name": "pillow",
"specs": []
}
],
"lcname": "pixelterm"
}
JSON
