Pictures made to sit quietly behind terminal text.

A Background Set is a group of images made to go behind a terminal. Batty 1.4.0 browses these sets in its Background Images picker and uses any image as a terminal background. Anyone can publish a set of their own: it takes a folder of images, one small JSON file and a web host.

Click a thumbnail for the full-size image.

Future Cities

  • Skyline in the Fog
    Skyline in the Fog
  • Canal After Rain
    Canal After Rain
  • Sky Gardens at Dawn
    Sky Gardens at Dawn
  • Maglev at Dusk
    Maglev at Dusk
  • Desert Dome
    Desert Dome
  • Harbor Lights
    Harbor Lights
  • Floating District
    Floating District
  • Tower in the Clouds
    Tower in the Clouds

Cool Vehicles

  • Café Racer in the Garage
    Café Racer in the Garage
  • Expedition Truck on the Salt Flat
    Expedition Truck on the Salt Flat
  • Endurance Racer at Night
    Endurance Racer at Night
  • Pickup in the Fog
    Pickup in the Fog
  • Electric Bike on the Roof
    Electric Bike on the Roof
  • Roadster on the Coast at Dusk
    Roadster on the Coast at Dusk
  • Rally Car in the Dust
    Rally Car in the Dust
  • Semi Truck on the Night Highway
    Semi Truck on the Night Highway

Beautiful Landscapes

  • Mountain Lake at Blue Hour
    Mountain Lake at Blue Hour
  • Dunes at Dusk
    Dunes at Dusk
  • Misty Forest Valley
    Misty Forest Valley
  • Aurora over the Tundra
    Aurora over the Tundra
  • Sea Cliffs Under Cloud
    Sea Cliffs Under Cloud
  • Glacier Lagoon at Twilight
    Glacier Lagoon at Twilight
  • Rolling Hills at Night
    Rolling Hills at Night
  • Canyon at Dusk
    Canyon at Dusk

Deep Space

  • Cruiser Rim Light
    Cruiser Rim Light
  • Ringed Planet Limb
    Ringed Planet Limb
  • Emission Nebula
    Emission Nebula
  • Orbit at Sunrise
    Orbit at Sunrise
  • Engine Trail
    Engine Trail
  • Ring Station
    Ring Station
  • Fleet Across the Dust Lane
    Fleet Across the Dust Lane
  • Distant Galaxy
    Distant Galaxy

San Francisco

  • Lands End at Blue Hour
    Lands End at Blue Hour
  • Golden Gate from Baker Beach
    Golden Gate from Baker Beach
  • Bay Bridge from Treasure Island
    Bay Bridge from Treasure Island
  • Golden Gate from Battery Spencer
    Golden Gate from Battery Spencer
  • Alcatraz at Blue Hour
    Alcatraz at Blue Hour
  • Fog over Twin Peaks
    Fog over Twin Peaks
  • Painted Ladies at Night
    Painted Ladies at Night
  • Transamerica Pyramid in Fog
    Transamerica Pyramid in Fog

Circuit Boards

  • Crystal and Capacitors
    Crystal and Capacitors
  • ESP32 Shield Can
    ESP32 Shield Can
  • Solder Joints
    Solder Joints
  • Unmarked Processor Corner
    Unmarked Processor Corner
  • GPIO Header Pins
    GPIO Header Pins
  • PCB Antenna Trace
    PCB Antenna Trace
  • USB Connector
    USB Connector
  • Ribbon Cable
    Ribbon Cable

World Cities

  • Shanghai Pudong in Haze
    Shanghai Pudong in Haze
  • Seoul and Namsan Tower
    Seoul and Namsan Tower
  • Singapore Marina Bay
    Singapore Marina Bay
  • New York from the River
    New York from the River
  • London and the Thames
    London and the Thames
  • Chicago from the Lake
    Chicago from the Lake
  • Tokyo at Blue Hour
    Tokyo at Blue Hour
  • Sydney Harbour at Night
    Sydney Harbour at Night

Use them in Batty

Choose Pane → Background Images… (or Choose… beside a background image) and switch from My Images to Background Sets. Browsing loads only the thumbnails, and Batty asks for nothing until you first open Background Sets.

To use one, open Settings → Appearance → Background and click Choose… (or Choose… for a Session, a Pane or a Project), switch to Background Sets and click the image. The full-size image downloads once, with its progress shown on the image, and your current background stays until it finishes. After that it works offline. A picture later dropped from a set keeps working wherever you use it. See Privacy for what Batty fetches.

Make your own set

What you need

A folder of images, a catalog.json that lists them, and any https web host that serves static files: your own site, GitHub Pages, an S3 bucket and so on.

The catalog format

Top level
sets.
Set
name and images.
Image
title, thumbnail and full, all required: a title of up to 100 characters for the caption, and the paths or URLs of its two files.
Limits
Catalog file1 MB
Sets50 per catalog
Images100 per set, 1,000 per catalog
Textset names and titles 100 characters
Thumbnail2 MB, 1024 px on its longest side
Full size50 MB, 8192 px on its longest side

An example

One set with two images, ready to copy and edit:

{
  "sets": [
    {
      "name": "Harbor Nights",
      "images": [
        { "title": "Pier in the Fog", "thumbnail": "harbor-nights/01-pier-fog-thumb.png", "full": "harbor-nights/01-pier-fog.png" },
        { "title": "Lanterns on the Water", "thumbnail": "harbor-nights/02-lanterns-thumb.jpg", "full": "harbor-nights/02-lanterns.jpg" }
      ]
    }
  ]
}

Download the example catalog · Read the built-in catalog

Designing images for behind terminal text

Check each image at Batty's default 15% Image Opacity over a dark theme.

Sizing

Use 16:10, for example 2560 × 1600 or 3840 × 2400. Batty keeps its own copy scaled to at most 4096 pixels on the longest side, so anything larger only makes the download slower.

Thumbnails with sips

Make each thumbnail from its full image with sips, built into macOS, never separately:

sips -z 300 480 full.png --out full-thumb.png                    # a 16:10 image
sips -Z 480 full.png --out full-thumb.png                        # keep any other aspect ratio
sips -s format jpeg -z 300 480 full.png --out full-thumb.jpg     # a JPEG thumbnail

Check your catalog

From a checkout of Batty, python3 tools/check-backgrounds.py catalog.json checks the format and every image file beside the catalog: that it exists, its real type matches its extension, and it's within the limits. It skips images on other hosts (check-backgrounds.py).

Hosting

Add it in Batty

Open Settings → Appearance → Background Catalogs, paste your catalog's URL and click Add. Batty fetches it once to validate it and shows any problem beside the field. Then its sets appear in Background Sets. Batty checks it at launch and every 24 hours, and Check Now checks it right away. It also checks when you open Background Sets, at most every 5 minutes, and Refresh in Background Sets checks every catalog right away. You can add up to 20 catalogs.

Share your set

Only share images you have the right to share, and say how others may use them: name a license, for example CC BY 4.0, in the License field of the issue. Then open a “Background set” issue on GitHub with your catalog's URL.