Show technical options Toggle
Shows swap and video memory, shader math, tunnel and JIT status, and technical readouts. Most people never need them.
Documentation
What each switch, slider and button in the app does, in the order the app shows them. Search for a word from its name, or from what you want to change.
Shows swap and video memory, shader math, tunnel and JIT status, and technical readouts. Most people never need them.
The emulator keeps a stretch of memory free for the rare game that can only load at one fixed address. When none of a game's programs needs it, this gives it back so the code pool can be larger (fewer freezes in big games). Turn it off to go back to the previous behaviour if a game that started before no longer does.
Programs many games need and Windows would normally have. Each is a one-time download, checked against a fixed fingerprint before it is used.
Microsoft's runtime that many games need. About 25 MB, downloaded from Microsoft's own installer and checked against a fixed fingerprint before anything is used. Without it some games won't start.
No further description in the app.
Games built on Microsoft's .NET Framework (Celeste, many indie games and launchers) run on Wine Mono, the Wine project's open-source .NET runtime. About 42 MB from WineHQ, about 130 MB once installed, checked against a fixed fingerprint before use. Without it those games end as soon as they start.
No further description in the app.
Microsoft's C++ runtime for 32-bit programs (older games, many launchers). Without it they run on Wine's own C++ runtime. About 14 MB from Microsoft's installer, checked against a pinned fingerprint and unpacked here; every file is checked again. Not allowed while a game is running.
No further description in the app.
Installers and launchers that show a web page use Wine Gecko, the Wine project's open-source web engine. About 110 MB from WineHQ (a 32-bit and a 64-bit file), checked against fixed fingerprints before use. Without it Wine stops on its own “Wine Gecko Installer” window, whose download can hang. Programs that already installed it keep it.
No further description in the app.
A porthole:// link can start a game from a Home Screen shortcut, a web page or another app.
A porthole://play link (a Home Screen shortcut, a web page, another app) starts a game that is in your library. With this on, Porthole asks first, so a link you did not expect cannot start one. Links from a computer you have paired are not asked.
For testing from a computer. Leave this off normally.
Lets porthole:// links stop an ended game, change one setting line of a game, or install the newest update. For testing from a computer (tools/ipad.sh). Leave off normally: any app or web page that can open a link could use them.
For finding out why something looks or behaves wrong. Leave these off normally.
Saves a picture of every Windows window about every 2 seconds to Files > Porthole > surfdump. Use them to report a window that looks wrong. Leave off normally.
Advanced: records extra Wine messages in the log (for example +msg for window messages). Leave empty normally.
Tap a row, then press the key you want (hold Ctrl, Alt, Shift or Cmd with it for a combination). Esc cancels. Ctrl+Alt+M and Ctrl+Alt+P always work as well, so a key you cannot press never locks you out.
No further description in the app.
No further description in the app.
No further description in the app.
No further description in the app.
If Porthole works for you, a share helps other people find it.
Share a link to the website
Every game starts with this, unless you set up controls for that game.
While these on-screen controls are in use, the game's picture moves to the top edge of the iPad and the controls sit under it, covering as little of the game as possible. The picture is never cropped or made smaller. It does not move when you play with a mouse and keyboard or a real controller, or when there is too little room under the picture.
No further description in the app.
No further description in the app.
No further description in the app.
No further description in the app.
No further description in the app.
Found when Porthole opened again, …. Its log was kept, so the report has the run that ended and not the launch that followed.
No further description in the app.
The log says what the app and the engine did, from the start of the run to its end. It is a few megabytes and is sent packed. Folder names inside the app, your account names, e-mail addresses and public IP addresses are replaced before it is written or sent. Fingerprints and technical lines stay, because they are what is looked at.
No further description in the app.
Attach the file to it
There are support channels
News and new versions
No further description in the app.
One zip of every Windows user's Documents, Saved Games and AppData (caches and Steam's own files left out), to keep in Files or iCloud Drive. A prefix reset or a reinstall takes saves with it; a backup does not.
No further description in the app.
When a game ends, your saves and settings are zipped into Files > Porthole > Saves backups. The newest five are kept, and nothing is written when nothing has changed, when the saves are over 150 MB, or when the phone is nearly out of space.
No further description in the app.
No further description in the app.
The controller connected to this device, and how Porthole and games use it.
On the Test controller page a DualSense, DualShock 4 or Xbox controller is drawn in 3D. A DualSense or DualShock 4 has motion sensors, and the drawing turns as you turn the real controller; an Xbox controller has none, so its drawing only moves with your finger. Nothing tells the controller which way is forward, so double-tap the picture to make the way it points now the front; it may slowly wander from there. The sensors are on only while that page is open.
No further description in the app.
Tap a key row, then press the key you want (hold Ctrl, Alt, Shift or Cmd with it for a combination). Esc cancels. Ctrl+Alt+M and Ctrl+Alt+P always work.
No further description in the app.
No further description in the app.
Looking around by dragging on the screen, and the on-screen keyboard.
How fast dragging on the screen turns the view in first-person games. A game can set its own on its page, and the in-game Menu has quick Faster and Slower buttons.
The on-screen keyboard hides the function row (F1 to F12) and remembers it. The same switch is on the keyboard itself.
On: sliding a finger from one on-screen button to the next lets go of the first and presses the second, without lifting. Hold B to run, then slide your thumb to A to jump. Works on the held buttons of the touch layouts and on the on-screen keyboard. Off: a button stays pressed until the finger lifts.
How big the on-screen buttons of your layouts are drawn, on this device. Layouts are made for a phone, so Automatic makes them a little larger on an iPad. The on-screen game controller has its own size in the in-game menu.
Shows every layout flipped left to right on this device, so the stick and the buttons swap hands. Nothing in a layout is changed: switch it off and they are back, and layouts you share are not turned round. The in-game menu has the same switch.
The version you are on and whether a newer one is ready.
No further description in the app.
No further description in the app.
No further description in the app.
The certificate and profile used to install and update. A free Apple account's signature lasts seven days.
Why the app needs a certificate and a profile to update itself
No further description in the app.
No further description in the app.
Every build on the update server, so you can go back to an older one.
No further description in the app.
…. Tap to see everything since … (…).
No further description in the app.
How your games run on this version of the engine, what other people reported, and the reports you sent.
Your games and everything people reported
No further description in the app.
Small marks on games that show how they ran for other people.
Badges come from reports other people sent. After a game you can send one yourself; it takes under a minute.
No further description in the app.
When a game stops and its log clearly shows a known cause, Porthole can suggest changing one setting of that game. By default it asks first and changes nothing until you say yes. It never touches app-wide settings and you can undo a change. Nothing is sent anywhere.
Examples: a game that needs AVX could get AVX turned on; a game that ran out of memory could get a swap file. Porthole reads the game's log after it stops and shows what it found on the Home screen. A game gets each fix once.
On (the default): a fix is only suggested, with Apply on the Home screen, and nothing about the game changes until you tap it. Off: the fix is made at once and the Home screen shows it with an Undo button.
Reports carry a random key kept on this device, not your name, and the game's log, which only the developer can read.
Reports are tied to a random key kept on this device, not to you. Forgetting it starts fresh: your old reports stay up but you can no longer edit or delete them.
… …
What Porthole and the engine wrote during the last run. Report a problem sends it for you.
Newest first. Share it from the Files app: Porthole > madeira-log.txt
No further description in the app.
portholehq.site
The licences of the parts it is built from
Holiday looks that appear by themselves around the day.
Porthole dresses up for some holidays by the date. Turn this off to keep your own colours all year.
How lively the app looks. Turning these down saves a little battery.
How strong the light around the selected thing is. Off turns the glow and the soft lights in the background down.
The soft coloured lights behind every screen drift slowly. Turn this off to save a little battery.
When a TV or monitor is connected with a cable (USB-C or Lightning to HDMI), the game fills that screen and the controls stay on your iPhone or iPad. Between games the display shows a waiting screen instead of mirroring Porthole. AirPlay Screen Mirroring on an iPhone is only a copy of the device's screen: iOS does not give apps a second screen over it. Turn this off to keep mirroring your device's screen, then connect the display again.
How fast games run and what happens when the device gets hot.
No further description in the app.
Stops the automatic drop when the device gets hot. Eco mode puts the game on the slow cores, so loading can crawl; this keeps full speed instead, and the device may get hotter and drain faster.
Picture choices that cost speed.
Exact lighting math instead of fast approximations. Off is faster.
No further description in the app.
For games that run out of memory. Most people never change these.
iOS has no swap and closes an app that uses too much memory. Swap keeps big chunks of game data in a file on the device's storage instead, where iOS doesn't count them, so a memory-hungry game can survive. It uses storage and can be slower.
No further description in the app.
No further description in the app.
Applies the next time a game starts.
Normally Porthole takes over the sound and other apps go quiet. With this on, a song, a podcast or a video playing in another app (on a second screen, in Split View or in Picture in Picture) keeps playing next to the game's own sound. Programs from the Software section, such as Blender, always do this. Applies the next time a game starts.
No further description in the app.
For crackling, or sound that does not come back. Most people never change these.
Extra buffered sound, in milliseconds. Bigger means fewer crackles but effects lag a little more. Applies on the next game start.
No further description in the app.
JIT lets the emulator run at full speed. It has to be switched on every time a game starts.
No further description in the app.
No further description in the app.
If Play says the tunnel will not connect.
If Play says the tunnel won't connect, this deletes the app's VPN setting and makes a fresh one. Your games and settings are not touched. iOS asks you to allow the VPN again.
No further description in the app.
No further description in the app.
No further description in the app.
The JIT helper reaches this device through a private connection. Porthole can make its own, or you can use LocalDevVPN; you only need one.
Does not start this app's own tunnel. LocalDevVPN (or another VPN with the same 10.7.0.x addresses) has to be switched on before you press Play; it keeps running while the game does. Turn this on if the app's own tunnel sometimes fails to come up. Off: the app starts and stops its own tunnel, which replaces any other VPN while it is on.
iOS runs one VPN at a time, so yours is paused while JIT is switched on.
iOS runs one VPN at a time, so Porthole's tunnel switches yours off while a game starts or an update installs. With this on, Porthole asks first.
iOS does not let an app start another app's VPN. To get it back automatically: open the Shortcuts app, make a shortcut with one action, Set VPN (choose your VPN, then Connect), and type its exact name here. When your game closes or the update is done, Porthole runs it, then returns here. Leave this empty and Porthole just reminds you. A VPN with Connect On Demand switched on in its own app comes back by itself.
With a shortcut above, your VPN comes back right after JIT is switched on, before the game starts, instead of when the game closes. Use this on a network that blocks Steam, so the game's Steam sign-in goes through your VPN. Porthole leaves the app for a moment to run the shortcut, as it does for cellular data.
Shortcuts can't be created for you: iOS only accepts shortcut files signed by Apple, and the Set VPN action has to point at your own VPN, which only you can pick. This opens a new, empty shortcut. Tap Add Action, search for Set VPN, choose your VPN and set it to Connect, then tap the name at the top and call it Porthole VPN. Porthole fills in that name for you.
The private connection does not work while cellular data is the network in use.
Porthole's private connection (JIT, and installing an update on this device) does not work while cellular data is the network in use. It needs no internet, so with this on, Porthole asks, switches cellular data off for a few seconds with a Shortcut, and switches it back on as soon as it is done. On Wi-Fi nothing happens.
iOS only lets an app switch cellular data through a Shortcut with the action Set Cellular Data. These two are bundled with Porthole, signed so iOS accepts them, and contain only that one action. Do not rename them.
A quick check that both shortcuts are added and allowed, so the first real use does not stop to ask. It works on Wi-Fi too.
No further description in the app.
No further description in the app.
No further description in the app.
Valve's own gamepad interface, running inside Porthole. An experiment: Madeira leaves it out of its releases because it is heavy and not finished.
Starts Valve's real Steam client in Big Picture mode inside the Wine desktop, so you can browse Steam the way it looks on a console. It needs the Steam client above. The first start downloads Valve's client (a few hundred MB) from Valve into a folder of its own, and takes a few minutes. It uses a lot of memory (a 4 GB swap file and 4 GB of donor RAM are asked for), the screen can be slow and Steam may take a while to appear. Your games are not changed. Madeira itself calls this unfinished.
Valve's own files, which start Steam games and check your licence.
Valve's own client files start your Steam games and check your licence. About 73 MB from Valve; nothing else is installed.
No further description in the app.
Where Steam games are downloaded from.
Which of Valve's download servers a game comes from. Automatic lets Steam choose from where you are, which is right almost always. A nearer or less busy region can be faster in special cases: a different one can only help, never change what you get. If a region has no server for a download, Steam's own choice is used. Applies to the next download.
How Steam signs in when a game starts.
On: once a game has started online, the next starts use what Steam saved: no new sign-in and no ownership check each time, about ten seconds faster. Steam renews the saved sign-in with an online start, which happens by itself after two weeks or when Steam could not use it. In such a start Steam is offline, so what needs a connection inside the game (multiplayer, Steam achievements) does not work: a game's own page can ask for an online sign-in every time. Off: every start signs in online, as before.
Your game saves on Steam's servers.
Before a game starts through Steam, Porthole downloads your own Steam Cloud files for it (such as world saves) if they are missing here. It only reads from Steam: nothing is uploaded, and a newer file on this device is never replaced.
Where Steam games are saved.
Pressing Download asks whether the game goes on the device or on the SSD, while the SSD is connected. Off: new downloads go where the next switch says.
A game you download from now on is saved on the SSD instead of the device. A game that is already installed (or half downloaded) stays where it is; Windows, Steam's client files and the usual Windows user folders stay on the device.
No further description in the app.
Writes and reads a 64 MB file and makes 60 small files on the drive, then deletes them. It tells you how fast the drive really is for Porthole: a game downloads no faster than the drive can write it.
Renews access to the same folder (after iOS forgot it). Choosing a different folder does not bring these games back.
Stops using this folder so you can choose another one. Nothing is deleted from the drive. Games that were put on this folder are no longer listed as installed here.
Open a drive or folder that already holds Steam games (a Steam library from a PC, or one Porthole made) and press Open: the games found are added to your Steam list. Or, for a new library, open the drive, make a new folder on it (for example “Porthole”: the ⋯ menu, New Folder), open that folder and press Open. Choosing the drive’s top level may not work: on some drives iOS gives Open no answer there. Pick a folder on a drive plugged into the device (a dedicated folder). Steam games you download to it keep their files, download progress and caches there. Cloud folders and network shares are not supported. If you unplug the drive during a game, the game ends.
How Steam games are drawn on the screen.
On (recommended): Steam games run on a Wine virtual desktop, and touch and rotation work. Off is an experiment that draws the game straight into the app's game view. Applies the next time a game starts.
Walk-throughs that point at the real buttons and move on as you use them. The cross on the card ends one at any time.
No further description in the app.
Short explanations that appear the first time you open a screen.
A short explanation appears the first time you open a screen, and when you start your first game. The question mark at the top of every screen opens it again.
Every screen explains itself again the next time you open it, and the next game you start shows its short tour.
The tour shown before your first game
Which version this is and what it is made of.
Free software, GPL-3.0-or-later, and who it is built on
Not listed anywhere else.
Adds a Start Steam Big Picture row to Settings > Stores > Steam. It starts Valve's real client in Big Picture, which has been seen to run its web helper into a crash on the first click. Experimental.
The size of the screen games see. Higher is sharper but needs more memory and a faster device; lower is faster. Games that pick their own resolution can choose any size up to this one, and the picture is scaled to your screen. Each game can have its own on its page. Applies the next time a game starts.
On: the screen turns to landscape when a game starts and stays there while it runs, even if you hold the device upright or lie down with it, and even with the system's rotation lock on. When the game ends the screen is free again. Off: the screen follows how you hold the device.
…. By default a game drops to Battery saver (30 FPS and Eco) by itself when the device gets hot. Each game can pick its own on its page.
No further description in the app.
No further description in the app.
No further description in the app.
No further description in the app.
No further description in the app.
What GOG's own client does while a game runs.
A game built with GOG's Galaxy SDK talks to GOG's client for its sign-in, achievements, stats, leaderboards and play time. While one of your GOG games runs, Porthole answers for that client on this device only, using your GOG sign-in to get a token for that one game. It needs a game installed from GOG's own builds (a game installed before this was added is read once, at its next start). Without it, or without a sign-in, the game runs offline, as it would without GOG's client. Not tested on a device yet.
No further description in the app.
Only one set is used at a time. Standard leaves this game's own Controls and Engine settings exactly as they are. A set with controller binds switches the controller to keyboard and mouse for this game; a set with a touch layout replaces the on-screen controls. Applies the next time the game starts.
Starts from this game's current controller settings
.portholebinds
Binds and touch layouts other people shared; rate them and add the ones you like
No further description in the app.
No further description in the app.
Only one set is used at a time. Applies the next time the game starts.
.portholebinds, to keep or send
No further description in the app.
No further description in the app.
With this on, using the set turns the controller into a keyboard and mouse for this game, with the buttons below. Off leaves the controller as it is.
No further description in the app.
With this on, using the set replaces the on-screen controls with this layout. Off keeps the default controls (Settings > Controls).
… control\(t.controls.count == 1 ?
Universal, Gamepad, Action, Point and click, Platformer or an empty screen
Left stick W A S D, right stick the mouse, buttons as keys. Off goes back to Automatic. Applies at once.
No further description in the app.
No further description in the app.
No further description in the app.
Controller binds and the touch layout
Move and change controls while you look at the game, and test them
Starts a new set with its own layout
Lets the translator run programs built for AVX processors through its 128-bit emulation. A game that closes the moment it starts, or after a message about unsupported instructions, may need it. Only 64-bit games. Costs some speed.
Enlarges the picture the game draws with MetalFX’s spatial scaler instead of the screen’s plain stretch. “To the screen” works out the factor itself: it enlarges the game’s picture to the screen’s own pixels (at most 2×) and does nothing when the game already draws about as large as the screen. It pays off when the game draws smaller than the screen: set this game’s Resolution (Settings or the game’s Display row) to what you want it to draw at, for example 1280×720, and the game gets faster while the picture stays sharp. A fixed factor is there for testing. Direct3D 11 and 12 games. This is what the game starts with: the in-game menu (Upscaling) changes it while the game runs, and remembers the choice for this game. It works together with Lossless Scaling frame generation: the generated pictures are enlarged the same way. Needs a device with MetalFX.
What enlarges the picture. MetalFX is Apple’s spatial scaler. Lossless Scaling LS1 is the upscaler of your copy of Lossless Scaling: a small neural network that redraws the edges; the performance version uses a lighter network. Direct3D 11 and 12 games. The in-game menu changes it while the game runs.
1 is the softest, 5 the sharpest (and can look over-processed).
Makes the pictures between the game’s own frames with Lossless Scaling’s motion-estimation shaders (from your copy of the program, set up under Stores > Lossless Scaling), so the screen can show more frames than the game draws. Like the MetalFX version it needs a screen that can run faster than the game (on a 120 Hz screen a game at 60 FPS or less), shows the game as it is when it cannot, adds about half a game frame of delay and works for Direct3D 11 games and, since 1.3.92, Direct3D 12 games too (they need more memory: the passes keep a few full-size pictures). The first seconds of a game stutter while the shaders are prepared. Not together with the MetalFX frame generation (this one wins). Experimental.
How many pictures are made between two of the game’s own. Each one needs its own run of the passes, so 2 and 3 cost much more graphics work than 1 and slow the game itself down. More frames also need a faster screen.
How many processor cores this game is told about. Some games size their worker threads from it.
Limits (or raises) texture filtering quality for Direct3D 9 games. The game's own setting is used by default.
Makes old floating-point instructions faster and less exact. The engine turns it on by itself for 32-bit games; Off asks for full precision, which some games need (Assassin's Creed's character cannot be moved with the left stick otherwise). Leave it alone for games that run well.
Which graphics card this game is told it has, everywhere it can ask: Direct3D 9, 10, 11 and 12, Windows' own adapter list and NVIDIA's NVAPI. For a game that refuses to start or picks poor settings because it does not know the card, or that needs an NVIDIA one. This changes only what the game reads; the device draws the same.
Turn this on when a game quits at start because it reserves far more address space than iOS gives the app (64 GB or more, as Final Fantasy Tactics - The Ivalice Chronicles does). Porthole then really backs 16 GB of it and tells the game it got everything. Off (the default) leaves such a reservation to fail, as before.
Which layer turns this game's Direct3D into the GPU's own language. Each row starts on Default, which is the normal route (DXMT and madeira-d3d12, both on Metal). Try a Vulkan route for a game that draws wrongly or crashes, or to compare speed.
Default is DXMT, which runs Direct3D 10 and 11 on Metal. DXVK runs them on Vulkan instead (through MoltenVK or KosmicKrisp). Experimental and off unless you choose it; 64-bit games only. DXVK is used together with vkd3d-proton for Direct3D 12.
Default is madeira-d3d12, which runs Direct3D 12 on Metal. vkd3d-proton runs it on Vulkan instead. Experimental and off unless you choose it; 64-bit games only.
The library the Vulkan routes (and OpenGL through Zink) use. MoltenVK is Khronos' translator and the default when Vulkan is needed. KosmicKrisp is Mesa's Vulkan 1.4 driver for Metal 4: it needs iOS 26 or later and a newer device, and may support more of what DXVK asks for.
How fast the mouse turns this game's camera. 1× sends the mouse's own movement unchanged. Applies at once.
For a game that turns the camera with the mouse but never says it hides its cursor: the mouse always moves the camera and the pointer is locked to the game (Ctrl+Alt+P frees it). Off lets the game's cursor decide.
For a game that needs a controller on a device that has none.
Draws an Xbox controller over the game: two sticks (tap one to click it), a direction pad, A B X Y, both bumpers and triggers, View and Menu. The game sees an ordinary Xbox pad. The touch layouts are put away while it is on, and a real controller works with it. You can also switch it during the game: swipe in from the right edge for the menu, then Controls > On screen.
No further description in the app.
No further description in the app.
Forces this game to use the controller as a keyboard and mouse (left stick W A S D, right stick the mouse, buttons as keys), for games with no controller support. Off goes back to Automatic. Change what each button does under Controller buttons.
Automatic (the default): the controller appears to the game as an Xbox pad, and if the game does not read it at all within about 25 seconds it becomes keyboard and mouse instead (and goes back to an Xbox pad the moment the game starts reading it). Xbox controller: always an Xbox pad. DualSense (HID) and Xbox: the pad is also shown as a DualSense on the HID path, for games that look for a HID gamepad and ignore XInput (Hollow Knight: Silksong); rumble does not work in this mode. Keyboard and mouse: always keys and mouse, for games with no controller support. Also DirectInput joystick: the same Xbox pad plus an old-style joystick for games that only look for one.
No further description in the app.
Changes which controller button the game sees for each button on your pad, for this game only: swap A and B, put a bumper on a trigger, turn a button off. It applies while the controller is an Xbox or DualSense pad for the game.
How fast the mouse moves up and down compared with left and right. Many games turn the view at different speeds in each direction.
The folder the program starts in, as a Windows path such as C:\Games\Foo. Leave empty to start in the program's own folder. A batch file (.bat or .cmd) as the program runs through cmd.exe.
Lines in madeira.cfg's syntax that apply to this game only, for example env.MADEIRA_FEX_AVX = 1. A key here wins over the app-wide madeira.cfg while this game runs.
Puts this game's launch options, per-game settings, engine choices and saved controls into one file you can send. It holds nothing of yours: no program path, account or play history.
One line to paste into a message
From a file or the clipboard
Starts this game from outside the app. Copy the link, then in the Shortcuts app make a shortcut with an Open URL action that uses it, and choose Add to Home Screen.
No further description in the app.
Tap here to cancel
No further description in the app.
No further description in the app.
No further description in the app.
No further description in the app.
Speed, memory, engine and launch options
From Steam
No further description in the app.
No further description in the app.
No further description in the app.
No further description in the app.
Send the log of a run that went wrong
No further description in the app.
Through Steam: Valve's own client checks your licence first. Most Steam games need this. Run directly: starts the game without Steam. Only use it for games that don't check Steam when they start; a game that does will freeze on its first screen.
Saved sign-in: after the game has started online once, later starts use what Steam saved (no new sign-in or ownership check; Steam is offline inside the game, so multiplayer and Steam achievements do not work). Online every time: Steam signs in online at each start. Default follows Settings > Steam.
The size of the screen this game sees. Default follows Settings > Display. Applies the next time the game starts.
Landscape: the screen turns to landscape when this game starts and stays there while it runs, even with the system's rotation lock on. Any orientation: the screen follows how you hold the device. Default follows Settings > Display.
Default follows Settings > Performance. Max runs up to the screen’s maximum (120 FPS on a ProMotion screen, otherwise 60), Saver is 30 FPS and cooler.
No further description in the app.
Some Steam games bring installers for things they need (Rockstar's launcher, DirectX, Visual C++). Run at next start runs the ones that have not run yet before the game starts, with Windows' service manager available to them; after that the choice goes back to Skip, so they do not run every time. Skip starts the game without them. Use Run at next start again to retry an installer that failed.
Forgets that this game's one-time installs ever ran, so the next start runs every one of them again (Rockstar's launcher, Social Club, DirectX, Visual C++). Use it after you deleted what they installed, or when an install stopped half way. It does not delete anything itself.
No further description in the app.
No further description in the app.
No further description in the app.
No further description in the app.
No further description in the app.
No further description in the app.
No further description in the app.
Back to …, as set in Settings > Controls. Your saved binds for this game are kept.
No further description in the app.
No further description in the app.
No further description in the app.
Extra command-line options for the program, separated by spaces.
Draws ordinary Windows windows, like launchers and installers. Games that draw their own picture don't need it.
Pick another program from this game's folder to start. The game stays in your library with its Steam link, settings and play time.
No further description in the app.
No further description in the app.
No further description in the app.
The log of this run holds a line the website’s documentation explains. This is a pointer, not a diagnosis: the page says how sure it is and what is worth trying.
Moving the controller (or this device) aims. Automatic gyro uses the controller's sensors (DualSense, DualShock 4, Switch Pro) and the device's own otherwise. Automatic output moves the right stick, or the mouse when the game gets no controller from the pad.
No further description in the app.
No further description in the app.
No further description in the app.
No further description in the app.
No further description in the app.
The least stick push a slow movement gives, so it gets past the game's own dead zone. Raise it if slow aiming does nothing.
No further description in the app.
No further description in the app.
No further description in the app.
No further description in the app.
Tap here to cancel
No further description in the app.
Confirm and cancel the other way round
No further description in the app.
\(padKind.glyph(
No further description in the app.
Puts this game's settings back as they were
Only for this game; you can undo it
Sends this version. Changed text waits for approval again.
No further description in the app.
Shares the controller binds and the touch layout so other people can add them. The name, notes and control labels you typed are shown to others only after they have been approved. No account or name of yours is sent.
No further description in the app.
Puts this game’s engine lines and settings back as they were
No further description in the app.
Different stores can ship different builds of the same game, so this matters. Pick from the list.
No further description in the app.
How the game was started and the performance settings it used. This helps people get the same result. Launch options you typed are never shared.
A person checks notes before they appear, so yours won't show straight away. Please don't mention where to get game files.
No further description in the app.
No further description in the app.
No further description in the app.
No further description in the app.
Keeps this game’s saves the same here and in Steam Cloud, so your other devices see them too. Opens a page that lists what is waiting to be uploaded or downloaded.
Compares …’s saves on this device with the ones in Steam Cloud. Nothing here runs by itself.
Compare this device with Steam
No further description in the app.
No further description in the app.
… · …%
From Steam
No further description in the app.
No further description in the app.
Mods and community items
No further description in the app.
No further description in the app.
No further description in the app.
What other players say about running this game here, by device, with the settings that worked.
No further description in the app.
No further description in the app.
No further description in the app.
No further description in the app.
Some games have private betas. A code from the developer, typed here, opens the beta it belongs to.
No further description in the app.
No further description in the app.
No further description in the app.
No further description in the app.
Valve's own client files start your Steam games and check your licence. About 73 MB from Valve; nothing else is installed.
No further description in the app.
No further description in the app.
No further description in the app.
No further description in the app.
No further description in the app.
When a mod you are subscribed to has a newer version on Steam, Porthole downloads it when you open the game's page. Turn this off to update only with the button below.
No further description in the app.
No further description in the app.
No further description in the app.
No further description in the app.
No further description in the app.
No further description in the app.
No further description in the app.
No further description in the app.
No further description in the app.
In Files, tap folders until you are inside the game's folder (the one with its .exe), then tap Open at the top right. Tapping a folder only goes into it; Open chooses the folder you are in. It is copied into the app, so it needs that much free space.
Games you own on Steam, installed straight into the app.
Games you own on Epic Games, installed straight into the app. You sign in on Epic's own page.
Games you own on GOG, installed straight into the app. You sign in on GOG's own page.
Games you bought, claimed or collected on itch.io, installed straight into the app. You sign in with your own API key.
Games you bought on Amazon or claimed with Prime Gaming, installed straight into the app. You sign in on Amazon's own page.
PC games on your EA account, installed straight into the app and started without the EA app. You sign in on EA's own page. Games with EA's kernel anti-cheat cannot run.
For games from a disc or a setup file you already have. Pick the setup file, run it, then add what it installed.
No further description in the app.
No further description in the app.
No further description in the app.
No further description in the app.
No further description in the app.
Needs Lossless Scaling on your own Steam account. Porthole never ships it and takes it from Steam only.
In Stores > Steam
Asks Steam whether this account has an active licence
Only the one file is kept, sealed
Deletes the sealed file and the proof
No further description in the app.
No further description in the app.
Porthole dresses up for some holidays by the date. Turn this off to keep your own colours all year.
Applies the next time a game starts.
No further description in the app.
Normally Porthole takes over the sound and other apps go quiet. With this on, a song, a podcast or a video playing in another app keeps playing next to the game's own sound.
Porthole reads the game's own log on this device. By default it only suggests a change and waits for your yes.
Examples: a game that needs AVX could get AVX turned on; a game that ran out of memory could get a swap file. Porthole shows what it found on the Home screen. A game gets each fix at most once.
On (the default): a fix is only suggested, with Apply on the Home screen. Off: the fix is made at once and the Home screen shows it with an Undo button.
When a game ends, your saves and settings are zipped into Files > Porthole > Saves backups. The newest five are kept.
Reports carry a random key kept on this device, never your name. Nothing is sent unless you choose to send it.
Small marks on games that show how they ran for other people.
After a game you can send a short report. It takes under a minute.
Skip the choices and get ready to play; every one of them is in Settings
About a minute, no computer
No further description in the app.
1. On a computer, install a free pairing tool such as iloader or Jitterbug. 2. Plug in your device and tap Trust. 3. Save the pairing file for your device (.plist or .mobiledevicepairing). 4. Move it to this device (AirDrop, iCloud Drive or a cable). 5. Come back and choose it here. You only do this once.
No further description in the app.
No further description in the app.
No further description in the app.
Turn LocalDevVPN on before you press Play and leave it on while the game runs.
Needs one permission from iOS
LocalDevVPN is a free app that makes the same private connection. Install it, switch it on before you press Play, and leave it on while the game runs. Porthole then does not start any connection of its own, and your own VPN is left alone. You can change this later in Settings > JIT and connection.
Pick a game's folder in Files and it is copied into Porthole, or run a Windows installer.
A short tour that points at the real buttons. More tutorials are in Settings.
Tap one to change it. All of them are in Settings too.
No further description in the app.
No further description in the app.
No further description in the app.
No further description in the app.
Send what happened, with the log, from Settings
Older games and many launchers are 32-bit programs. They run on Wine's own C++ runtime unless you add Microsoft's. You can also do this later in Settings › Advanced › Windows components.
About … MB, from Microsoft
No further description in the app.
About 25 MB, from Microsoft
No further description in the app.
Launchers and installers that show a web page need Wine's web engine. Without it Wine stops on its own download window, which can hang. You can also do this later in Settings › Advanced › Windows components.
About 110 MB, from WineHQ
No further description in the app.
Only for games built on Microsoft's .NET Framework, such as Celeste. You can also download it later in Settings › Advanced › Windows components.
About 42 MB, from WineHQ
No further description in the app.