Repository navigation
Releases
Releases · mxmgorin/retsurf
v0.11.0-nightly.20261116
v0.10.0
Game scaling and shaders, Quick Access, and new handheld packages.
Added:
- Game scaling in Game Mode: fit, integer or stretch (
[game_mode.view] scaling) - Game Mode shaders: RetroArch single-pass GLSL, ten built in, user files in
shaders/([game_mode.view] shader) - Quick Access panel on
start: Game Mode, bookmark, user agent, ad blocker, reader view, page theme, settings - Wheel on-screen keyboard (
[osk] style = "wheel") - Pad layout labels and face-button swap (
[controls] pad_layout,swap_face_buttons) - Edge scrolling: the cursor at a window edge scrolls the page (
[controls] edge_scroll) - Page icons in tabs, bookmarks, history and the speed dial (
[interface] page_icons) - Start page styles (
[interface] home_style) retsurf [--game-mode] [PATH]opens a local game folder or HTML file- Update notice at startup
- Toast notices, e.g. when a tab is closed at
max_tabs - Android: share logs from Settings > System
- Splash screen, branded cursor, Junk Surfer on the offline page
- Memory guard: closes the heaviest tab when the system runs out of memory (
[performance] memory_guard) - spruceOS, CrossMix-OS, NextUI and NX Redux packages
Changed:
- Config sections renamed, old values reset to defaults:
[input]is[controls];scale,toolbar_*,cursor_linger_msmoved to[interface],max_fpsto[performance] - Settings regrouped into Interface, Controls, Gaming and System tabs, with switches
- The Game Mode menu replaced by Quick Access and Settings > Gaming
- Default pad gestures:
startQuick Access,selectQuick Menu,hold:xaddress bar,scrollunbound; Settings pressed again closes it - Default keyboard shortcuts moved onto Ctrl
- Taller toolbar
- Swap tuning moved from the launcher into the app (
[performance] swap_tuning), milder - CSS Grid always on,
[experimental] gridremoved - Engine on Servo
mainas of 2026-10-08
Fixed:
- WebGL 2 fixes for Unity and Emscripten games
- "Too many open audio devices" on pages with many sounds
- WebGL on PowerVR (TrimUI Smart Pro)
- A panic in canvas
measureTextwith no fonts on the system - Android: connections through the system proxy
- Pages listening for
gamepadconnectedlate never saw the pad; phantom pads after reader view - Emscripten games stalling on IDBIndex cursors and WebAssembly streaming
- Android: page taps, WebGL after resume, system keyboard under the OSK
- On-screen keyboard: page lift, trigger zoom, pointer clicks
- Cursor and toasts stayed on screen after expiring
Ctrl+=/Ctrl+-zoom the page- Update download progress not redrawn
Full changelog:
v0.9.0...v0.10.0
v0.9.0
Web games: Game Mode, WebGL, and the Gamepad API.
Added:
- Game Mode: pad and keyboard input to the page with the chrome hidden and input re-mapper
- WebGL, on the desktop, the handhelds and Android
- The Gamepad API, and pad rumble with
[input] hapticsoption - The chrome hides while a page holds the Fullscreen API
- IndexedDB and
navigator.storage([experimental] indexeddb,storage_manager) - A nightly channel in the updater (
[update] channel = "nightly") - A fontconfig in the PortMaster port, for firmware that ships none
Changed:
- Reworked gamepad layout: zoom on the triggers, home and reload on the L1/R1 holds, tabs on the Select and Start chords, a new
close_tabaction,hold:startfor Game Mode - Engine on Servo
mainas of 2026-09-22; surfman to 0.14 - Overlays hold their state only while they are open
- rustls past RUSTSEC-2026-0285
Fixed:
- On Android, any page with sound killed the app
- A page that fullscreens a flex container or a canvas rendered blank
- Wheel scrolling did not reach the page on the Linux builds
- Frame pacing for animations
- Link hints not showing after page load and wrong positioning after scroll
- A restore of multiple tabs
- The gamepad cursor pressed at the wrong point at zoom other then 1
- An update download that stalls fails instead of waiting
- Closing a tab with the X button trims the heap
Full changelog:
v0.8.0...v0.9.0
v0.8.0
GPU-less devices, and ArkOS.
Added:
- Software rendering: swgl for the page, SDL's 2D renderer for the chrome, no GL driver needed. A GPU build falls back to it when no context can be created
- Allium and OnionOS packages for the Miyoo Mini Plus and Flip
micromemory profile for ~128 MB boards; the Miyoo packages cap images per page- Chrome drawn against a 640x480 design and zoomed to fit the panel;
[display] scale(0.6–1.6) is a factor over that fit - Desktop window reopens at its last size;
[display] dark_last_rowfor muOS/A133 panels RETSURF_KEYMAP=miyoo: keyboard events from Miyoo Mini are mapped to[gamepad][debug] memory_logand[debug] frame_timingmeasure without an overlay on screen- "Restore all defaults" option in Settings > Advanced
Changed:
- glibc floor from 2.35 to 2.30 on aarch64, which brings the port to ArkOS
- Engine on Servo
main@8ae6b28d707, pinned by tag - The chrome is rasterized only where it changed
- The JS malloc heap is bounded on the small tiers
Fixed:
- A refused GL attribute no longer ends the run
- Trigger-bound keys reach the OSK's shift and symbols
- The Settings tile takes part in the speed-dial order, and X removes it
- A manual scroll can leave the highlighted row in the menu and settings
Full changelog:
v0.7.0...v0.8.0
v0.7.0
Less memory on the small boards.
Added:
- Swap tuning for memory-starved handhelds: the PortMaster launcher can add a zram device and set the swap sysctls before. Off unless a
swap-tuning.onfile sits next to the script RETSURF_SERVO_PREFSreaches engine prefs the config does not expose: comma-separatedname=valuepairs applied at startup, so a measurement that used to need a rebuild is now an environment variable
Fixed:
- Android survives the SpiderMonkey 153 bump. The new engine packs a native pointer into a JS value and requires its top 16 bits to be clear, while Android tags heap pointers for apps targeting API 30 and up. Left alone, the assertion would have killed the script thread at startup. The APK now opts out of pointer tagging
- An iframe could spend the whole page's image budget (
[data_saving] max_images_per_page) and leave the page it sat in without pictures — each document now has its own - The text caret no longer blinks: it woke the idle loop twice a second and had the chrome redrawn to toggle a one-pixel line
Changed:
- Engine moved up to Servo
mainas of 2026-08-31 (109 upstream commits). The patch set retsurf carries on top grew from two to six; three of the new ones are leaks a long browsing session used to accumulate - The allocator hands memory back: navigating schedules a
malloc_trimfive seconds later, and the mmap/trim thresholds and arena cap are set at startup on every tier but the desktop one.RETSURF_HEAP_TUNE=0|1overrides the tier - The default
search_pageis DuckDuckGo's no-JS endpoint (lite.duckduckgo.com/lite/) - a quarter of the page weight and no wait for JS on a slow board. Existing configs keep their value - Fresh speed-dial defaults, and closing the last tab now opens the home page instead of doing nothing
- The adblock engine parses network rules only: the hook it drives is a request filter, so EasyList's cosmetic half was resident for nothing
- The
tighttier keeps one document in the back-forward cache, not three - three was priced on synthetic pages and OOM-killed a 960 MB board on real ones - A new icon, across the desktop, Android and PortMaster packaging
- Panics append to the panic file with a timestamp and also go through the logger, which is the only way they reach logcat on Android
Full changelog:
v0.6.0...v0.7.0
v0.6.0
Media elements play, and the open tabs survive a restart.
Added:
<audio>elements play: progressive mp3, wav, flac, ogg-vorbis and aac/m4a through SDL2, with seeking over HTTPRange,currentTime/duration, volume, mute andloop— so podcast players, audio previews andnew Audio(url)sound effects work. No Opus, no MSE<video>elements play: progressive H.264-in-MP4 decoded in software (OpenH264), synced to the audio track, with seeking and the last frame held at the end. No MSE, so streaming sites stay dead — this is for direct files and embeds. Off switch: Settings > Content > Video- The open tabs come back after a restart (URLs and which one was shown, in
session.toml). Off switch: Settings > Browser > Restore tabs - A ceiling on open tabs (Settings > Browser > Max tabs, 8 by default): opening past it closes the oldest tab that isn't in view, and a tab a page opens is refused rather than granted an eviction
- Clear browsing data: one row under Settings > Advanced > Data wipes history, cookies, localStorage, the HTTP cache, the saved session and finished downloads, then closes the tabs back to the home page. Bookmarks, pins, settings and key bindings are left alone
Fixed:
- Enter activated a settings or menu row twice: a number stepped by two, and an arm-then-confirm row like History's "Clear all" wiped on a single press
Changed:
- Engine moved up to Servo
mainas of 2026-08-24 (110 upstream commits):TextEvent, autofocus inside<dialog>, theinsertLineBreakandindentediting commands,@font-facedescriptors readable from the CSSOM, italic synthesized from a variable font'sital/slntaxis, sticky positioning measured against its scroll container's overflow, and SpiderMonkey 140.14
Full changelog:
v0.5.1...v0.6.0
v0.5.1
Replaces 0.5.0, everything is in this release.
Fixed:
- Pages showed no pictures at all with the per-page image limit on (it was on by default), most visibly on Steam and Reddit
- The address bar was unusable on the start page, and typing in it blanked the page
- Ctrl shortcuts were dead while any text field held focus (ctrl+m, ctrl+r, ctrl+, never fired)
- A tab could stay "loading" forever on pages whose scripts insert a
<body>after the load (wikipedia) - Link-hint badges covered the start of the element they label
- Toolbar buttons sat two pixels above the address bar's center, and text in every single-line field hugged the top of its box
- A page click held while bindings were saved could leave the mouse button stuck down
- Editing a gamepad tunable in settings no longer discards a gesture in progress
- Bookmark/history rows for a bare address were labelled "0"; a nameless failed download now falls back to the URL's name
Added:
- HTTP disk cache, off by default (Settings > Advanced > Performance, or
[performance] http_disk_cache_mb): a spill store for what the memory cache evicts, so it survives a restart.
Changed:
- The per-page image limit (
[data_saving] max_images_per_page) is off by default: it cost under 3% of resident memory while dropping a third to a half of an ordinary page's pictures. Still there for weak boards and thumbnail grids - Engine moved up to Servo
mainas of 2026-08-17 (93 upstream commits):<meta name="color-scheme">, thecolor-schemeproperty,text-transform: full-width | full-size-kana | math-auto,<link>source sets, a synchronousabout:blank, layout/script/WebCrypto fixes - WebGL is no longer compiled into the handheld and PortMaster builds (Servo made it a cargo feature; that build never had a surfman connection anyway)
- Every chrome icon is a Phosphor glyph
- Controls screen is a line per action and refuses an edit that would strand the gamepad, and key names come from SDL
- Speed-dial pins can be reordered with L1/R1 (Tab / Shift+Tab or Ctrl+arrows)
- The on-screen keyboard has a Clr key; page fields are lifted clear of it, and modal prompts recenter above it
- Focusing the address bar selects the whole URL; a URL too long for its row is cut in the middle
- Clearing history or finished downloads takes two presses
- Bookmark and history rows lead with the site name, the rest of the URL dim behind it
- A loading tab paints a static accent line along the toolbar's page-facing edge
Full changelog:
v0.4.0...v0.5.1
v0.4.0
Added:
- Web Audio output through SDL2: oscillators, gain, filters, panners, analysers and JS-filled
AudioBuffers now make sound (<audio>/<video>are still unsupported) - Decode mp3, wav, flac, ogg/vorbis and aac/m4a, so sound effects and music that pages load as a file play
- Page theme:
darkmakes sites serve their dark stylesheet,forced-darkinverts pages that don't have one
Fixed:
- Links with the
downloadattribute now download, includingdata:links and files that pages build in JavaScript - Downloads honor the name the server picks (
Content-Disposition) instead of the link URL - Downloads send the browser User-Agent and the linking page as Referer, so hosts that reject unknown clients serve the file
- A download whose connection goes silent fails with "stalled" after 60 s instead of staying active forever
Changed:
- Track engine from unreleased Servo
main, past the 0.5 release - Updated base64 0.23 and egui-sdl2 0.8 (egui 0.35)
Full changelog:
v0.3.1...v0.4.0
v0.3.1
Fixed:
- Freeze on pages combining
IntersectionObserverwithdisplay: contents(e.g. reddit, MDN) — patched in the vendored Servo layout crate - Crash on pages where an ad-blocked subresource carries an
integrityattribute (e.g. gbatemp.net) - Update channel switched in settings is now used by a "Check for updates" made in the same visit
- Android APK no longer reports a stale
0.1.0/ versionCode 1
Full changelog:
v0.3.0...v0.3.1
v0.3.1-beta.1
Fixed:
- Crash on pages with an ad-blocked subresource carrying an
integrityattribute (e.g. gbatemp.net)
Changed:
- Startup log and panic file now record build version, commit and date
Full changelog:
v0.3.0...v0.3.1-beta.1