YAIL Joins FujiNet: Search, Generate and Stream Pictures to the Atari

On 7 December 2025 the FujiNet project published YAIL 1.5.1, "Yet Another Image Loader", as the first release in its own GitHub organisation. YAIL is Brad Colbert's picture viewer for FujiNet-equipped Ataris. He had written the original in January 2021 and moved it to the FujiNet repositories in April 2025, splitting it into a cc65 client for the Atari and a Python server that does the heavy work. Earlier releases remain in his own brad-colbert/yail repository.

How it works

The idea is simple. An 8-bit Atari cannot decode a JPEG from the web or talk to an image service, but a server on the network can. The YAIL server finds or creates an image, converts it into a format the Atari can show directly, and streams the raw screen data over a TCP connection opened through FujiNet's N: device. The client just puts it on screen.

Three display modes are supported:

  • Graphics 8: 320×220 pixels, dithered black and white;
  • Graphics 9: 80×220 in 16 shades of grey;
  • VBXE: 320×240 in 256 colours, for machines with the VBXE board.

Both GTIA modes use custom display lists to show 220 lines instead of the usual 192. The client reserves a 20 KB frame buffer and loads data on 4 KB boundaries, so the build's linker configuration must not be changed casually.

What you can show

Press a key and a small console appears. Commands include:

  • search <terms>: an image search (the server uses the DDGS metasearch package), streaming a random result; next fetches another;
  • generate <prompt>: an AI-generated image. The server can use OpenAI models (gpt-image-1, DALL·E 3 or 2) or Google's Gemini image models, and the model choice is stored with set model;
  • video: a frame from a webcam attached to the server;
  • gfx 8|9|20 to switch modes, and set server to point the client at another server.

Settings such as the server address and model are saved on the FujiNet itself as app keys, so they survive a reboot. The original version could also load PBM images from disk and save the screen in its own YAI format.

Running it

Boot the YAIL ATR on an Atari with a FujiNet attached. By default the client connects to N:TCP://fujinet.org:5556/. To run your own, install the server package (Python 3.10 or newer). It can stream a folder of your own pictures with --paths, generate images if you give it an OpenAI or Gemini API key, or run as a systemd service on Linux. The client builds with cc65 and the FujiNet library, and Apple II and C64 versions exist so far only as placeholders that do not yet show images.

Where to get it

The Atari client is at github.com/FujiNetWIFI/fujinet-yail-client and the server at github.com/FujiNetWIFI/fujinet-yail-server. The server's PROTOCOL.md describes the wire format, for anyone who wants to write a client for another machine.

Credits