What's new
What's new in Porthole
Porthole is in early development; 1.0.0 was its first public release. This is what has changed, in plain words, newest first.
1.4.0 “All Hands on Deck”
Discord inside Porthole, a rebuilt in-game menu, much easier controls, interactive tutorials and a new engine. Because the engine is new again, every game shows “Not yet tested” until people have played it on this version. It also contains the 1.3.1 fixes.
Discord (experimental)
- A Social tab with Discord in it, off until you turn it on. Servers, channels in their categories, direct messages and group chats, forums and threads, with replies, reactions, editing and deleting your own messages, link cards, stickers and a full-screen picture viewer. Sign in on discord.com’s own page (Porthole never sees your password) or with a code from the Discord app; only the sign-in token is kept, in the Keychain, and messages are never saved.
- Voice calls with your game’s sound in the call: mute, deafen, microphone sensitivity, a volume for each person, push to talk, and an experimental echo reduction. Join the channel a friend is in with one tap, and answer calls from direct messages and group chats.
- Banners over the game for messages and incoming calls (Join and Decline on the banner), one at a time and never while you stream. Your game can show on your profile (“Firewatch on Porthole”), if you turn that on.
- Go Live: stream your game to a channel, and watch other people’s streams (experimental, H.264 only).
- Porthole is not an official Discord client. Discord’s terms do not allow third-party clients, and an account used with one can be limited or banned. Use an account you can afford to lose. A warning is shown before you can turn it on.
The in-game menu
- On a phone it fills the screen, with the tabs down the side, one column, and a background you can see the game through (you choose how much).
- On an iPad it is a floating card with a big Close button and tabs along the top. Drag its edge handle to make it any size, or tap the expand button.
- Input lag and Screen delay numbers for the performance overlay, and Porthole turns to landscape when a game starts.
Controls
- Default controls: choose once how every game is controlled, from starter layouts drawn as pictures. Universal is the new default for most games (a W A S D stick, the mouse buttons, the usual keys, and a Look / Mouse switch). The on-screen game controller has a second layout, Corner sticks, and a game’s page has a controls card with Try it, Edit and Change layout.
- Left-handed mode, button size and a quick layout switch in the game. On an iPad the game’s picture moves up above the on-screen controls so they cover less of it.
- The layout editor works on several controls at once: draw a box or tap Select, then move, scale, line up, space evenly, flip, resize and copy them together.
- Test your controls: Settings › Controls shows a connected controller live, in 3D for a DualSense, DualShock 4 or Xbox pad, tests a keyboard and a mouse, and sets a deadzone for a stick that drifts.
Learning Porthole
- Interactive tutorials that dim the screen, glow around the real button and move on as you tap it, from tab to tab. The first game you run offers a tour of the in-game menu.
- First-run setup now lets you choose how you play (controls, colours and sound, picture and power) before the steps that get it ready, or skip straight to the essentials.
- A Community and links page in Settings.
Steam, stores and displays
- Steam games on an external drive are found and added by themselves, and leave the library while the drive is not connected.
- Choose which of Valve’s download servers a game comes from, and updating, resuming or repairing a Steam game now asks only for the space it really needs, not the whole game’s size.
- Epic games start the way Epic’s own launcher starts them, and a game with online anti-cheat says so before a big download.
- Play on a TV or monitor on a cable (USB-C or Lightning to HDMI): the game fills that screen and the controls stay on your device.
The engine
- The engine takes in the Madeira Nightly 0.2.29 work: fixes for memory and the JIT pool, and for the launchers’ browser components. The exact changes are in the source (
patches/0204-engine-1.4.0-*). - BeamNG.drive’s Bin64 program starts in the game’s install folder, and start options typed with the iOS keyboard reach a program as typed (Final Fantasy IX’s Memoria patcher needed it).
Fixed
- Steam Cloud saves that Steam sends packed in other ways now download (the 1.3.1 fix).
- A Steam game started from an external drive hides the launch screen once its window is up.
- The swap readout shows what is really on the disk, and a failed attempt to switch JIT on names the real cause.
- In Settings a page you open starts at its top, and only a page you go back to keeps its place.
- The full list is in the release notes.
Known limits
- Discord is experimental. Watching streams and the echo reduction are the least proven parts, Go Live does not work from direct-message calls yet, and a stream can only be watched in H.264.
- Games with online anti-cheat (Easy Anti-Cheat, BattlEye and others) do not run online. Red Dead Redemption 2, Call of Duty: Black Ops III and Ubisoft Connect games still do not run.
1.3.1
A small update to 1.3.0: Steam Cloud saves that would not download now do, Steam games can start from Steam’s saved sign-in (and with no connection), and compatibility reports can say a game came from Amazon Games. Every game keeps the compatibility badge it had on 1.3.0, because the engine is the same.
New
- Start from Steam’s saved sign-in. Once a game has started online, its later starts use what Steam saved: no new sign-in and no ownership check each time (about ten seconds faster), and the game can start with no connection at all. Steam renews it with an online start, which happens by itself after two weeks. Inside such a start Steam is offline, so multiplayer and Steam achievements do not work; a game’s own page has “Online every time” for those. You can switch it off in Settings › Steam › Starting games.
- Amazon Games is now one of the choices for where a game came from when you send a compatibility report.
Fixed
- Steam Cloud saves that would not download. Saves that Steam sends compressed in a way Porthole did not recognise failed Steam’s checksum and were not saved (Fallout: New Vegas and the LEGO games showed it most). Porthole now unpacks every kind of packing Steam is known to use, and still saves a file only when it matches Steam’s checksum. A file whose link was cut short is fetched once more, and one that still fails says in the log what it looked like.
- The saved Steam sign-in is updated in place in the Keychain, so a save that fails or is cut short can no longer leave you signed out.
- After a failed attempt to switch JIT on, the message now says what to do: close Porthole completely, open it again, and check that LocalDevVPN is on.
1.3.0 “Full Sail”
Upscaling and frame generation, Steam Cloud saves, fixes that ask first, much better touch controls, downloads to an external drive, Blender and a Settings screen in short pages. Because the engine is new again, every game shows “Not yet tested” until people have played it on this version.
Picture and speed
- Upscaling (MetalFX) for Direct3D 11 and 12 games: 1.5x, 2x, or “To the screen”, which enlarges the game to your screen’s own pixels. Set the game’s Resolution lower and it runs faster while the picture stays sharp. The in-game menu changes it at once, with no restart.
- Lossless Scaling frame generation adds one to three frames between the game’s own, and its own upscalers (LS1 and LS1 performance) are offered too. They need your own copy of Lossless Scaling on Steam: Porthole ships none of it, checks your purchase first and keeps only the one file it needs, sealed on your device. Direct3D 12 frame generation is experimental and needs more memory.
- Vulkan as an opt-in route (DXVK, vkd3d-proton, with MoltenVK or KosmicKrisp) for a game that renders wrongly on the default route. It is off unless a game asks for it, and it has not been tried on many games.
- Games that ask for the screen’s resolutions through DXGI now see the whole list. A
[benchmark]line at the end of every run records frame rate, memory and heat so runs can be compared.
Controls
- An on-screen game controller for games that need a pad, in Xbox, PlayStation, Nintendo Switch and Super Nintendo styles. The game sees an ordinary Xbox pad. If a game ignores it, Porthole offers touch controls for keyboard and mouse instead.
- Touch controls for keyboard-and-mouse games: a trackpad mode (slide to move the cursor, tap to click, two-finger tap for right click), a full PC keyboard over the game with Shift, Ctrl and Alt that hold for the next key, mixed layouts that hold gamepad buttons next to keys and mouse buttons, floating sticks, and controls that fade when you are not touching them.
- The controls editor has opacity, tap feedback, combos (Shift+Space, Ctrl+C), lock positions and a shape and colour for each key.
- Settings › Controls gathers every controller, keyboard, mouse and touch setting in one page.
Steam, stores and storage
- Steam Cloud saves both ways: upload and download a game’s saves from its page, with the files and sizes listed first. A save changed on both sides is never overwritten, and a file that is replaced keeps a backup.
- Downloads to an external drive: choose the device or the SSD when you press Download, with a drive speed test. A slow drive is written to gently; a fast one at full speed. A FAT32 drive is explained instead of failing.
- A Steam download that hits a depot Steam blocks for your region installs the rest and tells you which one was left out. Steam games show whether they can be played offline.
- Hide the stores you do not use from the Stores tab, and show your library on Home as a shelf, a grid or a list.
- A Software section for programs that are not games. Blender is first: touch controls for its 3D view, libraries put in place for it, and GPU rendering with kernels built for your GPU and iOS version where one exists.
Fixes that ask first, and help
- When a run ends with a known cause (a game that needs AVX, a memory limit, a full memory pool, a missing program), Porthole suggests changing one setting for that game on Home. Nothing changes until you tap Apply; there is an Undo, and the next run is judged. A “Last time” card on a game’s page says in plain words how its last run ended.
- Clearer errors, and “What does this mean?” buttons on errors, settings and engine lines that open the right page of the new documentation.
- Settings are 17 short pages in six sections (Playing, Your games, Connection, App, Reports and fixes, Help); rarely used switches are behind “Show technical options”.
- Epic games can run their own prerequisite setup on request.
Games and fixes
- Supermarket Simulator, PAYDAY 3, Steep, Subliminal, Persona 5 Royal, Schedule I, BeamNG.drive, the Rockstar launcher for Grand Theft Auto V and Final Fantasy IX’s Memoria patcher (a single-file .NET program) now start or run better.
- The mouse wheel counts every click and turns the same way as the launcher’s lists, and the app no longer crashes after a Windows program ends with an error. The full list is in the release notes.
Known limits
- Grand Theft Auto V (Legacy) and Call of Duty: Black Ops Cold War are not known to work yet. Blender GPU rendering needs a kernel pack for your GPU and iOS version; elsewhere Blender runs on the CPU. Download-to-SSD needs a folder you make on the drive first, and an exFAT drive.
1.2.0 “Autumn Tide”
A keyboard and a mouse in games, the whole app on a controller, the EA app as a sixth store, much faster Steam downloads, a new look and a newer game engine. Because the engine is new, every game shows “Not yet tested” until people have played it on 1.2.0.
Keyboard and mouse
- A Bluetooth or USB keyboard works in games like on a PC: every key with its own press and release, Shift, Ctrl, Alt and Command (the Windows key), the keypad and function keys. Typing into a program's own text boxes works, and Command-V pastes the clipboard's text.
- A mouse or trackpad on iPad. The game's own cursor follows the pointer in menus; left, right, middle, back and forward buttons and the wheel work. A game that hides its cursor to look around gets the mouse's movement and the pointer is locked to the game, so the camera keeps turning at the screen's edge.
- Your own keys for Porthole: F10 opens Porthole's menu in a game and Ctrl+Alt+P locks or frees the pointer; both can be changed in Settings. Mouse speed (also per game), scroll direction, key repeat and a layout option for typing are there too.
- The mouse wheel and press-and-drag scroll every screen, including Home's shelf of games. Right-click a game on Home for Play and Details; with a mouse, a double-click plays it.
- An iPhone gets a mouse only through AssistiveTouch and has no pointer lock.
Controllers
- The whole app works with a controller, including an on-screen keyboard you drive with the D-pad (A types, B deletes, X is space, Y is shift), and a strip of hints that always says what each button does.
- Every section opens with the glow in the same place, and a slider is entered with A so passing over a setting can't change it.
- The controller's battery reaches games that show it.
Stores
- The EA app is the sixth store. Sign in on EA's own page, see your PC games, install them straight from EA's servers (pause, resume, update, repair, uninstall) and play them without the EA app. Games with EA's kernel anti-cheat can't run.
- Steam is steadier and faster. It no longer signs you out at random, downloads ran at 160-170 MB/s in a test (12-22 before), and the sizes shown add up: a game's page shows the download and the size on the device.
- Demos, betas and playtests you own show in your Steam library with a label.
- itch.io games that come as .7z or .rar archives install, and archives inside a download are unpacked where they lie.
Games and the engine
- A newer engine. Madeira's latest work is merged in (hundreds of upstream changes), so more games can run. Final Fantasy Resonance (and its demo), Celeste and other .NET Framework games now start.
- Windows components: Wine Mono for .NET games, Wine Gecko for launchers that show a web page, and the 32-bit Visual C++ runtime, each downloaded from its maker, checked before use, and removable in Settings.
- GOG Galaxy services for GOG games built with GOG's SDK, using your GOG sign-in.
- Donor memory, optional, for big games that run out of the app's memory. It needs one more App ID when signing.
- Sound: Game volume (50% to 200%), and a setting that brings a game's sound back after a call or Siri.
- Per game: the graphics card it sees, gyro aim and turbo buttons, Madeira's tested setup with an Undo, and sharing a setup as a file or one line of text.
- Experimental, off by default: keep a game running in the background for a while, and keep compiled graphics pipelines between runs.
Compatibility reports
- The Reports tab is built around your own games, with how each runs on this version and filters for each result.
- A report is sent with the game's log, cleaned of personal details and kept private. Every report is checked before it appears or counts toward a badge. What is sent.
Look
- A redesigned Home, Stores page, game page, launch screen, setup guide and performance overlay, and Settings reorganised with a search box that finds any setting.
Fixed
- Steam signing you out at random, and download sizes that didn't add up.
- Tapping the launch screen while a game started could break the start; a failed launch's message now stays until you close it.
- “Cellular data is off” staying on Home after cellular data was back on.
- Many smaller fixes for specific games and for Home, Stores and Settings.
Known limits
- Red Dead Redemption 2 is not playable yet: the Rockstar launcher signs in and starts the game, but with Rockstar's newest Social Club the game stops with a Social Club error before the main menu.
- Call of Duty: Black Ops III did not start in testing.
- Not yet run on a device: Donor memory, gyro aim and turbo, Madeira's tested setups, sharing a setup, GOG Galaxy services, and .7z and .rar installs. Please say if one doesn't work.
Earlier releases: 1.0 and 1.1
Stores and downloads
- One Stores tab. Steam, Epic Games, GOG, itch.io and an All games page share it, with a switcher at the top. Every game carries the logo of the store it came from, on its card and on the home screen.
- Epic Games. Sign in on Epic's own page, then install the games your account owns that have a Windows version and play them without Epic's launcher. Epic's overlay and anti-cheat are not supported.
- GOG. Sign in on GOG's own page and install the games you own, straight from GOG's servers where it has a build there, otherwise from GOG's setup file. Games that need GOG Galaxy's online features are not supported.
- itch.io. Paste a personal API key made on itch.io and install the games you bought, claimed or collected, including free ones.
- The same layout for every store: a grid of your games with a badge for what each is doing and a page for every game, with its compatibility badge, description and screenshots where the store has them.
- One Downloads page for every store, opened by a round button that stays at the bottom right of the Stores tab. It shows what each store is downloading, the games waiting and the paused ones, with Pause, Resume, Download now, Pause all and Resume all.
- Downloads keep going when you leave the app, and a card on the lock screen and in the Dynamic Island shows the percentage, size, speed and time left with Pause, Resume and Cancel buttons. The card is an optional part of the install; without it iOS's own progress card is used.
- Steam games on an external drive. Choose a folder on an SSD and send new Steam downloads there. This is new and has had little testing.
- Much less lag in the Stores tab and while something downloads, and swiping in from the left edge goes back, as in any iOS app.
Security and privacy
- Store sign-ins stay in the iOS Keychain, for this device only. Store traffic is kept out of the network cache, and sign-in pages keep no cookies.
- Pairing files, certificates and profiles you pick are deleted from temporary storage as soon as they are read.
- Updates are checked against the maintainer's signature before they are installed.
- Problem reports also hide IPv6 addresses and any password, token or key that appears next to its name, and the pairing log no longer names your iPhone.
Updating the app
- A popup while it updates itself with the steps (download, sign, install), one progress bar, and a plain warning to keep the app open until it is done.
- Signing is several times faster, and so is sending the signed app to iOS's installer.
The engine
- Ten open fixes from the Madeira project were taken in, among them the reduced-precision x87 switch working as its name says, a large-memory option for games that reserve a lot at start, more of Windows' own DirectX helper libraries, and fixes for launchers that start a second copy of themselves.
Look and feel
- A new home screen. Your games sit on one shelf. With a controller connected the chosen game grows and the rest step back; on touch every game is the same size.
- A slim top bar on iPhone and iPad, with the Porthole mark and the name next to it.
- A game's page is short again: Play, three settings, and four doors (controls, how it runs, more options, about and files).
- An app icon: a silver porthole looking at a sunset sea, and a night sky with a crescent moon in dark mode.
- Dark only, in a slate blue in the Steam spirit with Porthole's own cyan.
Controllers
- FULL and PARTIAL badges from Steam's own list, on the shelf, the Steam screen and every game's page.
- Press the badge to see what it means and how to cover the parts a controller can't reach.
- A Controller tab on the Steam screen that lists only the games with controller support.
Steam
- Add an installed game back to your library at any time; it still starts through Steam.
- A clearer Steam screen and Downloads page, with labelled buttons and one summary line.
Compatibility reports
- Shorter lists, with the details one switch away.
- Reports are counted per device model and per engine version, so an old result isn't passed off as a current one.
Setup and updates
- Setup is three steps: full speed, Windows components, your games from any of the four stores, then a short Good to know page.
- A warning in the game when memory or the swap file is nearly full, saying what to change.
- Settings has six pages instead of fifteen.
- Updates: versions are listed five at a time; with no certificate added you can download any version as a file.
- Your VPN: Porthole asks before pausing it, and can turn it back on with a shortcut you make.
- Notices on the home screen can be hidden with a small x.
Every release, newest first
Every public release, as the app lists them in Settings › Updates. Test builds made between releases are not listed here.
1.4.0 (build 982): All Hands on Deck: Discord inside Porthole (experimental, off until you turn it on), a rebuilt in-game menu, much easier controls, interactive tutorials and a new engine.
Added
- Discord (experimental, off until you turn it on; Porthole is not an official Discord client and Discord's terms do not allow third-party clients, so an account used with it can be limited or banned): a Social tab with your servers, channels, direct messages and forums; voice calls with your game's sound in the call, push to talk and a volume for each person; banners over the game for messages and calls; your game on your profile; and a viewer for other people's Go Live streams.
- A rebuilt in-game menu: on a phone it fills the screen with tabs down the side and is see-through; on an iPad it is a floating card you can drag to any size.
- Default controls: choose once how every game is controlled, from starter layouts drawn as pictures. A new Universal layout suits most games; the on-screen game controller has a second layout; every game has a controls card; left-handed mode, button size and a quick layout switch in the game.
- The layout editor works on several controls at once: select, move, scale, align, space evenly, flip, resize and copy.
- Test your controls: Settings > Controls tests a controller (in 3D for DualSense, DualShock 4 and Xbox pads), a keyboard and a mouse, and sets a deadzone for a stick that drifts.
- Interactive tutorials that point at the real buttons, a first-run setup where you choose how you play, and a tour of the in-game menu on your first game.
- Play on a TV or monitor on a cable: the game fills that screen and the controls stay on the device.
- Steam games on an external drive are found and added by themselves; a Steam download region; starting from Steam's saved sign-in; Epic games started the way Epic's launcher starts them, with a warning for anti-cheat.
- Input lag and Screen delay numbers for the performance overlay, and turning to landscape when a game starts.
- A new engine (the Madeira Nightly 0.2.29 work) with fixes for memory, the JIT pool and the launchers' browser components. Every game's compatibility badge starts again at "Not yet tested".
Changed
- Discord lives in the Social tab, together with Steam's friends list.
- Settings > Controls is much shorter: Default controls first, then Controller, Keyboard and mouse and Touch screen, and one Test and troubleshoot row.
- Updating, resuming or repairing a Steam game asks only for the space it really needs.
- In Settings a page you open starts at its top, and only a page you go back to keeps its place.
Fixed
- Steam Cloud saves that Steam sends packed in other ways now download.
- A Steam game started from an external drive hides the launch screen once its window is up.
- The swap readout shows what is really on the disk.
- A failed JIT attempt names the real cause and says what to do.
- BeamNG.drive's Bin64 program starts in the game's install folder, and start options typed with the iOS keyboard reach a program as typed.
1.3.1 (build 928): Steam Cloud saves that Steam sends packed in other ways now download, Steam games start from Steam's saved sign-in once they have started online, and compatibility reports can say a game came from Amazon Games.
Added
- Settings > Steam > Starting games > Start from Steam's saved sign-in (on): once a game has started online, its next starts use what Steam saved, so there is no new sign-in and no ownership check each time (about ten seconds faster), and a game can start with no connection at all. Steam renews the saved sign-in with an online start, which happens by itself two weeks after the last one, or when Steam could not use it (the game then says so and the next Play signs in online). Inside such a start Steam is offline, so multiplayer and Steam achievements do not work: a game's own page has Steam sign-in: Online every time for those.
- Compatibility reports: "Amazon Games" is now one of the choices for where the game's files came from.
Changed
- After a failed attempt to switch JIT on, the message now says what to do (close Porthole completely and open it again, with LocalDevVPN on) instead of only "Relaunch the app".
Fixed
- Steam Cloud download: a save that Steam sends compressed in a way the app did not recognise (for example a zip, gzip or Zstandard wrapper, or Steam's own VZip and VZstd forms) failed the checksum and was not saved. Every packing Steam is known to use is now unpacked, and the file is still saved only when it matches Steam's checksum.
- Steam Cloud download: a file whose link was cut short is fetched once more before it is given up on, and a file that still fails now says in the log how big it was, what it started with and what Steam said, so the cause can be read from one report.
- The saved Steam sign-in is now updated in place in the Keychain. Before, the old copy was deleted first, so a save that failed or was cut short (the app closed, the device locked, two saves at once) could leave no sign-in and ask you to sign in again.
1.3.0 (build 870): Full Sail: upscaling and frame generation, Steam Cloud saves, fixes that ask first, on-screen controllers and better touch controls, downloads to an external drive, Blender, and Settings reorganised into short pages with a Controls page.
Added
- Upscaling (MetalFX) as a game setting (1.5x, 2x or To the screen) and an Upscaling card in the in-game menu (Off, To the screen, 1.5x, 2x). The menu changes it at once, without restarting the game. Direct3D 11 and 12. The card says what the engine is doing: the size the game draws, the size it is enlarged to, or that there is nothing to enlarge.
- "To the screen" enlarges the game's picture to the screen's own pixels (at most 2x) and does nothing when the game already draws about as large as the screen. Set the game's Resolution lower (for example 1280x720) and the game runs faster while the picture stays sharp.
- Lossless Scaling frame generation: in a game's Engine section and the in-game menu, for Direct3D 11 and 12 games. It needs your own copy of Lossless Scaling (Steam app 993090). The menu card switches it on and off while the game runs, chooses how many frames are added (1 to 3) and how detailed the motion search is, and says what it is doing: frames made per second, what the passes cost, or why it cannot work.
- Lighter passes (on by default): Lossless Scaling's performance layout, with fewer and smaller intermediate pictures. Changing a setting no longer prepares every shader again.
- Frame generation runs only in the game's own program, never in launchers or helper windows (Rockstar's Launcher, Social Club, Steam).
- Frame generation works with games that use an sRGB back buffer (Unity games such as Schedule I); the generated pictures are kept in 16-bit floats so shadows do not band.
- Lossless Scaling's own upscalers (LS1 and LS1 performance) as upscaling methods, with a sharpness setting from 1 to 5, in the in-game Upscaling card and in the game's settings. Direct3D 11 and 12. If they cannot start, MetalFX is used and the card says why. They also enlarge the frames that frame generation makes.
- Stores > Software > Lossless Scaling: checks, with Steam's own licence list for your account, that you own it; downloads it from Steam with your account (Steam only gives its files to a licensed account); keeps only Lossless.dll, sealed on the device; keeps a signed proof of the licence that must be renewed online every 7 days. A refund or revoked licence removes the file at the next check. It cannot be installed as a game from the Steam store page.
- Direct3D games that list resolutions through DXGI now see the whole table, from 640x360 up to the Resolution set for Porthole, so upscaling has something to enlarge from. (A line env.DXMT_WSI_MODE_TABLE = 0 in a game's config turns it off.) The log lists the display modes a game asks for.
- Steam Cloud card under Play on a game's page (games Steam installed): Upload saves to Steam and Download saves from Steam, with the files listed first (to upload, to download, changed on both sides) and their sizes, a "Check again" button, and the state at a glance. Nothing runs by itself; the buttons wait while a game is running. Upload finds new saves where the game keeps them (Steam's Auto-Cloud rules, for example a new Factorio world); download understands ProgramData and the per-game folder Steam uses for games that use Steam's own save calls.
- An Offline play row on a Steam game's page: Ready once Steam has saved an offline sign-in on this device, or what to do first.
- Steam downloads skip a depot Steam blocks for your region or release (error 40) and install the rest, and say which one was left out.
- When Steam's client files are not on the device yet, the Home notice has an Open Steam button (the files are about 73 MB, from Valve).
- Settings > Steam shows a warning when the app id in this copy's signature differs from the app id the app declares (a signing service's profile can name an id of its own), which is the cause of a folder chooser that gets no answer, and says how to fix it.
- Stores > Software: programs that are not games. Blender and Lossless Scaling are there; each is a row that opens its own page (download, start, update, remove, what is known to be limited or wrong). New programs and new versions can be added to the list without an app update; some are data packs that are not started.
- Downloads to an external drive or SSD library: Download asks where the game goes (this device or the SSD, with the free-space check against the place you choose); Settings > Steam > Ask where each game goes switches the question off; Use a different folder stops using the registered folder so another can be chosen (nothing on the drive is deleted).
- A drive speed test (Settings > Steam > Test the drive's speed) writes and reads a 64 MB file and makes 60 small files, then shows write speed, read speed and small files per second.
- Gentle writing for slow drives: before a download Porthole writes 8 MB to the drive and times it (kept for three days); a drive that manages 40 MB/s or more is written like the device's own storage, a slower one gently (four chunks in flight, in order); a drive that slows down mid-download is noticed and the rest is written gently.
- Hide the stores you do not use: long-press a store on the Stores tab, or Settings > Stores > Show on the Stores tab. A hidden store leaves the Stores tab, the store switcher and the All games page; a line at the bottom says which are hidden and opens Settings to show them again. Nothing is signed out or deleted.
- Stores tab: the store icons have a row to themselves, the search box, filters, Friends and Sort wrap onto new lines instead of sliding sideways, and the All / Installed / Controller choice is remembered per store.
- Settings > Sound > Keep other apps' sound playing: music, a podcast or a video in another app (second screen, Split View, Picture in Picture) plays together with the game. Programs from the Software section always allow it.
- Home can show your library as a shelf, a grid of cards or a list with a Play button on every row; the choice is kept. A game without a picture gets a gradient made from its name, with its first letter large and faint; the colours stay the same every launch.
- A game's page is sorted into Set up (controls and key binds, more options), From Steam (news, achievements, friends playing, workshop), Reports (how it runs for others, report how it runs, report a problem) and Manage (about and files). The report buttons are in one place; "Report a problem" from a game's page already has the game's name in the sentence.
- A "Last time" card on a game's page says in plain words how the last run ended: how long it ran, why it could not start, the known cause when the log fits one, and how much memory the run used with what helps when it ended badly. "Share this game's log" hands the game's newest own log to the share sheet, cleaned of your name, account names, e-mail and public IP addresses. When the log holds a line the website's documentation explains, the card says "Looks like: ..." and opens that entry.
- A note on a game whose folder holds files of a cracked, repacked or emulated release (files scene releases and Steam emulators ship, well-known piracy sites by name, release groups' .nfo files, OnlineFix files): the game can still run, there is no support for copies like this. Nothing is blocked or changed; a plain word such as "gog" or "steam" never counts.
- Porthole's own tested setups can be offered next to Madeira's list on a game's page, as a button you press and can undo. The first is Supermarket Simulator (the engine's texture saver, Swap 4 GB, large blocks and relaxed vector memory ordering; it ran 13 minutes on an iPad with an M4 chip at 56 to 65 frames a second).
- The Witcher 3 and Dying Light 2 start with AVX and AVX2 on (both ended on an AVX instruction without it).
- A "No extra memory" chip on a game's launch screen when this copy was signed without the Increased Memory Limit permission (a free Apple account cannot have it), and an explanation on a game's page after a run that ended badly with memory warnings in such a copy. A copy that can never get JIT (signed with a distribution or enterprise certificate) now says so at once when a game is started.
- Launch screen: the facts about how the game starts are small tags that wrap, and the buttons stack when they do not fit, so "Show Steam window" is never cut off.
- When a game stops and its log clearly shows a known cause, Porthole suggests changing one setting of that game, with Apply on Home. Saying no leaves the game alone and the same fix is not offered again (Settings > Fixing problems can still apply it). Applied fixes have an Undo; the first run afterwards is judged (it worked if it ran five minutes or more and drew frames; the setting is put back if it ended within two minutes without a frame or showed the same cause again). A switch, "Ask me before changing a game" (on by default), turns the asking off.
- The causes handled: a game that needs AVX (ended on an AVX instruction) gets AVX and AVX2; a game that ran out of memory repeatedly gets a 4 GB swap file with wide coverage; a swap file that was on but covered little widens its coverage; Unity games that ran out of memory on textures get the texture saver; a game whose emulator pool filled with copies of the game's libraries stops copying them; a game whose sound library could not be copied into the pool gets the code buffers a region of their own; an install without the Extended Virtual Addressing capability gets an explanation (nothing is changed).
- When a game crashed and no line names a cause, Porthole falls back on what is known about it: a tested setup from Madeira's or Porthole's list (only for a game with no engine lines of its own), then the settings most people who say the game works great use (from the community server). Each is tried once per game, asked first, judged and taken back if the next run ends badly again.
- A game whose program is not where it was saved is repaired: Porthole looks for a file of exactly the same name inside the game's own folder, points the game at it and says so on Home. It never searches a folder that holds many games.
- Settings > Fixing problems lists the last ten changes (suggestions, declined ones and applied ones, with what the run after each one showed) and can Apply or Undo them.
- The Hub can publish new rules (turn AVX on, set a swap file of 512 MB to 8 GB, widen coverage, add one plain engine line, or only explain), replace a built-in rule, and switch any fix off, so new causes can be handled without an update. The Launcher's Reviews > Fixes list has a toggle for each.
- An on-screen game controller: two sticks (a quick tap clicks one), a direction pad, A B X Y, bumpers, triggers, View and Menu. The game sees an ordinary Xbox pad, so nothing in a game has to support it. Switch it on in the game's page or in the in-game menu; its size and opacity can be changed. A real controller can be used at the same time.
- Four controller types (Xbox, PlayStation, Nintendo Switch, Super Nintendo), each with its own look and its own arrangement of the controls, and layouts to choose from (Standard, Mirrored, Retro, Racing, Minimal, PlayStation, Xbox, Nintendo Switch). The controls are about half their first size, redrawn with glass-like buttons, rings and a raised thumb, and stay clear of the right edge swipe and the safe area.
- A game that ignores the on-screen game controller (no controller read for 20 seconds) is offered touch controls for keyboard and mouse, with a card you can accept or dismiss; the answer is remembered for that game.
- Touch pointer (in-game menu > Controls): Direct (the finger is the cursor) or Trackpad. A finger sliding anywhere moves the game's cursor (Slow, Normal or Fast), a tap clicks, a tap then a touch and slide drags, a two-finger tap is a right click, two fingers sliding scroll. A Right mode swaps the buttons.
- A full keyboard over the game: function keys, numbers, letters, punctuation, arrows, Tab, Esc, Enter, Space, Backspace, Delete, Caps. Shift, Ctrl and Alt hold for the next key when tapped (yellow) and lock when tapped twice (green). "Fewer keys" hides the function row. Open it from the in-game menu or add a Keys button to a layout.
- Custom layouts can hold gamepad controls (sticks, D-pad, A B X Y, bumpers, triggers, Menu, View, stick clicks) next to keys and mouse buttons; there is a Gamepad preset.
- Floating sticks (off by default): a stick's base appears where your thumb lands. "Hide when not touched" (Never, After 5, 10 or 20 seconds): the controls fade away and come back with a touch anywhere.
- The controls editor's Options menu: controls opacity when playing, tap feedback on or off, bring to front / send to back, combos (hold Shift, Ctrl or Alt together with a key), lock positions and sizes, and a shape (round, rounded square, square) and a colour for keys and mouse buttons. A layout saved before these options reads exactly as before.
- Blender gets touch controls for its 3D view: two fingers pan, a pinch zooms, three fingers orbit, and a column of buttons sets what one finger does (Select, Orbit or Pan) and jumps to the camera view or frames the selection.
- Settings > Controls: controller (connected controller, rumble and a rumble test, open the menu with the controller, controller as keyboard and mouse, pointer for the controller, hide on-screen controls), keyboard and mouse (mouse speed, mouse look, scroll direction, key repeat, keyboard layout, the keys for Porthole's menu and pointer lock) and touch screen (look sensitivity, fewer keys on the on-screen keyboard). Controller fixes and Keyboard and mouse fixes appear with Show technical options. The same engine options are still in Advanced > Engine options; changing one changes the other.
- Blender starts without copying libraries by hand (libraries in its blender.shared folder are put next to it as hard links, refreshed after an update), gets the engine lines it needs by itself on its first start (OpenGL 4.3 and the 2:10:10:10 vertex format; that start is stopped once with a message because the lines are read when Porthole opens), and a video library (avicap32.dll) it lacked.
- Cycles GPU rendering: kernels built ahead of time for your GPU and iOS version are offered on Blender's page (only a pack made for this device is shown, else the one that works anywhere), and Blender picks them up by itself; scenes with transparent shadows render with the right shadows. Blender's page also lists its known limitations and known problems, which can change without an app update.
- Native Arm programs start: the CPU-level check at start-up, per-thread storage, and asking which module holds one of a program's own functions are fixed in the engine (patches 0179, 0181 and 0182).
- The Metal layer that Windows programs reach the GPU through can compile Metal source, build ray-tracing structures, use linked functions and intersection tables, report a pipeline's limits and set threadgroup memory, and load GPU binaries built ahead of time (the machinery Cycles needs).
- Vulkan as an opt-in route for x64 games: DXVK (Direct3D 10/11) and vkd3d-proton (Direct3D 12) with Wine's Vulkan driver, using MoltenVK or KosmicKrisp (Mesa 26.2's Vulkan 1.4 on Metal 4; iOS 26 or later) as the Vulkan library. Off unless a game asks; DXMT and madeira-d3d12 stay the normal routes. The app grows by about 16 MB plus about 13 MB for KosmicKrisp.
- A game's page > Engine > Graphics route (Vulkan, experimental): Direct3D 10/11 runtime, Direct3D 12 runtime and Vulkan library, each starting on Default, which changes nothing.
- A [benchmark] line at the end of every run: the game, build and engine, the length, average frame rate, the slowest 1% and 5% seconds, the lowest second, peak app and GPU memory, least free memory, heat, and the graphics choices in effect. The memory line is now also written once a minute, so a run that iOS ends still leaves its latest figures.
- Diagnostics: with MADEIRA_BLOCK_RING on, the log holds the last blocks of code a program ran before it exited by itself; the engine's crash report lists every register ([fault-regs-all]); an instruction the emulator cannot decode gets a line with the bytes around it and what owns the address.
- "Install the game's prerequisites" on an Epic game's page when its manifest lists a setup program (Unreal games' UE4PrereqSetup): it runs that setup once, on request, in Porthole's Windows, on the desktop where you can watch it, and offers to run it again. It never runs by itself.
- The website's documentation (portholehq.site/docs): every setting, engine line and message. "What does this mean?" on errors (the "Couldn't start the game" notice, install-check notices, failed downloads on the Epic, GOG, EA, Amazon, itch.io and Steam pages, failed rows in Downloads), "Read more online" in a setting's (i) pop-up, and "What these lines do" under the engine-lines editor (name, description and default of each line, and a warning for a line the engine does not know).
- Errors from the system are put in plain words with a next step (no internet connection, a server that took too long, a secure connection that failed, not enough free storage, a file that is gone). This covers about 100 places. "Madeira Dock could not complete the Steam launch (code 45)" says that Steam itself refused, gives Steam's reason number and lists what to try. "Wineserver failed to start", "JIT pool allocation failed", "Could not open StikDebug" and "File not found" say what they mean and what to do. A copy installed with a distribution certificate is told to install again with a development certificate (SideStore or AltStore with a free Apple ID).
- When JIT cannot be switched on, the message names the step that failed and a short reason.
- The setup guide's Full speed page offers "Use LocalDevVPN" and "Allow Porthole's own private link" as two choices and says one is enough; an install whose own tunnel cannot start shows that as a warning, not a problem.
- The start-up log says how this copy is signed (device model, system version, signature flags, kind of provisioning profile, entitlements granted and entitlements really signed with), so two installs can be compared.
- A compatibility report carries the game's own session logs (up to five newest within two weeks), not Porthole's; Report a problem carries the game's own logs too. Logs are thinned before they are cleaned and sent (a 45 MB log becomes about 6 MB), and cleaning personal data out of a log is about ten times faster.
- A game that works can be reported at any time: the five minutes of play that were needed are gone (the question Porthole asks after you play still waits five minutes).
Changed
- Settings are 17 short pages in six sections: Playing (Display, Performance, Sound, Controls), Your games (Stores, Saves, Storage), Connection (JIT and connection), App (Appearance, Updates, Signing, Advanced), Reports and fixes (Compatibility reports, Fixing problems), Help (Setup guide and tips, About and credits, Report a problem). Signing (certificate and profile) and Fixing problems have pages of their own. Settings search, the guide cards and Home's notices open the new pages.
- Settings were decluttered: Audio buffer and Bring sound back after a call, and the Bundle row, are behind Show technical options; LocalDevVPN, Your own VPN and Cellular data are one row, VPN and cellular options, that opens a page; the list of builds is one row, Older versions; the credits are in Licences and credits; the Downloads and Storage rows that repeated on every store's page are gone; the search finds every moved row and says when one needs Show technical options.
- Settings polish: a setting's (i) button sits right after its name, so values, switches and arrows line up on the right edge. Store cards are the same height. A game's picture has a stronger shade behind its name. The performance overlay's numbers fill their rows evenly.
- The in-game menu: the tabs are one row of equal boxes with an icon and a one-line label, cards have rounder corners, and the Processor card shows its state in a tile with the long explanation one tap away.
- Swap starts on, at 4 GB covering blocks of 1 MB and up, on iPhones and iPads whose apps may use about 4 GB. A value you chose before, Off included, is kept; a game's own Swap setting still wins.
- The engine is upstream Madeira of 2026-11-05 plus two upstream fixes, with Porthole's patches (the vector registers of a thread read through another thread's context, two leaks of JIT pool code buffers fixed, Direct3D 9 effects compiled at run time and one-channel render targets, no first-frame stall from a large Direct3D 12 shader cache, and Social Club's 2.4.0.302 launcher).
- Direct3D 12 frame generation and upscaling follow only the game's own large window; small probe and helper windows are left alone.
- The old MetalFX frame generation is gone; Lossless Scaling's is the only one. Upscaling's fixed factors are 1.5x and 2x.
- Steam Cloud says "Up to date with Steam Cloud" instead of "Everything is in step", and a Steam Cloud download backs up the file it replaces (file.1.porthole-backup, up to five) instead of deleting it.
- Settings > Connection no longer shows "Turn the tunnel on" on an install that has no tunnel of its own. Enable JIT is more honest about why it cannot work.
- BeamNG.drive's x64 program is started directly, next to Steam's client, with the options its settings need (the game's launcher insists on its native Arm build, which cannot run here). Programs started this way begin in the game's folder.
- Choosing the external drive's folder: Settings > Steam explains how (make a folder on the drive first and open that folder), refuses a folder on the device itself, and explains a FAT32 drive instead of failing (format it as exFAT).
- Preparing a Steam download makes each folder once and as files are written, and checks the game's files already on the drive in parallel, so Preparing on a slow drive is shorter. The log times it.
- The mouse wheel in a game turns the same way as the launcher's lists (it follows the system's natural scrolling setting).
- A game's page, Last time card and the Fixing problems list use plain words; "Fix known problems automatically" is now "Look for known problems".
Fixed
- Porthole no longer crashes after a Windows program ends with an error (a pointer to the program's name was read after its thread was gone).
- Scrolling with a mouse wheel outside a game no longer crashes the app, on any screen (1.3.16 to 1.3.20 test builds only).
- Downloads to a drive no longer freeze the app: drive work that a slow drive answers slowly (the list of finished chunks, creating folders and files, adding up sizes, opening and closing files) moved off the screen thread and out of the lock the progress tick needs.
- A wineserver that dies while starting (seen when Porthole runs inside another app) ends the launch with a message instead of leaving the game waiting for ever.
- A .NET program packed as one file (the Memoria patcher for Final Fantasy IX is one) starts, gets a 4 GB garbage-collector reservation instead of 256 GB, and no longer freezes in the middle of its work.
- One click is one notch in games: a slow click registers, a fast turn of 10 to 20 clicks counts every click, a hard flick counts as several, a quick click's overshoot is not counted twice, the vertical axis is no longer chosen from noise (and is found on a large display area), and scrolling no longer counts each click twice.
- Games whose launch entries are all numbered (PAYDAY 3) start; Porthole asks for the lowest-numbered 64-bit Windows entry instead of entry 0.
- The offline start that came with Madeira's Steam launcher is switched on for real: a start with no network asks Steam to sign in offline from its saved licences, and the first normal online start records that it can.
- Steam Cloud: finds a new save where the game keeps it; a save changed on both sides is left alone and listed (before, only file dates were compared); a file Steam lists as deleted or not kept is no longer offered for upload; the card shows only for games Steam installed.
- Steam games downloaded with a damaged program path (for example "...\Ranch Simulator\mulator\...") start; new downloads get the right path and games with the damaged one are repaired the next time they start.
- A Steam download to an external drive is no longer refused with "0 MB is free" (many drives report no value for the free space iOS offers to apps), a game on the SSD starts instead of being refused as missing, and "the Windows SSD drive mapping is already in use" is gone (the link had no owner recorded).
- After a folder was chosen for the SSD there is a way to choose another, and the folder picker is opened from UIKit so pressing Open answers.
- itch.io .7z downloads: a file and a folder whose names differ only by case are refused with a clear message; an archive inside an archive that an earlier one replaced no longer stops the install.
- Home's note that a program was found again no longer opens Settings for JIT.
- Enable JIT works with StikDebug 2.x (the App Store version, which answers only to the older stikjit link), and says so in Settings and in the log when StikDebug cannot be found. JIT counts as on only when something is attached to answer the game's memory request (a leftover flag from StikDebug's app list used to count, and Play failed with "JIT pool allocation failed").
- A controller that stopped answering after opening Control Center or the app switcher answers again (not verified on a device); the on-screen controller reaches a game started a second time.
- On a game's About and files page, the Program row's Change button opens over the sheet.
- Frame generation no longer starves the screen of drawables (about 3 FPS with two generated frames), no longer leaves a Direct3D 12 game at about 10 FPS or frozen, and no longer stops the game for a moment and switches itself off while its shaders are prepared.
- Upscaling works in Direct3D 12 games (it did nothing there) and no longer enlarges a game that already draws at the screen's size to twice the screen; with upscaling and frame generation both on, games with an sRGB back buffer no longer flicker.
- Many Direct3D games offered no resolution below the one Porthole was set to.
- The in-game menu: "Performance" no longer breaks into "Performa" and "nce" in the tab bar, and the "Back to launch screen" button is no longer drawn over the menu's title.
- Touch controls: the gamepad controls of a custom layout answer touches (they were drawn but did nothing in builds 1.3.156 and 1.3.157); a key with a combo keeps its modifiers down until after the key is up; the D-pad follows the Tap feedback setting; a locked layout cannot be replaced from Presets.
- Epic prerequisites: the setup is only marked as having run when its own session ends, and a setup that failed to start no longer blocks the next try. The [benchmark] line names the route the game's config really used.
- Reports and Report a problem took a long time to prepare and send for a game with long logs.
- The automatic fixes missed a crash when the app was opened a second time before the first had been read (they fall back on the game's own session log); a declined or waiting suggestion is no longer forgotten when the history grows; Apply on a suggestion whose rule the Hub has removed says so in the log.
- About 30 settings added during 1.3 had no "Read more online" link because the list of documented settings was out of date.
- Supermarket Simulator no longer runs a 6 GB iPad out of memory when a save loads (its texture saver is on); Subliminal no longer asks for the Visual C++ Redistributable (arm64) (Porthole writes the marker it reads).
- Steep from the Epic library no longer ends a second after it starts (the launcher stub exits at once; the session now waits for the launcher it started). Whether Ubisoft Connect then signs in and starts the game is not known.
- Grand Theft Auto V Legacy: the Windows imaging component is registered with a proper path (Rockstar's launcher no longer quits with "failed to initialize"), every class registration with a garbled program is put back, the shader converter skips a case it cannot handle instead of ending the game on an assertion, the game gets room for all the threads it, Steam and the launchers start, fast semaphore waits, and Madeira's tested settings including the Social Club memory layout.
- Grand Theft Auto V Enhanced: Social Club's browser helpers start (Madeira's tested launcher, code-pool and thread settings), and it starts with the Broad swap coverage (no seconds at or below 12 FPS in two runs, against 15 of 60 with Wide; lower Texture Quality if the memory warning shows). Red Dead Redemption 2 shares the Social Club bridge, which knows launcher build 2.4.0.302.
- BeamNG.drive: the native Arm build that could not load D3DCOMPILER_47.dll is avoided (the x64 build is started directly).
- Unity games that run out of memory on their textures are offered the texture saver (a rule built from logs people sent in; no single game is named).
- Final Fantasy Resonance: a sound library that cannot be copied into the memory pool is offered a fix. Final Fantasy IX's Memoria patcher (single-file .NET) starts and runs.
- Factorio: a new world is uploaded by Steam Cloud. Persona 5 Royal: the thread-context crash is fixed in the engine. Schedule I: frame generation works with its sRGB back buffer. The Witcher 3 and Dying Light 2 start with AVX on. PAYDAY 3 starts through Steam.
- Black Ops Cold War: the engine keeps the game's address range while its protection rebuilds its program (patch 0193; experimental) and the log shows the instruction it stops on. It does not run yet.
1.2.1 (build 688): Compatibility reports now carry the log of the run that played the game.
Fixed
- A compatibility report sent after the app was opened again (the game ended, or iOS closed the app) carried only the few seconds of the new start-up instead of the game's run, because the new log is always the newest file. The report now takes the most recent log that mentions the game's launch: this run's, the run before, or the game's own session log.
1.2.0 (build 681): Autumn Tide: keyboard and mouse in games, the whole app on a controller, the EA store, a new look and a new game engine.
Added
- A keyboard and a mouse or trackpad (iPad) work in games: every key with the modifiers, five mouse buttons and the wheel, the game's own cursor in menus, a locked pointer for looking around, and your own key for Porthole's menu (F10 by default). The mouse wheel and press-and-drag scroll every screen.
- The whole app works with a controller: an on-screen keyboard you drive with the D-pad, a fixed starting place on every screen, and live button hints.
- The EA app joins Steam, Epic Games, GOG, itch.io and Amazon Games as a store.
- A new look for Home, Stores, game pages, the launch screen, setup, Reports, Settings (with search) and the performance overlay.
- Optional Donor memory for big games, gyro aim and turbo, sharing a game's setup, and .7z installs for itch.io.
Changed
- A new game engine: Madeira's latest work is merged in, so more games can run. Compatibility badges start again at "Not yet tested" for it.
- Steam is steadier and faster: no random sign-outs, downloads of 160-170 MB/s in testing, and sizes that add up.
- Game reports are sent with the game's log and checked before they appear.
Fixed
- Final Fantasy Resonance, Celeste and other .NET Framework games now run.
1.1.0 (build 551): Full Steam Ahead: much more Steam (versions, DLC, achievements, friends, the Workshop), Amazon Games, Restart game, and fixes for American Truck Simulator, Megabonk and Counter-Strike 2.
Added
- Amazon Games in the Stores tab: sign in on Amazon's own page and install the games you bought or claimed with Prime Gaming. Files come straight from Amazon's servers and are checked against Amazon's signed file list.
- Steam: a Version and DLC row on a game's page. Pick another version Steam offers (a beta or the previous version), type a beta password for a private beta, and turn DLC you own on or off. Only the parts that differ are downloaded.
- Steam: achievements with pictures, descriptions, unlock dates and how many players have them, a progress line ("12 of 50 unlocked") on the game's page, pop-ups when you unlock one in a game, and the full list in the in-game menu (Steam > Achievements).
- Steam: your friends (read only): who is playing what, who is online, and who was last seen when, on a Friends button at the top right of the Home screen, in the Steam list and in the in-game menu, plus a Friends playing row on a game's page. Nothing is sent to Porthole's servers.
- Steam: news and patch notes for a game, and Steam's review score and Steam Deck rating on its page (public Steam pages, no sign-in).
- Steam Workshop (beta): browse, search, subscribe to and download a game's items in the app and inside the running game (in-game menu > Steam). Items are checked for updates when a game's page opens (switch it off with Update mods automatically). Depot items such as American Truck Simulator mods can be subscribed to while a game runs and download when it closes. Tested with Portal 2 and American Truck Simulator.
- Restart game, in the in-game menu and on the Workshop page: closes the game and Porthole, then starts the same game again when you open Porthole (iOS needs one tap on a notification). If a game ignores the close request, Porthole asks whether to stop it.
- A Steam menu in the running game opens when a game asks for Steam's overlay (its own Workshop or Store button), instead of leaving the game stuck until you press Escape.
- Your own VPN can come back as soon as JIT is on (Settings > JIT and tunnel), for networks that block Steam.
- The launch screen says why Steam will not start a game (needs an update, or files marked damaged) and what to do, and says when Steam has not signed in.
- Add a game > Import a game folder says how to choose the folder, and writes what happens to the log.
Changed
- Signing in to Steam starts with the QR code (approved in the Steam mobile app, so Porthole never handles your password). The sign-in screen says Porthole is unofficial and not affiliated with Valve.
- Verify and update files on a Steam game's page really checks every file against Steam now and downloads only what is missing or damaged. Updating a game also keeps the parts of files already on the device that have not changed.
- Megabonk starts without a hand-typed engine line and its controller works in Automatic. Sorting the all-games page by recently played now includes GOG and itch.io games.
- Engine r17 (it was r13 in 1.0.1). Compatibility badges start empty for it.
Fixed
- American Truck Simulator (and other games that create a tiny placeholder window and rely on DirectX to size it) showed as a postage stamp. The window is now resized or made to cover the screen.
- Megabonk, and any Unity game that uses Rewired's Windows.Gaming.Input plugin, saw no controller. The controller is now also offered as a Windows.Gaming.Input gamepad for these games.
- Counter-Strike 2's first-person look stopped at a fixed angle. The game's mouse-input thread needs a system window class that was missing for the game, so it never got raw mouse movement.
- Portal 2 and other single-file Workshop items are recorded the way Steam records them and put where Steam keeps finished downloads, so the game opens maps the app downloaded even where Steam's own download times out.
- A Steam game is no longer started with too little memory room: on a bad start of the app the room for the game's translated code can shrink and the game runs out of memory a minute in. Porthole now stops, says so and offers Close Porthole.
- Workshop single-file items downloaded from a web address (Portal 2 maps) no longer fail with "Steam did not accept the sign-in token".
1.0.1 (build 500): BeamNG.drive starts and can be played (early support).
Added
- BeamNG.drive (Steam, version 0.39.4.0) starts, shows its menus, loads maps and drives. It needs one extra file that Porthole cannot supply: Ultralight's ICU data, icudt67l.dat, copied into the game's ultralight folder. docs/GAME_FIXES.md says where to get it and where it goes.
- A BeamNG.drive game fix, applied automatically: the game is started with its own switch for the menu engine that does not use Chromium (-forceUltralight), and the memory layout, no-copy image loading and lock settings it needs are set for that launch only.
Changed
- New game engine version (279fd0f-r13): compatibility badges start fresh for it, and older reports stay visible as earlier ones. Most of the engine changes are switched on only for BeamNG.drive's launch; the monitor fix below applies to every game.
- Game fixes that set a file aside now also apply to games started through Steam, and match the file name whatever its capitals; the log says where a fix looked when it found nothing.
Fixed
- Borderless and fullscreen windows: a game that asks Windows for its monitor with a handle the engine does not know now gets the screen's size instead of an error. BeamNG.drive set its window to 0 by 0 in Borderless and showed an empty desktop with sound.
1.0.0 (build 480): Porthole 1.0.0: the first public release.
Added
- Windows PC games on iPhone and iPad, using the Madeira runtime (Wine, FEX and DXMT): a game library with art, play time, per-game settings and on-screen or controller controls.
- Four stores in one Stores tab: sign in to Steam, Epic Games, GOG or itch.io and download the games you own, with one Downloads page, pause and resume, and a lock-screen download card.
- A community compatibility list: badges from reports by other people, counted per device model and engine version, and a short report of your own in under a minute.
- An in-game side-panel menu with power modes, frame generation, controller choice and an optional performance overlay, plus short guides and a first-game tour.
- Updates from inside the app with your own certificate, checked against the maintainer's release signature, with every earlier version available to go back to.
- JIT switched on from inside the app (on iOS 27 or later the pairing file is made on the device), and an optional private link so it needs no computer.
Every release is also on the project's Releases page.