Documentation

Every setting in Porthole

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.

Settings

Advanced

Options

Show technical options Toggle

Shows swap and video memory, shader math, tunnel and JIT status, and technical readouts. Most people never need them.

Bigger code pool when the game allows it Toggle

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.

Components

Runtimes

Programs many games need and Windows would normally have. Each is a one-time download, checked against a fixed fingerprint before it is used.

Visual C++ runtime Action

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.

Remove the downloaded copy Action

No further description in the app.

.NET Framework (Wine Mono) Action

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.

Remove Wine Mono Action

No further description in the app.

32-bit Visual C++ runtime Action

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.

Remove the 32-bit runtime Action

No further description in the app.

Web pages in programs (Wine Gecko) Action

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.

Remove Wine Gecko Action

No further description in the app.

Diagnostics

Debugging

For finding out why something looks or behaves wrong. Leave these off normally.

Save window pictures Toggle

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.

Wine debug channels TextField

Advanced: records extra Wine messages in the log (for example +msg for window messages). Leave empty normally.

Engine Group

Keys for Porthole

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.

Open Porthole's menu in a game Keybind

No further description in the app.

Lock or free the pointer Keybind

No further description in the app.

Try it

Test controller rumble Action

No further description in the app.

Engine Changed

Put every option back to Default Action

No further description in the app.

Community

Spread the word

If Porthole works for you, a share helps other people find it.

Tell a friend Action

Share a link to the website

Default Controls Picker

Default controls

Every game starts with this, unless you set up controls for that game.

Picture above the controls Toggle

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.

Layout Choice

No further description in the app.

Controller type Choice

No further description in the app.

Size Slider

No further description in the app.

Opacity Slider

No further description in the app.

Report Problem

My reports

Check for answers Action

No further description in the app.

A game ended unexpectedly

Include the crash of … Toggle

Found when Porthole opened again, …. Its log was kept, so the report has the run that ended and not the launch that followed.

What went wrong

In a sentence TextField

No further description in the app.

What is in the file

The whole log of the run (recommended) Toggle

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.

Look at exactly what would be shared Action

No further description in the app.

Send it

Open an issue on GitHub Action

Attach the file to it

Ask on Discord Action

There are support channels

Follow Porthole on X Action

News and new versions

Problem Entry

What you sent

Withdraw this report Action

No further description in the app.

Saves

Backup

Back up saves Action

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.

Restore saves from a backup… Action

No further description in the app.

Automatic backups

Back up after each game Toggle

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.

Back up now Action

No further description in the app.

Delete the automatic backups Action

No further description in the app.

Controls

Controller

The controller connected to this device, and how Porthole and games use it.

3D controller follows motion Toggle

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.

Test controller rumble Action

No further description in the app.

Keys for Porthole

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.

Open Porthole's menu in a game Keybind

No further description in the app.

Lock or free the pointer Keybind

No further description in the app.

Touch screen

Looking around by dragging on the screen, and the on-screen keyboard.

Look sensitivity Slider

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.

Fewer keys on the on-screen keyboard Toggle

The on-screen keyboard hides the function row (F1 to F12) and remembers it. The same switch is on the keyboard itself.

Slide a finger across buttons Toggle

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.

Button Size Choice Row

Button size Choice

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.

Left Handed Row

Left-handed Toggle

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.

Updates

This app

The version you are on and whether a newer one is ready.

Check for updates Action

No further description in the app.

Update to … Action

No further description in the app.

Download … Action

No further description in the app.

Signing

The certificate and profile used to install and update. A free Apple account's signature lasts seven days.

What is this? Action

Why the app needs a certificate and a profile to update itself

Import a certificate (.p12) Action

No further description in the app.

Import a profile (.mobileprovision) Action

No further description in the app.

Versions

Every build on the update server, so you can go back to an older one.

Open the releases on GitHub Action

No further description in the app.

Update available Action

…. Tap to see everything since … (…).

Dismiss Action

No further description in the app.

Reports Settings

Reports tab

How your games run on this version of the engine, what other people reported, and the reports you sent.

Open the Reports tab Action

Your games and everything people reported

My reports Action

No further description in the app.

Badges

Small marks on games that show how they ran for other people.

Show compatibility badges Toggle

Badges come from reports other people sent. After a game you can send one yourself; it takes under a minute.

Ask me how a game ran Toggle

No further description in the app.

Fixing problems

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.

Look for known problems Toggle

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.

Ask me before changing a game Toggle

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.

Privacy

Reports carry a random key kept on this device, not your name, and the game's log, which only the developer can read.

Forget my reporting identity Action

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 was changed

…: … Action

… …

Log

Log

What Porthole and the engine wrote during the last run. Report a problem sends it for you.

Read the log Action

Newest first. Share it from the Files app: Porthole > madeira-log.txt

Licences

Porthole

Source code online Action

No further description in the app.

Project website Action

portholehq.site

Built on

Licence texts Action

The licences of the parts it is built from

Appearance

Festive

Holiday looks that appear by themselves around the day.

Festive themes Toggle

Porthole dresses up for some holidays by the date. Turn this off to keep your own colours all year.

Glow and motion

How lively the app looks. Turning these down saves a little battery.

Glow Choice

How strong the light around the selected thing is. Off turns the glow and the soft lights in the background down.

Moving background Toggle

The soft coloured lights behind every screen drift slowly. Turn this off to save a little battery.

Display

Other screens

Play on a connected display Toggle

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.

Performance

Power

How fast games run and what happens when the device gets hot.

Keep a game running in the background EngineChoice

No further description in the app.

Keep my mode when hot Toggle

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.

Graphics

Picture choices that cost speed.

Precise shader math Toggle

Exact lighting math instead of fast approximations. Off is faster.

Keep compiled pipelines EngineChoice

No further description in the app.

Memory

For games that run out of memory. Most people never change these.

Swap Choice

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.

What swap covers Choice

No further description in the app.

Video memory Choice

No further description in the app.

Sound

Audio

Applies the next time a game starts.

Keep other apps' sound playing Toggle

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.

Game volume EngineChoice

No further description in the app.

Sound fixes

For crackling, or sound that does not come back. Most people never change these.

Audio buffer Choice

Extra buffered sound, in milliseconds. Bigger means fewer crackles but effects lag a little more. Applies on the next game start.

Bring sound back after a call EngineChoice

No further description in the app.

Connection

How JIT is switched on

JIT lets the emulator run at full speed. It has to be switched on every time a game starts.

JIT method Choice

No further description in the app.

Pairing file

Get a pairing file on this device Action

No further description in the app.

Troubleshooting

If Play says the tunnel will not connect.

Reset the tunnel Action

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.

Status

Enable JIT Action

No further description in the app.

Turn the tunnel off Action

No further description in the app.

Turn the tunnel on Action

No further description in the app.

Connection Extras

Connection to this device

The JIT helper reaches this device through a private connection. Porthole can make its own, or you can use LocalDevVPN; you only need one.

Use LocalDevVPN instead Toggle

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.

Your own VPN

iOS runs one VPN at a time, so yours is paused while JIT is switched on.

Ask before pausing it Toggle

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.

Shortcut to turn it back on TextField

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.

Turn it back on as soon as JIT is on Toggle

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.

Make the shortcut Action

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.

Cellular data

The private connection does not work while cellular data is the network in use.

Switch cellular data off when needed Toggle

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.

Add the two shortcuts Action

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.

Test the shortcuts Action

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.

Steam Settings

Account

Open your Steam library Action

No further description in the app.

Sign out Action

No further description in the app.

Sign in to Steam Action

No further description in the app.

Steam Big Picture

Valve's own gamepad interface, running inside Porthole. An experiment: Madeira leaves it out of its releases because it is heavy and not finished.

Start Steam Big Picture Action

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.

Steam client

Valve's own files, which start Steam games and check your licence.

Steam client Action

Valve's own client files start your Steam games and check your licence. About 73 MB from Valve; nothing else is installed.

Steam controller support Action

No further description in the app.

Downloads

Where Steam games are downloaded from.

Download region Choice

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.

Starting games

How Steam signs in when a game starts.

Start from Steam's saved sign-in Toggle

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.

Steam Cloud

Your game saves on Steam's servers.

Download my cloud saves before a game starts Toggle

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.

Game storage

Where Steam games are saved.

Ask where each game goes Toggle

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.

New downloads go to the SSD Toggle

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.

Check the SSD connection Action

No further description in the app.

Test the drive's speed Action

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.

Select the library folder again Action

Renews access to the same folder (after iOS forgot it). Choosing a different folder does not bring these games back.

Use a different folder Action

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.

Choose an SSD library folder Action

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.

Steam games window

How Steam games are drawn on the screen.

Use Wine's desktop display Toggle

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.

Guides

Tutorials

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.

Mark every tutorial as not done Action

No further description in the app.

Tips

Short explanations that appear the first time you open a screen.

Show tips Toggle

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.

Show all tips again Action

Every screen explains itself again the next time you open it, and the next game you start shows its short tour.

Open a guide

Playing a game Action

The tour shown before your first game

About

About Porthole

Which version this is and what it is made of.

Licences and credits Action

Free software, GPL-3.0-or-later, and who it is built on

Experiments

Not listed anywhere else.

Show Steam Big Picture Toggle

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.

Resolution Choice Row

Resolution Choice

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.

Auto Landscape Row

Turn to landscape when a game starts Toggle

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.

Power Mode Choice Row

Power mode Choice

…. 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.

Storage

Temporary files

Clear temporary files Action

No further description in the app.

Store Account Groups

Account

Open the … library Action

No further description in the app.

Sign out of … Action

No further description in the app.

Sign in to … Action

No further description in the app.

Library

Refresh the list Action

No further description in the app.

Gog Store Settings

Game services

What GOG's own client does while a game runs.

GOG Galaxy services Toggle

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.

A game's own page

Change Program

Somewhere else

Program TextField

No further description in the app.

Game Binds

Binds and layouts

Bind set in use Choice

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.

New bind set Action

Starts from this game's current controller settings

Import from a file… Action

.portholebinds

Community

Shared binds for this game Action

Binds and touch layouts other people shared; rate them and add the ones you like

Bind Set Editor

About this set

Name TextField

No further description in the app.

Notes TextField

No further description in the app.

Use this set Toggle

Only one set is used at a time. Applies the next time the game starts.

This set

Export to a file Action

.portholebinds, to keep or send

Duplicate Action

No further description in the app.

Delete this set Action

No further description in the app.

Controller

Include controller binds Toggle

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.

Right stick up and down speed Slider

No further description in the app.

Touch controls

Include a touch layout Toggle

With this on, using the set replaces the on-screen controls with this layout. Off keeps the default controls (Settings > Controls).

Edit the layout Action

… control\(t.controls.count == 1 ?

Start over from a layout… Action

Universal, Gamepad, Action, Point and click, Platformer or an empty screen

In Game Binds

Controller

Controller as keyboard and mouse Toggle

Left stick W A S D, right stick the mouse, buttons as keys. Off goes back to Automatic. Applies at once.

Controller buttons Action

No further description in the app.

In use

Bind set in use Choice

No further description in the app.

New bind set from the current controls Action

No further description in the app.

Edit this set Action

Controller binds and the touch layout

Edit the on-screen controls on the game Action

Move and change controls while you look at the game, and test them

Make on-screen controls on the game Action

Starts a new set with its own layout

Game Engine

Compatibility

AVX and AVX2 Override

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.

Upscaling (MetalFX) Override

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.

Upscaling method Override

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.

Upscaler sharpness Override

1 is the softest, 5 the sharpest (and can look over-processed).

Lossless Scaling frame generation Override

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.

Frames added between two Override

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.

CPU cores reported Override

How many processor cores this game is told about. Some games size their worker threads from it.

Direct3D 9 anisotropic filtering Override

Limits (or raises) texture filtering quality for Direct3D 9 games. The game's own setting is used by default.

Reduced-precision x87 Override

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.

Graphics card the game sees Override

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.

Large memory reservations Override

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.

Graphics route (Vulkan, experimental)

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.

Direct3D 10/11 runtime Override

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.

Direct3D 12 runtime Override

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.

Vulkan library Override

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.

Keyboard and mouse

Mouse speed Override

How fast the mouse turns this game's camera. 1× sends the mouse's own movement unchanged. Applies at once.

Always use the mouse to look Override

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.

On-screen controller

For a game that needs a controller on a device that has none.

Show a game controller on the screen Toggle

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.

Layout Choice

No further description in the app.

Controller type Choice

No further description in the app.

Controller

Controller as keyboard and mouse Toggle

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.

Controller Override

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.

Controller buttons Action

No further description in the app.

Remap buttons Action

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.

Right stick up and down speed Slider

How fast the mouse moves up and down compared with left and right. Many games turn the view at different speeds in each direction.

Starting

Working folder TextField

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.

This game's engine lines Action

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.

Share this game's setup

Share this game's setup Action

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.

Copy this setup as text Action

One line to paste into a message

Apply a shared setup Action

From a file or the clipboard

Home Screen shortcut

Copy this game's shortcut link Action

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.

Reset this game's engine settings Action

No further description in the app.

Pad Binds

Change one by pressing it

Press the button, or push the stick, now… Action

Tap here to cancel

Press a controller button to change it Action

No further description in the app.

Buttons

Back to the standard layout Action

No further description in the app.

… does Choice

No further description in the app.

Game

Set up

Controls and key binds Action

No further description in the app.

More options Action

Speed, memory, engine and launch options

From Steam

News and patch notes Action

From Steam

Achievements Action

No further description in the app.

Friends playing Action

No further description in the app.

Workshop Action

No further description in the app.

Reports

How it runs for others Action

No further description in the app.

Report a problem Action

Send the log of a run that went wrong

Manage

About and files Action

No further description in the app.

Play

Start Choice

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.

Steam sign-in Override

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.

Resolution Override

The size of the screen this game sees. Default follows Settings > Display. Applies the next time the game starts.

Orientation Override

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.

Power mode Override

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.

Reset this game to the app-wide settings Action

No further description in the app.

One-time installs

One-time installs Choice

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.

Run them all again Action

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.

Memory

Swap Override

No further description in the app.

Swap covers Override

No further description in the app.

Video memory Override

No further description in the app.

Speed

Keep mode when hot Override

No further description in the app.

Audio buffer Override

No further description in the app.

Precise shader math Override

No further description in the app.

Wine desktop display Override

No further description in the app.

On-screen controls

Use my default controls Action

Back to …, as set in Settings > Controls. Your saved binds for this game are kept.

Look sensitivity Slider

No further description in the app.

Use the app-wide look sensitivity Action

No further description in the app.

How it runs

See reports Action

No further description in the app.

Launch

Launch options TextField

Extra command-line options for the program, separated by spaces.

Show Windows windows Toggle

Draws ordinary Windows windows, like launchers and installers. Games that draw their own picture don't need it.

About this game

Program Action

Pick another program from this game's folder to start. The game stays in your library with its Steam link, settings and play time.

Files

Verify and update files Action

No further description in the app.

Delete downloaded files Action

No further description in the app.

Remove from library Action

No further description in the app.

Last Run Card

Last time

Looks like: Action

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.

Pad Assist

Gyro aim

Gyro aim Toggle

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.

Gyro from Choice

No further description in the app.

Active Choice

No further description in the app.

Moves Choice

No further description in the app.

Turn with Choice

No further description in the app.

Sensitivity Slider

No further description in the app.

Anti-dead zone Slider

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.

Invert up and down Toggle

No further description in the app.

Invert left and right Toggle

No further description in the app.

Turbo

Turbo … Toggle

No further description in the app.

Presses a second Slider

No further description in the app.

Pad Remap

Change one by pressing it

Press the button now… Action

Tap here to cancel

Press a controller button to change it Action

No further description in the app.

Quick changes

Swap A and B Action

Confirm and cancel the other way round

Swap X and Y Action

No further description in the app.

Swap the triggers with the bumpers Action

\(padKind.glyph(

Back to the standard buttons Action

No further description in the app.

Shared Binds Browser

Sort by Choice

No further description in the app.

Shared Bind Detail

Reviews

Rate it Action

Thumbs up or down, and an optional comment

Report this set Action

If it is spam or not what it says. Several reports hide it.

Shared Bind Review

Did it work for you? Choice

No further description in the app.

Comment TextField

No further description in the app.

Bind Set Sharing

Community

Update the shared copy Action

Sends this version. Changed text waits for approval again.

Stop sharing Action

No further description in the app.

Share this set Action

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.

Tested Setup

Use this setup Action

No further description in the app.

Undo \(mine == nil ? Action

Puts this game’s engine lines and settings back as they were

Reports

Report

Did it crash?

Crashes Choice

No further description in the app.

Where did the game come from?

Files from Choice

Different stores can ship different builds of the same game, so this matters. Pick from the list.

What to include

Include what the app measured Toggle

No further description in the app.

Share my settings for this game Toggle

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.

Your note

Optional note TextField

A person checks notes before they appear, so yours won't show straight away. Please don't mention where to get game files.

Game Reports Layout

Reports

Show more Action

No further description in the app.

Reports

Try again Action

No further description in the app.

Compat Game

Try again Action

No further description in the app.

Steam

Steam Achievements Content

Try again Action

No further description in the app.

Steam Cloud Card

Saves

Steam Cloud Action

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.

Steam Cloud Content

Steam Cloud

Compares …’s saves on this device with the ones in Steam Cloud. Nothing here runs by itself.

Check again Action

Compare this device with Steam

Steam Game

About this game

Read the full description Action

No further description in the app.

Explore

How it runs on Porthole Action

No further description in the app.

Steam reviews Action

… · …%

News and patch notes Action

From Steam

Version and DLC Action

No further description in the app.

Achievements Action

No further description in the app.

Workshop Action

Mods and community items

Details and files Action

No further description in the app.

Files and links

Open on Steam Action

No further description in the app.

Delete downloaded files Action

No further description in the app.

On Porthole

See reports Action

What other players say about running this game here, by device, with the settings that worked.

Write a report Action

No further description in the app.

System requirements

Minimum Action

No further description in the app.

Recommended Action

No further description in the app.

Steam Versions Content

Try again Action

No further description in the app.

Version

Beta password TextField

Some games have private betas. A code from the developer, typed here, opens the beta it belongs to.

Steam Sign In

Steam Guard code TextField

No further description in the app.

Submit code Action

No further description in the app.

Account name TextField

No further description in the app.

Password TextField

No further description in the app.

Steam Owned List

Steam client Action

Valve's own client files start your Steam games and check your licence. About 73 MB from Valve; nothing else is installed.

Steam controller support Action

No further description in the app.

Steam Workshop Content

Show Choice

No further description in the app.

Order Choice

No further description in the app.

Search TextField

No further description in the app.

Try again Action

No further description in the app.

Subscribed

Update mods automatically Toggle

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.

Download missing and updated items Action

No further description in the app.

Stores

Epic Game

About this game

Read the full description Action

No further description in the app.

How it runs on Porthole Action

No further description in the app.

Details and files Action

No further description in the app.

Files and links

Find on the Epic Games Store Action

No further description in the app.

Write a report Action

No further description in the app.

Delete downloaded files Action

No further description in the app.

Library

Steam Picker

Game name TextField

No further description in the app.

Pick the match

No artwork Action

No further description in the app.

Other screens

Add Game Flow

How do you want to add it?

Import a game folder Action

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.

Download from Steam Action

Games you own on Steam, installed straight into the app.

Download from Epic Games Action

Games you own on Epic Games, installed straight into the app. You sign in on Epic's own page.

Download from GOG Action

Games you own on GOG, installed straight into the app. You sign in on GOG's own page.

Download from itch.io Action

Games you bought, claimed or collected on itch.io, installed straight into the app. You sign in with your own API key.

Download from Amazon Games Action

Games you bought on Amazon or claimed with Prime Gaming, installed straight into the app. You sign in on Amazon's own page.

Download from the EA app Action

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.

Run a Windows installer Action

For games from a disc or a setup file you already have. Pick the setup file, run it, then add what it installed.

Already in the app

Search TextField

No further description in the app.

Add by path Action

No further description in the app.

Program TextField

No further description in the app.

Program Chooser

Not the right one?

Search TextField

No further description in the app.

Show installers and tools (…) Toggle

No further description in the app.

Lossless Scaling

Your copy

Needs Lossless Scaling on your own Steam account. Porthole never ships it and takes it from Steam only.

Sign in to Steam Action

In Stores > Steam

Check my Steam purchase Action

Asks Steam whether this account has an active licence

Download from Steam Action

Only the one file is kept, sealed

Remove from this device Action

Deletes the sealed file and the proof

Pair On Device

Troubleshooting

Show details Toggle

No further description in the app.

Copy Action

No further description in the app.

Setup Look Choices

Festive

Festive themes Toggle

Porthole dresses up for some holidays by the date. Turn this off to keep your own colours all year.

Sound

Applies the next time a game starts.

Game volume EngineChoice

No further description in the app.

Keep other apps' sound playing Toggle

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.

Setup Helper Choices

When a game stops

Porthole reads the game's own log on this device. By default it only suggests a change and waits for your yes.

Look for known problems Toggle

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.

Ask me before changing a game Toggle

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.

Back up saves after each game Toggle

When a game ends, your saves and settings are zipped into Files > Porthole > Saves backups. The newest five are kept.

Compatibility reports

Reports carry a random key kept on this device, never your name. Nothing is sent unless you choose to send it.

Show compatibility badges Toggle

Small marks on games that show how they ran for other people.

Ask me how a game ran Toggle

After a game you can send a short report. It takes under a minute.

Setup Guide

Just the essentials Action

Skip the choices and get ready to play; every one of them is in Settings

Create it on this device Action

About a minute, no computer

I already have a pairing file Action

No further description in the app.

Choose the pairing file Action

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.

Replace the pairing file Action

No further description in the app.

Check again Action

No further description in the app.

Use a different method Action

No further description in the app.

Connection to your device

Turn LocalDevVPN on before you press Play and leave it on while the game runs.

Use Porthole's own private link instead Action

Needs one permission from iOS

Use LocalDevVPN Action

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.

Files

Import a game Action

Pick a game's folder in Files and it is copied into Porthole, or run a Windows installer.

Learn the app

Show me around Action

A short tour that points at the real buttons. More tutorials are in Settings.

Your choices

Tap one to change it. All of them are in Settings too.

Controls Action

No further description in the app.

Colours and sound Action

No further description in the app.

Picture and power Action

No further description in the app.

Helpers Action

No further description in the app.

Software Detail

Found something else?

Report a problem Action

Send what happened, with the log, from Settings

VCRedist32

32-bit programs (optional)

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.

Download Action

About … MB, from Microsoft

Remove the downloaded copy Action

No further description in the app.

VCRuntime

Download Action

About 25 MB, from Microsoft

Remove the downloaded copy Action

No further description in the app.

Wine Gecko

Web pages in programs (optional)

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.

Download Action

About 110 MB, from WineHQ

Remove the downloaded copy Action

No further description in the app.

Wine Mono

.NET (optional)

Only for games built on Microsoft's .NET Framework, such as Celeste. You can also download it later in Settings › Advanced › Windows components.

Download Action

About 42 MB, from WineHQ

Remove the downloaded copy Action

No further description in the app.