https://github.com/1j01/ansi-art-thumbnailer
Thumbnail support for ANSI art files in file browsers
https://github.com/1j01/ansi-art-thumbnailer
ans ansi ansi-art artscene ascii-art bbs nautilus nfo text-art thumbnail-generator thumbnailer thumbnails
Last synced: 4 months ago
JSON representation
Thumbnail support for ANSI art files in file browsers
- Host: GitHub
- URL: https://github.com/1j01/ansi-art-thumbnailer
- Owner: 1j01
- License: mit
- Created: 2023-05-20T01:57:59.000Z (about 2 years ago)
- Default Branch: main
- Last Pushed: 2023-07-20T01:36:35.000Z (almost 2 years ago)
- Last Synced: 2025-01-08T08:40:42.375Z (5 months ago)
- Topics: ans, ansi, ansi-art, artscene, ascii-art, bbs, nautilus, nfo, text-art, thumbnail-generator, thumbnailer, thumbnails
- Language: Python
- Homepage:
- Size: 20.5 KB
- Stars: 3
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.txt
Awesome Lists containing this project
README
# ansi-art-thumbnailer
GNOME desktop thumbnailer for ANSI art files (*.ans, *.nfo).
# Installation
1. Quit all Nautilus processes: `nautilus -q`
- __Even if you currently do not have any Nautilus windows open, you should run the command above!__
2. Delete thumbnails folder: `rm -r ~/.cache/thumbnails`
3. Clone the repository: `git clone https://github.com/1j01/ansi-art-thumbnailer.git`
4. Change directory: `cd ansi-art-thumbnailer`
5. Run make install: `sudo make install`
- Warning: this will run PIP as root.
- The script uses PIP to install necessary python packages. If you do not have system-wide pip installation,
please setup it first with `sudo apt install python3-pip`.
From now on, the thumbnails should be visible.
# Uninstallation
1. Run make uninstall: `sudo make uninstall`
2. Quit file managers and delete cached thumbnails folder, as during installation.
# Troubleshooting
#### Thumbnails do no show up on some Ubuntu-based distributions 18.04 and later
Most likely it is a problem with bubblewrap
([1](https://askubuntu.com/questions/1279091/nautilus-thumbnailer-for-ms-office-documents-in-ubuntu-20),
[2](https://askubuntu.com/questions/1088539/custom-thumbnailers-don-t-work-on-ubuntu-18-10-and-18-04),
and many more threads online). The short workaround fix (NOT recommended) would be to install a bwrap wrapper in `/usr/local/bin`:
```
sudo wget -O /usr/local/bin/bwrap https://raw.githubusercontent.com/NicolasBernaerts/ubuntu-scripts/master/nautilus/bwrap
sudo chmod +rx /usr/local/bin/bwrap
```
Instead, consider updating to the latest version of Ubuntu, where this issue is already fixed.
#### ANSI art is not rendered properly
The script currently assumes UTF-8 encoding, which is uncommon for ANSI art files.
TODO: detect encoding
# Credits
Based on [mrc-em-gnome-thumbnailer](https://github.com/the-lay/mrc-em-gnome-thumbnailer), particularly the Makefile was useful!
But also the overall repository structure.
Uses [Stransi](https://pypi.org/project/stransi/) to parse ANSI escape sequences, and [Pillow](https://pypi.org/project/Pillow/) to render the text.
# License
[MIT](LICENSE.txt)
# See also
- [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.
- [Textual Paint](https://github.com/1j01/textual-paint) - ANSI art editor TUI inspired by MS Paint