{"id":19489496,"url":"https://github.com/1j01/ansi-art-thumbnailer","last_synced_at":"2026-06-18T07:32:05.525Z","repository":{"id":167437239,"uuid":"643060981","full_name":"1j01/ansi-art-thumbnailer","owner":"1j01","description":"Thumbnail support for ANSI art files in file browsers","archived":false,"fork":false,"pushed_at":"2023-07-20T01:36:35.000Z","size":21,"stargazers_count":3,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-11-20T07:04:46.126Z","etag":null,"topics":["ans","ansi","ansi-art","artscene","ascii-art","bbs","nautilus","nfo","text-art","thumbnail-generator","thumbnailer","thumbnails"],"latest_commit_sha":null,"homepage":"","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/1j01.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.txt","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}},"created_at":"2023-05-20T01:57:59.000Z","updated_at":"2023-08-21T04:38:23.000Z","dependencies_parsed_at":null,"dependency_job_id":"f77997af-f36d-4d89-b6c1-ed03f8583435","html_url":"https://github.com/1j01/ansi-art-thumbnailer","commit_stats":null,"previous_names":["1j01/ansi-art-thumbnailer"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/1j01/ansi-art-thumbnailer","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/1j01%2Fansi-art-thumbnailer","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/1j01%2Fansi-art-thumbnailer/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/1j01%2Fansi-art-thumbnailer/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/1j01%2Fansi-art-thumbnailer/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/1j01","download_url":"https://codeload.github.com/1j01/ansi-art-thumbnailer/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/1j01%2Fansi-art-thumbnailer/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34481313,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-18T02:00:06.871Z","response_time":128,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["ans","ansi","ansi-art","artscene","ascii-art","bbs","nautilus","nfo","text-art","thumbnail-generator","thumbnailer","thumbnails"],"created_at":"2024-11-10T21:08:45.804Z","updated_at":"2026-06-18T07:32:05.510Z","avatar_url":"https://github.com/1j01.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# ansi-art-thumbnailer\n\nGNOME desktop thumbnailer for ANSI art files (*.ans, *.nfo).\n\n# Installation\n1. Quit all Nautilus processes: `nautilus -q`\n   - __Even if you currently do not have any Nautilus windows open, you should run the command above!__\n2. Delete thumbnails folder: `rm -r ~/.cache/thumbnails`\n3. Clone the repository: `git clone https://github.com/1j01/ansi-art-thumbnailer.git`\n4. Change directory: `cd ansi-art-thumbnailer`\n5. Run make install: `sudo make install`\n   - Warning: this will run PIP as root.\n   - The script uses PIP to install necessary python packages. If you do not have system-wide pip installation,\n    please setup it first with `sudo apt install python3-pip`.\n\nFrom now on, the thumbnails should be visible.\n\n# Uninstallation\n1. Run make uninstall: `sudo make uninstall`\n2. Quit file managers and delete cached thumbnails folder, as during installation.\n\n# Troubleshooting\n#### Thumbnails do no show up on some Ubuntu-based distributions 18.04 and later\nMost likely it is a problem with bubblewrap \n([1](https://askubuntu.com/questions/1279091/nautilus-thumbnailer-for-ms-office-documents-in-ubuntu-20),\n[2](https://askubuntu.com/questions/1088539/custom-thumbnailers-don-t-work-on-ubuntu-18-10-and-18-04),\nand many more threads online). The short workaround fix (NOT recommended) would be to install a bwrap wrapper in `/usr/local/bin`:\n```\nsudo wget -O /usr/local/bin/bwrap https://raw.githubusercontent.com/NicolasBernaerts/ubuntu-scripts/master/nautilus/bwrap\nsudo chmod +rx /usr/local/bin/bwrap\n```\nInstead, consider updating to the latest version of Ubuntu, where this issue is already fixed.\n\n#### ANSI art is not rendered properly\n\nThe script currently assumes UTF-8 encoding, which is uncommon for ANSI art files.\n\nTODO: detect encoding\n\n# Credits\n\nBased on [mrc-em-gnome-thumbnailer](https://github.com/the-lay/mrc-em-gnome-thumbnailer), particularly the Makefile was useful!\nBut also the overall repository structure.\n\nUses [Stransi](https://pypi.org/project/stransi/) to parse ANSI escape sequences, and [Pillow](https://pypi.org/project/Pillow/) to render the text.\n\n# License\n\n[MIT](LICENSE.txt)\n\n# See also\n\n- [ansilove](https://github.com/ansilove/ansilove) - ANSI art to PNG converter. This would probably be a better thumbnailer, as it supports more formats, and fonts! There's also a [library version](https://github.com/ansilove/libansilove), but that's probably not needed for using it as a thumbnailer.\n- [Textual Paint](https://github.com/1j01/textual-paint) - ANSI art editor TUI inspired by MS Paint","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F1j01%2Fansi-art-thumbnailer","html_url":"https://awesome.ecosyste.ms/projects/github.com%2F1j01%2Fansi-art-thumbnailer","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F1j01%2Fansi-art-thumbnailer/lists"}