RetroTxt is the WebExtension that turns ANSI, ASCII, NFO text into in-browser HTML
Switch branches/tags
Clone or download
bengarrett Version 3.1
Re-added the ability to make additions to the 'Apply RetroTxt to text files hosted on these websites'
Latest commit 7e58604 Dec 1, 2018
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github/ISSUE_TEMPLATE Update issue templates Nov 29, 2018
.vscode Version 3.0 Nov 18, 2018
_locales Version 3.0 Nov 18, 2018
assets Version 3.0 Nov 18, 2018
css Version 3.1 Nov 30, 2018
docs Version 3.1 Nov 30, 2018
fonts Version 3.0 Nov 18, 2018
html Version 3.1 Nov 30, 2018
libs/tippyjs Version 3.0 Nov 18, 2018
scripts Version 3.1 Nov 30, 2018
test Version 3.0 Nov 18, 2018
.eslintignore Version 3.0 Nov 18, 2018
.eslintrc.js Version 3.0 Nov 18, 2018
.gitattributes Version 1.0 Apr 21, 2016
.gitignore Version 3.1 Nov 30, 2018
.npmignore Version 3.0 Nov 18, 2018
LICENSE Version 2.5 Mar 19, 2018
README.md Version 3.1 Nov 30, 2018
manifest.json Version 3.1 Nov 30, 2018
manifest_chrome.json Version 3.1 Nov 30, 2018
manifest_firefox.json Version 3.1 Nov 30, 2018
package.json Version 3.0 Nov 18, 2018
web-ext-config.js Version 3.0 Nov 18, 2018

README.md

RetroTxt

Turn many pieces of ANSI text art and ASCII/NFO plain text into HTML5 text using RetroTxt. The browser agnostic WebExtension that takes retro text files and stylises them into a more pleasing, useful format to view and copy in a web browser.

Available for installation from both the Chrome web store and Firefox Add-ons.

  • View ANSI, ASCII, NFO, Shift JIS, PCBoard, Wildcat text art as HTML
  • View system and server logs formatted in coloured text with modern fonts
  • RGB 16.7 million, xterm 256 and IBM VGA 16 colour support
  • Swappable ANSI palettes, xterm, VGA, CGA, monochrome and switchable iCE Colors
  • Swappable ASCII & NFO colour themes, DOS, Windows, Amiga, C-64, Apple II, Atari ST
  • SAUCE metadata parsing
  • Multiple text encodings support including CP437, ISO-8959-1, Windows-1252, Shift JIS
  • Text rendering toggles, smeared, shadow and normal
  • Multiple IBM PC font support such as VGA, PS/2, EGA, CGA, MDA plus variants and more
  • Various Amiga fonts plus Mona, Commodore PETSCII, Atari ATASCII, Atari ST and Apple II

Limitations

  • A lot of Bulletin Board System era ANSI art that relied on the 80x25 terminal with cursor positioning to create visual text motion and animations do not convert to HTML

RetroTxt showcase

Documentation

Read

What is new?

Install

Chrome · Firefox

Or use the source code

Requirements

Chrome 55 or Firefox 63 or newer browsers.

Test RetroTxt

You can test the RetroTxt install by clicking on one of the 10 Sample artworks found on the welcome.html tab that launches after installation.

RetroTxt samples

Configuration

Out of the box, certain useful features of RetroTxt are off. Newer browsers require you to grant permission at prompts before RetroTxt can access specific browser data it needs. There are a couple of links to the Options dialogue in the welcome.html tab, or it is accessible from the browser's Extensions tab.

Config tab in Options

Run RetroTxt

Once configured RetroTxt will run on any text or ANSI art file observed in a permitted browser tab and mark the toolbar icon with a check.

RetroTxt toolbar button in Chrome

Elsewhere there are thousands of text files hosted at textfiles.com or the Project Gutenberg plain text books. Or download one of the amazing text art packs created by Blocktronics, found at textmod.es or 16 colors and use the file:/// protocol to browse and view the text art files saved onto your hard drive.

Permissions

Chrome requires Allow access to file URLs selected if you wish to use RetroTxt with text files stored on your local computer.

Privacy

RetroTxt does not collect or transmit any data created by your web browser.

All data generated by the web extension is only ever stored locally on your computer through the use of the browser local or session storage APIs.

RetroTxt Privacy

License

GNU LESSER GENERAL PUBLIC LICENSE

An important note about the license

While RetroTxt uses a GNU Lesser General Public License v3.0, the included fonts are not. You should read each font license that is in the fonts/ subdirectory before redistribution, as some of the added collections do not permit the sale or modification of their fonts and packages.

Credits

RetroTxt by Ben Garrett on Twitter @bens_zone and GitHub

RetroTxt ANSI logo Zeus II Twitter @Zeus_II

Options icons by Google Material Design

Tippy tooltips by atomiks