★ WELCOME TO RETROGATE ★ Your portal to the vintage web ★ Now with 100% more beige ★ Web 1.0 forever ★ JavaScript is just a fad ★ Webmaster: hello@retrogate.app ★

Prefer to read offline? Download the full manual.

⬇ Download (.md)

Table of Contents

  1. Getting Started (The 90-Second Setup)
  2. The Dashboard (Mission Control)
  3. Choosing Your Vintage Machine
  4. Wayback Machine Mode (Time Travel)
  5. The Built-In Start Page
  6. The Request Log (Snooping on Your Own Traffic)
  7. The Wayback Timeline (Temporal Forensics)
  8. What RetroGate Does to Your Pages
  9. Image Transcoding & Dithering
  10. Advanced Settings (Here Be Dragons)
  11. The Menu Bar (For Minimalists)
  12. Keyboard Shortcuts (For Power Users)
  13. Dead Services & Redirect Magic
  14. SheepShaver Users (Read This)
  15. Troubleshooting (When Things Go Sideways)
  16. FAQ (Frequently Argued Questions)

A Manifesto

Somewhere in a landfill, a PowerBook 520 is crying.

Not because it’s broken — it still boots, still runs, still has that satisfying bong — but because the entire internet has left it behind. Every website now requires JavaScript frameworks that weigh more than the PowerBook’s entire hard drive. Every image is in a format invented two decades after its last system update. Every page assumes you have more RAM than this machine has atoms.

RetroGate exists because we refuse to accept this.

We believe that a Macintosh Plus deserves to browse Wikipedia. That a Windows 95 machine should be able to search DuckDuckGo. That Mac OS 9 — the last truly great Classic Mac OS, fight me — should be able to reach the entire World Wide Web, including the parts that didn’t exist when it was alive.

RetroGate is a proxy server that sits between your vintage computer and the modern internet. It translates. It transcodes. It strips away twenty years of web bloat and delivers the content your old machine actually asked for, in a format it can actually understand.

It also has a Wayback Machine mode, because sometimes the best way to browse the web on a 1999 computer is to browse the 1999 web.

This is not nostalgia. This is infrastructure.


1. Getting Started

RetroGate takes about 90 seconds to set up. The hardest part is typing an IP address on a vintage keyboard, which — depending on your keyboard — might take the remaining 85 of those seconds.

Step 1: Launch RetroGate

Open the app. The proxy server starts automatically. You’ll see a gold antenna icon gently pulsing in the hero card, which is RetroGate’s way of saying “I’m ready, send me your decrepit HTTP requests.”

Step 2: Note the Proxy Address

The dashboard shows your proxy address, something like:

192.168.0.130:8080

There’s a handy copy button next to it. It looks like two overlapping documents, because that’s the universal icon for “copy” and we are not here to reinvent semiotics.

Step 3: Configure Your Vintage Browser

On your vintage Mac or PC, open your browser’s proxy settings and enter:

If you’re running SheepShaver, the host machine is reachable at 10.0.2.2 from inside the VM.

Step 4: Browse

Type a URL. Any URL. Watch in awe as a website built with React, Tailwind, and the hopes and dreams of a thousand npm packages gets lovingly downgraded into something your Quadra 605 can render.

The PAC File Shortcut

Don’t want to manually configure proxy settings? Point your browser’s auto-proxy-configuration to:

http://retrogate/proxy.pac

This serves a PAC file that routes all HTTP traffic through RetroGate automatically. It’s the lazy option, and we respect that.

2. The Dashboard

The Dashboard is your command center. It tells you everything about what RetroGate is doing without you having to wonder.

The Hero Card

At the top, a status card shows:

The animated antenna icon pulses gently when the proxy is running. It does not pulse when stopped. We considered making it droop sadly, but decided that was too emotionally manipulative.

The Four Stat Cards

CardWhat It Shows
RequestsTotal requests served this session, plus page count
BandwidthTotal bytes delivered to your vintage browser
SavedHow much bandwidth transcoding saved you. This number tends to be impressive. You’re welcome.
UptimeHow long the proxy has been running

The Detail Cards

3. Choosing Your Vintage Machine

Navigate to Configure → Vintage Computer in the sidebar. RetroGate ships with 10 presets spanning two platforms. Each preset configures the transcoding level, image quality, output encoding, and screen resolution automatically — because you have better things to do than figure out whether Mac OS 8 used MacRoman or ISO-8859-1. (It used MacRoman. They all used MacRoman. Except the PCs. The PCs used ISO-8859-1. See? You didn’t want to know that.)

Mac Presets

PresetYearResolutionColorsHTML Level
System 61988512 × 342B&W (1-bit)Aggressive
System 71991640 × 480256 ColorsAggressive
Mac OS 81997832 × 624ThousandsModerate
Mac OS 919991024 × 768MillionsModerate
Mac OS X20011024 × 768ThousandsMinimal

PC Presets

PresetYearResolutionColorsHTML Level
Windows 3.11992640 × 48016 ColorsAggressive
Windows 951995800 × 600256 ColorsModerate
Windows 981998800 × 600ThousandsModerate
Windows 200020001024 × 768ThousandsMinimal
Windows XP20011024 × 768ThousandsMinimal

Color Depth

Each preset supports a range of color depths. Choose the one that matches your vintage display:

4. Wayback Machine Mode

Navigate to Configure → Wayback Machine in the sidebar, or press Cmd+Shift+W. This is where RetroGate transcends “proxy server” and becomes “time machine.”

How It Works

When Wayback mode is enabled, RetroGate fetches pages from the Internet Archive’s Wayback Machine instead of the live internet. Want to see what Apple.com looked like in 1999? What Google looked like before it had a logo? What GeoCities looked like before Yahoo killed it? This is your feature.

Configuration

Temporal Consistency

When you load a page, RetroGate resolves the actual snapshot date and loads all sub-resources from that same date. This prevents the cursed scenario where your page is from 1999 but the images are from 2003 and the CSS is from 2007.

Date Drift Guard

If the closest snapshot is too far from your target date, RetroGate shows a warning with links to nearby snapshots.

Auto-Fallback

Even outside Wayback mode, if a live website returns a 403, 404, 410, or 451 error, RetroGate automatically checks the Wayback Machine for an archived version. The internet remembers even when webmasters don’t.

5. The Built-In Start Page

Point your vintage browser to:

http://retrogate/

This is RetroGate’s portal page — a lovingly crafted start page in HTML 3.2 that actually looks good in Internet Explorer 3.

Features: a DuckDuckGo search box, popular sites (Apple, Google, Wikipedia, Hacker News), retro sites (68kMLA, Macintosh Garden, System 7 Today), and Wayback status display.

6. The Request Log

Navigate to Monitor → Request Log in the sidebar. This is the full, unfiltered firehose of every request your vintage browser makes through RetroGate.

ColumnDescription
TimeWhen the request happened
MethodGET, POST, etc. (it’s almost always GET — vintage browsers were simple creatures)
URLThe full URL, truncated if too long
StatusHTTP status code. Green if under 400, red if 400+.
SizeResponse size after transcoding

7. The Wayback Timeline

Navigate to Monitor → Wayback Timeline. This tab shows only HTML pages served from the Wayback Machine and compares your target date with the actual archive date.

The Delta column tells you how far the actual snapshot strayed:

8. What RetroGate Does to Your Pages

RetroGate doesn’t just forward web pages. It translates them from the language of 2026 to the language your browser speaks.

Aggressive (HTML 3.2) — System 6, System 7, Windows 3.1

The full time-warp treatment:

Moderate (CSS Stripped) — Mac OS 8/9, Windows 95/98

A gentler approach. HTML stays modern-ish, but CSS gets removed. Semantic tags downgraded.

Minimal (CSS Preserved) — Mac OS X, Windows 2000/XP

The lightest touch. JavaScript stripped, <noscript> content preserved, web fonts removed, vendor prefixes injected. Java <applet> tags stripped (they crash SheepShaver), but <embed> and <object> preserved (QuickTime is eternal).

Applied at All Levels

9. Image Transcoding & Dithering

Color DepthDitheringResult
B&W (1-bit)Floyd-SteinbergGorgeous halftone — like reading a newspaper, but on a $4000 computer from 1986
16 ColorsBayer 4×4Classic VGA crosshatch. Very Windows 3.1.
256 ColorsGIF palette quantizationIf it was good enough for the Dancing Baby, it’s good enough for you.
Thousands+None neededFull-color JPEG. Living the dream.

All images are resized to fit your configured screen resolution. A 4000×3000 pixel photograph gets thoughtfully shrunk to 600 pixels. The original bytes never even reach your vintage machine.

RetroGate also prefetches images in parallel, so by the time your browser requests each image, it’s already cached. When images fail to load, RetroGate returns a transparent 1×1 GIF instead of a broken image icon.

10. Advanced Settings

Open Settings (Cmd+,) to access the advanced configuration.

General

Advanced

11. The Menu Bar

RetroGate puts a small antenna icon in your macOS menu bar. Click it for proxy status, start/stop toggle, Wayback Machine toggle, current preset info, and request stats. The icon pulses when running. It’s like a heartbeat for your proxy server, except less alarming.

12. Keyboard Shortcuts

ShortcutAction
⌘⇧SStart/Stop proxy server
⌘⇧WToggle Wayback Machine mode
⌘KClear the request log
⌘,Open Settings

Memorize them and you’ll never need to click anything again, which is good, because clicking is so 2025.

13. Dead Services & Redirect Magic

The internet of 1999 had services that no longer exist. When Netscape Navigator tries to reach home.netscape.com, it gets nothing. Digital silence.

RetroGate fixes this:

Dead ServiceRedirected To
home.netscape.comWayback Machine archive
home.microsoft.comWayback Machine archive
www.msn.comWayback Machine archive
itools.mac.comWayback Machine archive
www.geocities.comWayback Machine archive
www.altavista.comWayback Machine archive
www.excite.comWayback Machine archive
www.icq.comWayback Machine archive
www.real.comWayback Machine archive

RetroGate also detects redirect loops (6+ requests in 10 seconds) and resolves tracking redirects by checking 15+ common redirect parameter names.

14. SheepShaver Users

15. Troubleshooting

“Pages aren’t loading”

  1. Is the proxy running? Check the dashboard — the antenna should be pulsing.
  2. Is your vintage browser configured with the correct IP and port?
  3. If using SheepShaver, restart it. Seriously, just restart it.

“Pages look weird”

Check your preset matches your actual vintage machine. If you’re running Mac OS 9 with the System 6 preset, you’re going to have a bad time.

“The Wayback Machine is slow”

That’s not RetroGate — that’s the Internet Archive. It serves billions of archived pages from a non-profit’s server room. It’s doing its best. RetroGate caches responses and prefetches images to help.

“Text characters look wrong”

Make sure your preset platform matches your actual machine. Mac presets output MacRoman, PC presets output ISO-8859-1. Wrong encoding = garbled characters.

16. FAQ

Q: Does it work with actual vintage hardware, or just emulators?

Both. SheepShaver, Basilisk II, QEMU, PCem, 86Box, or genuine beige hardware — RetroGate doesn’t discriminate.

Q: Can I run it on a Raspberry Pi?

No. RetroGate requires macOS 14+. It’s built with SwiftUI, SwiftNIO, and CoreGraphics.

Q: Why can’t I use the Wayback Machine directly?

Because the Wayback Machine’s website is a modern web application requiring JavaScript, CSS, and HTTPS — none of which your vintage browser supports.

Q: Will this work with HTTPS sites?

Yes. Your vintage browser sends HTTP to RetroGate, which makes the HTTPS request with modern TLS. If cert verification fails, it falls back to plain HTTP.

Q: Why “RetroGate”?

Because it’s a gate between the retro internet and the modern one. Also because every good project needs a name that sounds vaguely like a political scandal.


RetroGate is made with love, SwiftNIO, and an irrational attachment to beige plastic.
If you made it this far, you’re our kind of person. Now go browse something.