User guide

How to use PersonalConsole, screen by screen. New here? Download it and Octopad, the setup guide, walks you through the basics on the first start. For installation questions see the FAQ, and for what changed in each version, the release notes.

1. What this is

PersonalConsole turns a Windows PC into something you can drive from the couch with a game controller. It does three things:

  • Translates your controller into keyboard and mouse input, per application, so a program that never supported a pad can still be driven by one.
  • Replaces the Windows desktop with a full-screen, controller-friendly one.
  • Gives you a Virtual Keyboard, radial menus and a file browser you can use without a mouse.

2. The main window

The left sidebar is the whole app. Five sections:

SectionWhat it is for
Profiles & TemplatesWhich controller setup applies to which program
Controller MappingWhat each button does
Virtual KeyboardThe Virtual Keyboard's look, languages, dictionaries and saved sign-ins
Console ModeThe full-screen desktop, its tabs, and the built-in file browser
PreferencesStartup, controller detection, appearance, themes, updates

At the bottom: one button for Minimize and Exit. Holding it fills the button twice: first in the theme colour, then in red.

HowWhat happens
Click it, or press Enter / Space on itMinimize
Controller: tap BBack to the section list, as before
Hold (mouse, keys or B) until the theme-colour fill is full, then let goMinimize. Letting go any time while the red fill runs also minimizes
Keep holding until the red fill is fullThe button reads Exit; the app exits when you let go

LB / RB and the D-Pad do not move onto this button; on the controller it is always B. B does the above only when nothing else is open. With a menu, a pop-up or a slider open, B closes that first.

When a newer version is available, a dot appears beside Preferences, on its Update tab and on the Console Desktop's App Settings button. The dots stay until you install the update; opening the Update tab does not clear them.

Minimize puts the window away and leaves the app running — the controller keeps working. Where it goes depends on one setting:

System Tray Behavior (Preferences → System)What Minimize does
Off (default)An ordinary minimised window on the taskbar
OnThe window is hidden entirely and only the tray icon is left

Either way the tray icon brings it back.

The top-left corner shows the profile you are editing: its icon and its name (a long name wraps onto up to four lines; anything longer ends in "…"). Clicking the octopus behind it opens Octopad, the setup guide (section 3).

Getting around with the controller: LB / RB change section — a thin rail beside the section list runs from LB at the top to RB at the bottom, and a lit mark on it sits beside the section you are in. LT / RT change the tab inside a section, and they are drawn at the two ends of the tab strip itself. Both sets of marks appear only while you are using the controller. Opening Profiles & Templates puts you straight on the profile you are editing in the list. Mouse and keyboard work everywhere too.

3. Profiles

A profile is a full set of button mappings plus the program it belongs to. PersonalConsole switches profiles by itself: when a program you have a profile for comes to the foreground, its mappings take over. If a program has no profile, the Desktop profile applies.

Every row in the list carries a round icon on its left. Desktop and Virtual Keyboard have marks of their own and sit above a divider, so the two built-in profiles read as a group. Every other profile shows the icon of the program it is for, taken from the first program listed for it. PersonalConsole looks the program up where Windows records it and among your shortcuts, so it does not have to be running; a program it cannot place shows a controller mark until it is seen once.

You can also choose the icon yourself. In Profile Options → Profile Icon, Choose Icon takes any program, .ico or picture and uses it for that profile — useful when two programs share an executable name, or when you simply prefer a different mark. Use Automatic puts it back. Your choice applies to the built-in profiles too.

Screenshot: main/profiles.png

The two built-in profiles

Two profiles always exist and are pinned to the top of the list. They are not examples you can replace — the app relies on them, which is why neither can be renamed or deleted.

Desktop

The fallback. It applies whenever nothing more specific does — you are on the Windows desktop, or in a program that has no profile of its own. This is the profile to set up first, because it is the one you will spend most of your time in: it is where you want the sticks driving the mouse, a button opening the Virtual Keyboard, and so on.

It is also the profile the app forces in three situations:

  • Emergency Desktop Mode — the combination from that tab drops you back here from anywhere, which is the whole point of it (section 3, Emergency Desktop Mode).
  • While a file picker or other system dialog opened by PersonalConsole is on screen — that dialog belongs to the app rather than to your game, so no game profile could sensibly apply. Desktop keeps the pad driving the mouse and buttons inside it.
  • When a program's name cannot be read — an elevated process, for example. Rather than guess, the app falls back here and notes it in the log.

Virtual Keyboard

Active whenever a Virtual Keyboard is open, whatever is in the foreground. It outranks every other profile, including the one for the game you are playing.

That is deliberate: while you are typing, the pad has to drive the keyboard, not the game underneath. Without it, the same stick would move a cursor and a character at once. The profile is what makes the keys, the prediction row and the close button reachable.

Map here anything you want available while typing — closing the keyboard, switching language, moving the caret. Bindings you put in a game's own profile are not in effect during that time.

📌 So the order of precedence is: Virtual Keyboard open → its profile · a system dialog or the emergency combo → Desktop · otherwise → the profile matching the foreground program · nothing matches → Desktop.

Octopad — the Setup Guide

The octopus in the top-left corner of the main window is Octopad, an old master of the console. On a fresh installation it talks you through setting up, because the Desktop profile starts empty. Its lines type out in a box at the bottom of the window; when it asks something, the choices appear above the box, and while it explains something a drawing shows the part it is talking about — the controller, the Virtual Keyboard, Controller Mapping, the Console Desktop, profiles, radial menus or themes.

Lessons, and a menu inside each. Octopad teaches in seven lessons. Picking a lesson opens its own menu: one row for each topic it can explain, and Change Settings for the choices that lesson offers. A topic only explains; Change Settings only asks. When either is done, the lesson's menu comes back, so you hear only what you picked.

LessonTopicsChange Settings
Desktop ControlsHow It Works · Changing a ButtonStandard (left stick mouse, right stick scroll, A left click, B right click), Shoulder Clicks (same sticks, RB left click, RT right click) or Right-Stick Mouse (right stick mouse, left stick scroll, RT left click, LT right click)
Virtual KeyboardTwo Keyboards (Realtime and Buffer) · Which One, When · On a Button (each button picks its own keyboard) · While Typing (suggestions, languages, Typing Input Lock)The controls while a keyboard is open: Standard (left stick moves between keys, right stick moves the text cursor), D-Pad Typing (D-Pad moves between keys) or Simple (left stick, A press, B close); then the look: Standard, Compact, Large or See-Through (each sets the size, corner roundness and background opacity of Keyboard Appearance) or Keep Current; then the languages: A turns one on or off, Done moves on. The keyboard steps through them in the order shown and opens with the first; one always stays on
Console DesktopThe Top Bar · Tabs and Shortcuts · Open Programs · Power Button · When It ShowsTurn It On / Not Now (or Keep It On / Turn It Off when it is already on), the icon size (Small 64 px, Medium 96 px, Large 128 px, Huge 192 px or Keep Current), the background (Solid 100%, Shaded 70%, Glass 40%, Clear 10% opacity or Keep Current), one switch each for Auto Hide/Show on Input, Auto File Explorer (only while Auto Hide/Show is on), Show Hidden Items, Show Shortcut Names, 24-Hour Clock and Show Date With The Clock. Last, Create a Tab names a new tab for you, and Edit My Tabs renames a tab or moves it along the strip (deleting stays in Console Mode → Tabs, where it is a hold)
Profiles for ProgramsHow Profiles Work · Making One—
Radial MenusWhat They Are · Building One · Menu Settings · Putting One on a Button—
Community FilesWhat People Share · Bringing Them In— (the menu has Open Community Files, which opens the site in your browser)
ThemeWhat a Theme ChangesPick a theme; it applies to the main window, the Virtual Keyboard and the Console Desktop at once. The theme in use is where the cursor starts

The switches are the same ones as in Console Mode → Shell: changing one here changes it there. Picking Desktop or Virtual Keyboard controls replaces that profile's buttons and stick settings; everything can be changed afterwards in Controller Mapping.

Changing something you already have takes a hold. A choice that would change a current setting is marked Hold: keep A down — or the mouse button, or Enter / Space — for two seconds while the card fills. Octopad then asks Are you sure? and says what will change (for example the icon size changes from 96 px to 128 px). The cursor starts on No, Keep Mine; only Yes, Change It makes the change, and B counts as No. Either way you are back on the same line, on the same choice. Letting go early does nothing. Choices that change nothing — Keep Current, the theme in use, the first layout on an empty profile, Continue, Done — work with a plain press.

On a fresh installation it starts by asking your name and opening the Virtual Keyboard for three seconds — then admits it was a joke, since nothing is set up yet — and then shows the lessons. ⚠️ Two lessons are marked Required: Desktop Controls and Virtual Keyboard. Open each and pick its controls under Change Settings. Until both are picked, That's All, B on the lessons and Esc do not close the guide; Octopad says which are left. The other lessons can wait for another day.

To talk to Octopad again, click the octopus in the top-left corner — or, with the controller, press Up at the top of the section list and then A. The lessons come up the same way, and the control choices also offer Keep Current. That's All ends the conversation.

  • Controller: A finishes the line being typed, or moves on to the next one. Up / Down move between choices and A picks (hold it on a choice marked Hold). B goes back one step: a line back inside a topic; from a topic's first line, or from a lesson's menu, one level up; on the lessons, it ends the conversation. On a text box, A opens the Virtual Keyboard. Y turns Octopad's voice on or off.
  • Mouse / keyboard: click anywhere to move on, click a choice to pick it. A lesson's menu also has ‹ All Lessons. Enter or Space moves on, Backspace goes back, Esc closes the guide. Voice On / Voice Off at the bottom of the box, or V, turns the voice on or off.

While a line types out, Octopad mumbles along in a voice of its own. The setting is remembered.

Creating one

  1. Open Profiles & Templates → Profile.
  2. Press + Add Profile under the list.
  3. Set Target Executable (.exe) — Browse .exe to pick the program, or Recent Apps to choose one you have used recently.
  4. Optionally set Controller if the profile should only apply to one specific pad. The default, Any controller, applies to whichever pad is connected. Screenshot: main/profiles__devices-expanded.png ⚠️ A profile tied to one pad does not run at all while that pad is unplugged — no bindings, no Realtime keyboard. The row says so when that happens. Screenshot: main/profiles__device-pin-unsatisfied.png 🔑 Switching a pad between its XInput and DInput modes changes the identity Windows reports, so a profile tied to it in one mode will not match in the other. Any controller avoids this entirely.

The line under the box — "Activates automatically while the target window is in the foreground" — is the whole rule.

Editing and deleting

Pick a profile's card: the Profile Options panel beside the list follows it, with Profile Name, Rename Profile and Delete Profile. Screenshot: main/profiles__popup-profileoptions.png

⚠️ Built-in profiles (Desktop, Virtual Keyboard) cannot be renamed or deleted. The panel says so. ⚠️ Every profile needs its own name. Rename Profile refuses the name of another profile (capital letters make no difference) and the names Desktop and Virtual Keyboard, and says why. + Add Profile picks a free name for you — New Profile, New Profile 2, and so on. ⚠️ Deleting a profile is permanent, and it is a hold button — keep it pressed until the bar fills. Letting go early cancels, which is the point.

Emergency Desktop Mode

Screenshot: main/profiles-emergency.png

If a game's mapping ever leaves you stuck, this combination force-switches back to the Desktop profile system-wide. Two dropdowns: the combination itself and how long it must be held. Set them to something no game will use by accident.

Templates

Screenshot: main/profiles-templates.png

Export Template writes your mappings to a file; Import Template loads one. Five toggles pick what is taken from it — Target EXEs, Button layout, Radial menus, Combinations and Analog settings — so you can move only the parts you want to another PC.

Each template is one file named after it. A name that would end up in the same file as an existing template — one that differs only in capital letters, or only in a character a file name cannot hold, such as / — is refused, and so is a name that cannot be a file name at all (very long, or a name Windows reserves such as CON). Exporting under a template's exact name updates that template.

What each toggle does to the profile you are editing:

ToggleEffect
Target EXEsAdded to the profile's list; programs already there are kept
Button layout⚠️ Replaces every button binding in the profile with the template's — bindings the template does not have are removed
Radial menusAdded; a menu you already have is skipped, and one with the same name comes in under a new name
CombinationsAdded; a combination on the same buttons as one you already have is skipped, so yours is kept
Analog settingsReplaces the stick and D-Pad setup — a stick has one mode at a time, so there is nothing to merge

Analog settings covers what each stick and the D-Pad do (Mouse, WASD, Scroll, Arrows, Click to Move) together with their sensitivity, acceleration and acceleration time, the deadzone, and Click to Move's Move With and Circle Size.

⚠️ An import cannot be undone. To keep a profile's own buttons, leave Button layout off.

A toggle comes up greyed when the selected template carries nothing of that kind. Templates exported before a part existed simply have none of it — that is why Analog settings is unavailable on an older template, and why importing one cannot overwrite the analog settings you have now.

A new installation arrives with two templates already here — Desktop and Virtual Keyboard, copies of the two built-in profiles — so there is a working arrangement to start from. They are placed only when there are no templates of your own, so an update never replaces yours.

When OneDrive keeps an extra copy of a template because two computers changed it at the same time (Desktop-OTHERPC.json beside Desktop.json), PersonalConsole moves that copy into a Conflicts folder inside the Templates folder, so each template is listed once. Nothing is deleted.

More templates are shared at https://www.pcpersonalconsole.com/communityfiles. Download a .json from there and load it with Import Template.

4. Mapping a button

Open Controller Mapping. The tab strip selects which part of the pad you are working on: Device Layout, Actions, Menu, D-Pad, Bumpers & Triggers, Left Stick, Right Stick, Combos.

Device Layout is a picture of your controller with every binding drawn next to the button it belongs to — the fastest way to see what is already assigned. Assigned buttons stay highlighted. Screenshot: main/mapping-device-layout.png

The steps

  1. Select the button — on Device Layout, or from one of the other tabs.
  2. The editor opens full screen. Its top-left corner names exactly what you are editing, from top to bottom: the profile (with its icon), the layout, and the button's own glyph. Screenshot: mapping/single-tap__fullscreen.png The right side has two tabs: Button (turbo, rumble) and Mapping (the action). LT / RT switch between them.
  3. Pick the slot on the left — Single Tap, Double Tap, Hold, Release. One button can carry a different action in each of the four.
  4. Pick a category, then the action inside it.
  5. Press B (Apply & Close), or Esc.

The categories

CategoryWhat you get
Keyboard KeyA full QWERTY picker, plus Win / Alt modifier keys
Mouse ControlClicks, scroll and movement
Virtual KeyboardOpen the Realtime or Buffer keyboard, or Close Keyboard
Radial MenuOpen one of your menus
LayoutsSwitch to another layout, with Hold / Toggle / One-Way
Windows ActionsClose App (Alt+F4), Show Desktop (Win+D), Show Console Desktop, Task Manager, Window Switcher, plus Shell and Media groups
Open FileStart a program, open a file, or open a folder — whichever you pick

One slot can hold more than one thing at once — a keyboard key and a mouse click assigned to the same slot are sent together on the same press.

Timing the keys on one button

Press a key you have already assigned and a small panel opens for it, with a note grid at the top. Every key on that button gets its own lane, time runs left to right, and each bar shows when that key goes down and how long it stays down.

Bars that all start at the left go out at the same moment — that is a chord like Ctrl+C, and it is what a button does until you change something. Slide a bar to the right and that key now happens later. There is no mode to pick: the bars are the answer.

Because a bar has a length as well as a position, one key can stay down while others happen inside it — hold Shift for half a second and tap A twice in the middle of it, for example.

  • With a controller: ◀ ▶ moves the selected bar earlier or later, ▲ ▼ picks a bar, and A switches ◀ ▶ over to changing the bar's length instead. Pressing ▼ on the last bar leaves the grid.
  • With a mouse: drag a bar to move it, and use the scroll wheel over a lane to make that bar shorter or longer.

−500 ms / −100 ms / +100 ms / +500 ms under the grid change how much time it shows — they never move a key. Widening it is how you make room to push something further out, and because a bar's width is a real duration, the same key simply draws narrower as the window grows. The ruler along the top is in milliseconds, so what you see is what will be sent.

The rest of that panel is per key: Sync with Gamepad holds the key for exactly as long as you hold the button, Fixed Duration sends it for a set time however briefly you press, and Remove Assignment takes that one key off the button — its lane goes with it.

Opening a program or file from a button

Screenshot: mapping/hold__open-file.png

Open File asks you to choose, and then that button opens it. There are three ways to pick: Choose a program… (executables and shortcuts), Choose any file… (a document, a picture, a save file — it opens in whatever program normally handles it), and Choose a folder…. Remove takes the assignment off again.

All three open in this app's own File Explorer, which you can drive with the controller, as long as Choose Files With The Built-in File Explorer is on in Settings → Console Mode → File Explorer. Turn it off and they use the Windows dialogs instead. (Its neighbour, Open Folders In The Built-in File Explorer, is a different question: that one decides where a folder opens once you already have it — including from the Console Desktop.) When you are choosing a file, A picks the one you are on and anything the button cannot use is drawn faint. When you are choosing a folder, A still opens folders so you can find the right one, and X chooses whichever folder you are looking at.

The panel shows the full path so you can tell two identically named programs apart, and it tells you when what you picked is not on the machine right now — an unplugged drive, for example. That is a notice, not a reset: the assignment is kept, so it works again as soon as the path is back.

🔑 It opens once per press. Holding the button down does not open it over and over, and turbo does not apply to it.

Slot-specific controls

  • Double Tap adds a Double Tap Speed slider — how fast the second press must come. ⚠️ A double tap also sends the Single Tap action: the first press has already gone out by the time the second one arrives. Leave Single Tap empty if you want the double tap on its own. Screenshot: mapping/double-tap.png
  • Hold adds a Hold Threshold slider — how long the button must be held. Screenshot: mapping/hold.png
  • Release is the plainest slot: it fires when you let go. Screenshot: mapping/release.png

Clearing

The Clear button at the bottom names the slot it will clear — Clear Single Tap — so it can only affect the slot you are looking at.

Turbo and rumble

On the editor's Button tab:

  • Enable Turbo (Repeat) auto-repeats while held. Repeat Delay sets the rate and Enable Acceleration speeds it up the longer you hold.
  • Enable Rumble vibrates when the button fires: Single, Ascending or Descending. ⚠️ It needs a controller running in its XInput mode. A pad read directly (DirectInput) cannot be driven at all — Windows reports no motors for it — and Preferences → Controller says so while such a pad is in use.

Sticks and the D-Pad

Under the Device Layout picture, three dropdowns set what the sticks and D-Pad do as a whole: None, Mouse, WASD, Scroll, Arrows or Click to Move. The gear button beside each opens its detailed settings (sensitivity, deadzone, acceleration).

Click to Move is for games where the character walks toward the mouse while a button is held, such as action role-playing games seen from above. Pushing the stick places the mouse around the middle of the game window, in the direction you push and farther out the more you push, and holds the button, so the character walks that way and turns as you turn the stick. Let go and the button is released and the mouse returns to the middle. Its settings are on the Left Stick, Right Stick or D-Pad tab while the mode is selected:

SettingWhat it sets
Move WithThe button held while the stick is pushed: Left Click (the default), Right Click, Middle Click, a keyboard key, or None — the stick only moves the mouse and nothing is held
Circle SizeHow far from the middle the mouse can go, as a share of the game window's height (5–50%, default 25%)
Centre XMoves the circle's centre right (+) or left (−), as a share of the window's width (−40 to +40%, default 0) — for a game whose character is not in the middle of the screen
Centre YMoves the centre up (+) or down (−), as a share of the window's height (−40 to +40%, default 0)
Inner CircleHow close to the centre the mouse may come, as a share of the circle (0–90%, default 30%). A click right on the character attacks or talks to it instead of walking
Circle WidthStretches the circle sideways into an oval (50–200%, default 100% = a circle). Above 100% the walk to the sides is longer than up and down, which suits games seen from an angle

These settings are shared: every stick set to Click to Move uses the same ones.

While you change one of the five circle settings, the circle is drawn over the screen — the outer edge, the inner circle (dashed) and the centre — and follows the slider. With the controller it appears when you press A on the slider and goes when you press B; with the mouse, while you click or drag the slider. Selecting a slider without changing it does not show it. It is drawn on the screen the app is on, as a full-screen game would fill it.

Acceleration and Acceleration Time — the stick's own, the same two the Mouse mode uses — work here too, as distance: when you push the stick the mouse starts nearer the centre (the part beyond the inner circle at 1 ÷ Acceleration) and opens out to the full distance over the Acceleration Time. 1.0x (or a time of 0) goes out at once. Mouse Sensitivity is hidden in this mode: the stick sets a position, not a speed.

⚠️ When a stick or the D-Pad is set to anything other than None, its four directions are taken over by that behaviour and show as locked in Device Layout — you cannot also bind them individually. Set it back to None and the bindings you had are still there. The stick click (L3 / R3) is not a direction and stays bindable either way.

Combos

Screenshot: main/mapping-combos.png — bind an action to two buttons pressed together. The tab starts empty until you add one.

5. Layouts

Each profile has eight layouts, numbered 1–8 on the strip at the top of Controller Mapping. A layout is a complete set of bindings, so one profile can hold eight control schemes.

You switch layouts at run time by binding the Layouts action to a button. It works in three ways:

ModeBehaviour
HoldThe layout applies only while the button is held
TogglePress to switch, press again to switch back
One-WaySwitch and stay

The editor always names the layout you are editing in its top-left corner. This matters more than it sounds: a binding placed on layout 3 does nothing while layout 1 is active, and that is the most common reason a new mapping "does not work".

The sticks and the D-pad follow the layout too. Each layout can have its own Input Mode (Mouse, Scroll, WASD, Click to Move…), sensitivity, acceleration, dead zone and Click to Move circle — for example the left stick moves the mouse on layout 1 and walks with Click to Move while you hold a layout button. Choose a layout on the strip and change the settings on the Left Stick, Right Stick or D-Pad tab:

  • On layout 1 you set the profile's own values, and every layout that has not been changed follows them.
  • On layouts 2–8 a change applies to that layout only. Same as Layout 1, next to the Input Mode, puts that stick back on layout 1's settings.

When a layout switch changes a stick's mode while you are pushing it, whatever the old mode was holding (a mouse button, W A S D, the arrow keys) is let go.

6. Radial menus

A radial menu is a wheel of actions you open with one button and pick from with the stick.

🔑 Menus are shared across profiles. The menu itself belongs to you, not to one program. What belongs to a profile is the binding — which button opens which menu. So a menu you build once is available everywhere, and you can open it from a different button in each game.

Open the editor with Open Radial Menu Editor at the bottom of Controller Mapping. Its top-left corner shows the profile (icon and name) and, under it, the menu you are editing. Screenshot: radial/menu-selected__fullscreen.png

Building one

  1. Press + Add Menu. It appears in the list on the left with its item count under the name.
  2. Set Menu Name at the top.
  3. Press + Add Button for each entry. Every entry has:
    • Button Name — what it is called
    • Colour and Symbol — how it looks on the wheel
    • Show as — symbol only, or symbol and text
    • Assign Action — what it does when picked
    • Delete — hold to remove the entry
  4. Use the ▲ / ▼ buttons at the start of a row to change the order entries appear on the wheel.
  5. Press B (Apply & Close).

Menu Settings ▼ expands in place for the menu's own options: Activation, Layout, Size and Opacity, and beside them Horizontal Position and Vertical Position — where the menu opens, as a shift from the middle of the screen (−40 to +40%; + is right and up). While you change one of these four sliders (A on the slider with the controller, until B; or clicking and dragging it with the mouse), the menu is drawn on the screen where it will open, at its size and opacity, and follows the slider.

⚠️ Delete Menu removes the whole menu and cannot be undone.

Opening one

Map a button to the Radial Menu category (section 4) and pick the menu. A menu entry can itself open another menu, so menus can nest. The submenu follows its own activation setting (in Menu Settings ▼). With Gesture Select, letting go of the button opens the submenu and it waits: hold the button again, point and let go to pick, or press A. B closes it.

LB / RB move between menus while the editor is open.

7. The Virtual Keyboard

There are exactly two Virtual Keyboards, and the difference is where your typing goes:

Realtime KeyboardBuffer Keyboard
Keys gostraight to whatever is focused, as you press theminto the keyboard's own text box first
The program underneathkeeps runningis held still while you type. When a game's profile opened the keyboard, only that game is held: if another program is in front, it keeps running
Text arrivesimmediatelywhen you close the keyboard
Use it fordesktop apps, browsers, chat - and every text box in this appgames that would react to the pad while you type

You open either one by mapping it to a button (section 4, Virtual Keyboard category: Open Realtime Keyboard or Open Buffer Keyboard). The same category has Close Keyboard, so you can bind a dedicated close button.

Choosing the keyboard for each program. Bindings belong to a profile, so the keyboard type does too: open a game's profile in Controller Mapping and give your keyboard button Open Buffer Keyboard there, while the Desktop profile keeps Open Realtime Keyboard on the same button. The same button then opens the right keyboard in each program. Each button chooses its own keyboard, and so does each of its four slots, so one profile can also have both — the Realtime Keyboard on one button and the Buffer Keyboard on another.

Text that is already in the field. When the field you open the Buffer Keyboard on already has text, the keyboard's text box starts with it, with a blinking cursor at the end, so you can edit it before sending:

  • A long text comes in as its last 200 characters or fewer, starting at a word. The part before it is not shown and is left as it is.
  • The text box starts after the last line break or emoji in the field. Only the text after it can be edited from the keyboard.
  • When you close the keyboard, the end of the field is replaced with what the text box holds. Adding to the end deletes nothing.
  • Some programs do not report their text field to Windows; many games draw their own chat box. There the keyboard copies the field instead: it presses Ctrl+A and Ctrl+C in the program, reads the copy, then puts your clipboard back. If the copy comes back as several lines, it is ignored, because a chat line is one line. In some games, for example, Ctrl+C copies the item under the cursor.
  • Password fields and fields you cannot edit are never read. When nothing can be read, the text box starts empty. Your text is then typed where the field's cursor already is. Closing an empty text box leaves the field as it was.

Where it opens. The keyboard takes the top or the bottom of the screen, whichever leaves the place you are typing visible. It asks the program underneath where its text box is; when the program does not say — many games draw their own text fields and have nothing to report — it uses where your pointer was when you asked for the keyboard.

To decide it yourself, map the Change Keyboard Position action to a button (section 4, Virtual Keyboard category). Each press moves the keyboard to the other half of the screen and remembers it; pressing it while the keyboard is closed chooses the half the next one opens in. Use it in a game that draws its own interface: there is nothing there for the automatic placement to read, and you already know which half your chat box is in.

The prediction row — four buttons

Screenshot: mapping/single-tap__virtual-keyboard.png

Above the keys sit four buttons: three suggestions and one add-to-dictionary slot.

ButtonWhat it holds
1st (left)Second-best suggestion
2nd (middle)🔑 The best suggestion
3rd (right)Third-best suggestion
4th+ "word" — adds what you typed to your dictionary

🔑 The best match is the MIDDLE button, not the first. The three suggestion slots fill centre-out — best to the middle, then left, then right — the way phone keyboards do it, because the middle is where your thumb already is.

The 4th button is separate on purpose: adding an unknown word used to consume the third suggestion, so you had to choose between a suggestion and teaching the keyboard. Now you get both. It appears only when what you typed is not already a known word, and it shows the word in quotes so you can see exactly what will be stored.

Suggestions keep your capitalisation. Type Wed and pick the suggestion and you get Wednesday, not wednesday. Only the part you actually typed is re-cased; the rest stays exactly as the dictionary has it, so words with capitals inside them — iPhone, eBay — survive being completed. Nothing is blanket-uppercased, which is also what keeps alphabets with dotted and dotless letters correct.

When the line is empty all three suggestion slots offer likely openers, drawn from what you type most often after nothing.

Next-word memory

The keyboard also learns which word you tend to type after which. Once you have typed hello everyone a few times, typing hello pushes everyone up the list. This sharpens the ordering; it never takes a slot away from ordinary matches.

⚠️ Password fields: while you type into a field the app knows is a secret, prediction and word learning are switched off for that session, and nothing you type is written to the dictionary or to the log. The Realtime keyboard has no mask, so the protection is based on the field being a secret, not on whether dots are drawn.

Where the files live

Both folders are reachable from Virtual Keyboard → Language:

ButtonFolderHolds
Open Language FolderDocuments\PersonalConsole\Shared\VirtualKeyboardLanguagesOne .json per keyboard layout
Open Dictionary FolderDocuments\PersonalConsole\Shared\VirtualKeyboardDictionariesOne .json per language's words

They open in the built-in file browser (section 9). Both are in the Shared folder, so they travel with the rest of your settings rather than being tied to one machine. Preferences → System → Share Settings With Other Accounts (section 12) moves them instead to a folder every Windows account on this computer reads.

Creating a language file

A language file describes what each key prints. It is a plain JSON file:

{
  "LanguageCode": "DE",
  "Base":  ["^", "1", "2", "…", "z", "x", "c", "v", "b", "n", "m", ",", ".", "-"],
  "Shift": ["°", "!", "\"", "…", "Z", "X", "C", "V", "B", "N", "M", ";", ":", "_"],
  "Caps":  ["^", "1", "2", "…", "Z", "X", "C", "V", "B", "N", "M", ",", ".", "-"],
  "Sym":   ["`", "1", "2", "…", "z", "x", "c", "v", "b", "n", "m", ",", ".", "/"]
}

The rules:

  1. LanguageCode decides the code, not the file name. The keyboard shows this value, uppercased. Two files with the same LanguageCode will collide — one silently replaces the other.

  2. Each layer is 47 entries, in this fixed order — the standard QWERTY block, left to right, top to bottom:

    RowCountPositions
    113` 1 2 3 4 5 6 7 8 9 0 - =
    213q w e r t y u i o p [ ] \
    311a s d f g h j k l ; '
    410z x c v b n m , . /

    Position 1 is the top-left key and position 47 is the bottom-right one. You are replacing what is printed, not moving keys around — so to build an AZERTY layout you put a where q is.

  3. Only Base is required. Shift, Caps and Sym are optional, and any layer you leave out falls back to Base. That makes a minimal language file quite short.

  4. Layers are what the modifier keys show: Shift while Shift is held, Caps while Caps Lock is on, Sym when you press SYM (the same key then reads ABC to go back).

  5. Save the file as UTF-8 so accented and non-Latin characters survive.

To install it: drop the .json into the language folder and restart PersonalConsole. The folder is read once at startup. Your new code then appears in the Available column on Virtual Keyboard → Language; switch it on to add it to the cycle.

⚠️ A broken file is skipped, not fatal. If the JSON does not parse, that one language is ignored and the others still load — so a typo makes a language disappear rather than break the keyboard. If a language you added is missing, that is the first thing to suspect; the log records the file name and the parse error.

Creating or editing a dictionary

A dictionary file holds the words for one language, named with the same code — EN.json, TR.json:

{
  "Version": 1,
  "WordsVersion": 2,
  "Seeded": false,
  "Words":     ["the", "be", "to", "of", "and"],
  "UserWords": ["gamepad", "roguelike"],
  "Pairs":     { "hello": { "everyone": 3 }, "project": { "diablo": 2 } }
}
FieldWhat it is
WordsThe shipped word list for that language
UserWordsWords you added with the 4th prediction button
PairsNext-word memory: previous → { next: count }. The count is how often you did it, and a higher count ranks that word sooner
Version / WordsVersion / SeededBookkeeping the app uses to decide whether to merge in newer shipped words. Leave them alone

To add words in bulk, open the file and extend UserWords — that is the list meant for you. Adding to Words works too, but a future update may refresh that list.

To remove a suggestion you never want, delete it from UserWords (or from Pairs). Removals stick; the app does not put them back.

To seed next-word behaviour by hand, add entries to Pairs. "tea": { "kettle": 5 } makes kettle outrank other matches right after you type tea.

⚠️ Close the keyboard before editing a dictionary by hand. It writes learned words back as you type, and a save from the app will overwrite what you edited underneath it.

📌 The dictionary folder is also where the keyboard's learning ends up, so backing up that folder backs up everything the keyboard has learned about how you write.

Languages

Screenshot: main/vk-language.png

Virtual Keyboard → Language has two columns: Available on the left, Enabled — cycled in this order on the right. Turning a language on moves it to the right column; turning it off sends it back.

The numbers on the right are the cycle order — the sequence the keyboard steps through when you switch languages — and the first one is what it opens with.

⚠️ At least one language must stay enabled; the app will not let you switch them all off.

Open Language Folder and Open Dictionary Folder open those folders in the built-in file browser, so you can add your own layouts or edit the learned-word lists.

Appearance

Screenshot: main/vk-keyboard.png

  • Size makes the whole keyboard larger or smaller, from 50% to 200%. It is capped at whatever still fits the screen, so a setting that would push the edges out of view is drawn a little smaller than asked — the number you chose is kept.
  • Corner Roundness and Background Opacity style the keyboard's panel.
  • Typing Input Lock holds the foreground while the Realtime keyboard is open, so the program underneath stops reacting to the pad. It stands aside only when the stand-in controller is genuinely doing the job for it — that is, when DirectInput Compatibility is on and the game has no controller of its own to read, which is the case with the pad in DInput mode. With the pad in XInput mode the game reads it directly, the stand-in shields nothing, and this setting stays in charge. ⚠️ It is not a guarantee once you are inside a game. Holding the foreground only stops a program that checks whether it is the active window. Some games poll the controller regardless of focus, and those keep reacting to the pad no matter what — measured in a game whose main menu goes quiet while the game itself does not. For typing inside such a game, use the Buffer keyboard: it is the one that holds the game still, which is the only thing that always works. 🔊 A game that mutes itself in the background keeps its sound. The lock puts the game in the background, and the keyboard hands it its focus straight back, so a mute in background option (on by default in some games) does not switch the sound off. 💬 Some games close their chat box when they lose the foreground, often only in their controller mode. The Realtime keyboard cannot type into such a chat box; use the Buffer keyboard there. 🖱️ While the lock holds, the mouse pointer is kept on the keyboard and hidden, so the game underneath cannot follow it. Moving a real mouse shows it again; closing the keyboard puts it back where it was.
  • Suggest From All Enabled Languages widens where suggestions come from. Off, the keyboard offers words from the layout you are on. On, it offers words from every language you enabled, whichever layout is showing — so typing English on the Turkish layout still gets suggestions, and someone who mixes languages does not have to teach the same word twice. 🔑 What it does not change is where words are saved. A new word is always learned into the language of the layout you were typing on, so your dictionaries stay separate; the setting only decides which of them are read when the three suggestion slots are filled.

Saved sign-ins

Screenshot: main/vk-password.png

Virtual Keyboard → Password is a small password manager for signing in from the couch. Entries are encrypted and stay on this machine — they are deliberately not synced anywhere.

8. Console Desktop

Console Mode replaces the Windows desktop with a full-screen one built for a controller.

Screenshot: desktop/tab-desktop.png Screenshot: desktop/tab-games.png in the catalog

Turning it on

Screenshot: main/console-shell.png

Console Mode → Shell:

SettingWhat it does
Enable Console Mode OverlayReplaces the Windows desktop with the gamepad-driven one
Auto Hide/Show on InputHides it the moment you use the mouse or keyboard, brings it back on gamepad input
Auto File ExplorerSits under Auto Hide/Show and works only while that is on. Moves your Windows Explorer windows into the built-in File Explorer on gamepad input (it opens minimised), and back on mouse or keyboard input. Off by default
Icon SizeHow large the shortcut tiles are
Background OpacityHow much shows through
Show Shortcut NamesItem names beneath their icons
Show Hidden ItemsInclude items marked hidden
Tab Switch AnimationHow the icons enter when LB / RB changes the tab: None (default), Fade, Slide, Slide and Fade or Zoom
24-Hour ClockOff shows AM and PM instead
Show Date With The ClockPuts the date above the time in the top bar

🔑 Auto Hide/Show is what lets you share the PC with a normal desktop session — touch the mouse and the console desktop steps aside; pick the pad back up and it returns.

Screenshot: main/console-shell__auto-file-explorer__dark-city.png

🗂️ Auto File Explorer does the same for folders. It is off by default, and greyed out while Auto Hide/Show on Input is off.

When youWhat happens
Pick up the padEvery open Windows Explorer window closes, and each of its tabs opens as a tab of the built-in File Explorer — the window that was in front comes first. The built-in File Explorer waits minimised; open it from the open programs on the Console Desktop, and it comes up full screen
Touch the mouse or keyboardThe built-in File Explorer closes, and each tab reopens in Windows Explorer in the window, position, size and state (open or minimised) it came from, showing the folder that tab is on now
  • If you opened or closed tabs in between, they all come back together in one window.
  • A Windows Explorer window is left open when one of its tabs shows something the built-in File Explorer has no place for — Network, a library, search results, the inside of a zip — and nothing is moved while a copy or move is in progress.
  • Windows' Home page comes back as This PC; the built-in File Explorer has no Home.

🔑 It never steals focus from a window you are using. It comes forward when everything else is closed or minimised, not while you are working in another program. That is a deliberate rule: an earlier version did activate itself aggressively and made ordinary windows unusable.

🎮 To call it forward on purpose, map the Show Console Desktop action (Mapping window → Windows Actions) to a button. That is the way back from a game running in windowed fullscreen: Win+D raises the Windows desktop, and while Console Mode is on, the desktop you are looking at is this one — so Windows shows you an empty screen instead. A bound button has no such confusion. Pressing it minimises every open window — the game, other programs, and this app's own windows — and the console desktop takes over the screen. A game running in exclusive fullscreen may not minimise.

What it shows

Your own desktop shortcuts plus the ones installed for all users, and every app installed from the Microsoft Store. Each Windows account keeps its own arrangement.

A program that has no desktop shortcut — Excel or Word, for example — is not listed until you add it: open the File Explorer, press 🔍 SEARCH, choose Programs, and press A on the program (section 9, Search). That puts a shortcut on your Windows desktop, and the Console Desktop shows it at once.

RT / LT switch between the general view and the open-applications view, remembering where you were in each.

Holding Y on an open application closes it. That is the same request its own ✕ makes, so the program still gets to ask you about unsaved work; the tile disappears once it really closes, and one that stays means the program is asking you something. On a shortcut in the general view the same hold removes the shortcut instead — which is why the hint on the bar reads Delete / Close.

The screen is stacked top to bottom — top bar, tabs, your shortcuts, then the open applications — and the d-pad walks straight through it. Down from the top bar lands on your shortcuts, down again reaches the open applications, and up retraces the same path. Nothing in the middle is skipped, so RT / LT are a shortcut between the two lists rather than the only way across.

When the focus rests on a shortcut or an open application for a second and its name is cut off — or Show Shortcut Names is off — the name opens to its full length in place: downwards over the icons below on the shortcuts, upwards on the open applications. Nothing moves; it folds back when the focus moves on.

The clock in the top bar opens a calendar for the month, with today marked. ◀ and ▶ move between months and Today comes back to this one; B closes it. How the clock itself looks — 12 or 24 hours, and whether the date is shown — is set in Console Mode → Shell.

The connection icon in the top bar shows how this computer reaches the internet: a network-cable socket when it comes over a cable, the Wi-Fi mark when it comes over Wi-Fi, where more lit arcs mean a stronger signal (a dot alone is the weakest). When both are connected, the one carrying the internet is shown. Grey means no connection. Either way it opens the Wi-Fi panel.

The Bluetooth icon opens the Bluetooth panel: the radio switch, then your paired devices. Press A on a device to open its page:

RowWhat it does
Connect / DisconnectConnects or disconnects an audio device — headphones, a speaker. Only audio devices have it, as in Windows; a controller, keyboard or mouse disconnects when you switch it off
ForgetRemoves the pairing. Hold A for two seconds — the row fills as you hold, and letting go early cancels. The device has to be paired again to be used

+ Add Device at the bottom of the list searches for devices nearby that are not paired; put the device in pairing mode first. Press A on one to pair it. Some devices need one more step, and the panel shows it:

The panel showsDo this
PIN on the device: 123456Check that the device shows the same number, then press Matches
Enter 123456 on the deviceType the number on the device (a keyboard), then press Pair
PIN shown on the device: and a boxType the number the device shows into the box, then press Pair

Refresh on this page searches again. B goes back one page, and closes the panel from the device list.

Beside the connection and Bluetooth icons, the speaker icon opens the sound panel. The first row mutes or unmutes. Below it is the volume bar: move down onto it and press A to start adjusting — the round handle fills in — then left and right change the volume 1% at a time, faster the longer you hold the direction. Raising the volume also unmutes. Press A or B to stop adjusting; until you press A, left and right do not change the volume. Below the bar are the playback devices this computer has — speakers, headphones, a TV — with a ✔ on the one in use; choosing another switches the sound to it straight away. B closes the panel. The icon in the top bar shows a crossed-out speaker while the sound is muted.

The system tray opens from the small ⌄ arrow at the left of the top bar's right-hand icons. It is drawn at a quarter of the icon size and lists the icons Windows is actually showing - both the ones sitting on the taskbar and the ones behind its chevron. Resting on an icon for a second shows its name; there is no name list underneath and no scrollbar, by design. A activates an icon.

Right after you restart the computer, Windows has not yet built the panel that holds its hidden icons, and nothing can read them until it has. Until you open a tray menu once, the list is shown unfiltered and can include programs that are not really in the tray.

PersonalConsole's own icon is not shown here - open its window or quit it from the app itself.

Holding A opens that program tray menu - the one a right click gives on the Windows tray - as a small menu just below the icon, carrying that program own entries. While the menu is being read the icon spins a small ring on itself. The d-pad moves between them, A carries one out and B closes it, leaving the tray panel open. Nothing from Windows appears while this happens: no taskbar, no hidden-icons flyout and no Windows menu, and the Console Desktop keeps the controller throughout.

Some programs draw their menu themselves (Epic Games Launcher, Riot Vanguard). Their entries are read from the menu's picture, so a name can occasionally be misspelled, and choosing one may show the mouse pointer for a moment where it already is.

Icons belonging to programs Windows runs as the system account — Apollo and the NVIDIA settings icon are the usual ones — open the same way. A helper installed with the application does the reading for them; it starts when you hold A on such an icon and does nothing the rest of the time. If it cannot start on your machine, holding A says the menu cannot be opened. The switch for it is Enable System Tray Menus in Console Mode → Shell.

An entry marked with a › opens a further menu. Choose it to go into that submenu; B or the ‹ Back row at the top returns to the level above.

A few programs answer a right click in their own way or with nothing at all; those open no menu here either. Some programs are ones Windows will not let PersonalConsole reach at all — Apollo, the NVIDIA settings icon and Remote Mouse are three; holding A on those says "This program's menu can't be opened here."

An icon Windows shows that belongs to no program it can name - "Bluetooth devices" is one - is not listed here, because there would be nothing to draw and nothing to open. PersonalConsole's own icon is not listed either.

System → Tasklist

System in the top bar opens the machine's details, the installed applications, and the Tasklist.

The Tasklist shows one row per running program — not one per process — with its icon, what it is costing in memory and CPU, and how many processes it is running. Programs showing a window are listed first, then the background ones. Name, CPU and Memory re-order the list within those two groups; pressing the one already selected reverses the direction. The order is then held still while the figures refresh, so a row does not move out from under the pad.

X ends the program under the cursor. The confirmation names how many processes that is, and ending it closes all of them; anything unsaved in the program is lost. B cancels, and Cancel is where the cursor starts.

⚠️ The power menu needs a three-second hold: the option fills from left to right and the vibration ramps up as it fills, so it cannot be triggered by accident. Letting go early cancels.

The menu offers System Shutdown (red), System Restart (amber), Low Power Standby (green), Sleep (blue), Sleep (Wake on Input) (light blue), Hibernate (indigo) and Cancel (grey). An option's hold fill uses the same colour as the option.

OptionWhat happensHow it wakes
Low Power StandbyThe screen turns off and Windows switches to its Power saver plan. The computer keeps running, so any gamepad, including a wireless one, can always wake itPress any gamepad button or move a stick. The mouse and keyboard also wake it. The press that wakes it does nothing else, and your previous power plan comes back
Sleep (Wake on Input)A real sleep. Before sleeping, it allows every connected controller that can wake the PC to do soPress a button on such a controller. The power button and the keyboard wake it as well

Whether a controller can wake a sleeping PC depends on its USB receiver or cable, not on any setting: many wireless receivers and most Bluetooth controllers cannot. During the countdown, Sleep (Wake on Input) lists every connected keyboard, mouse and controller that Windows allows to wake the PC — one line per device, such as a USB receiver with what it carries — and says so when no controller can; the PC goes to sleep either way. If none can, use Low Power Standby instead — it saves less power than sleep, but any controller wakes it.

⚠️ A USB device on that list still cannot wake the PC if the motherboard switches USB off during sleep. That is a BIOS setting, and Windows cannot see it: look for Resume by USB Device (or Wake on USB) and turn it on, and turn ErP off. On MSI boards both are under Settings → Advanced.

Once the hold completes, a full-screen countdown — Shutting down, Restarting, Entering low power standby, Going to sleep or Hibernating, from 5 down to 1 — gives you five more seconds. Press B to cancel; nothing happens to the computer. When the count reaches zero the action runs. A mouse double-click on an option goes through the same countdown.

Tabs

Screenshot: main/console-tabs.png

Console Mode → Tabs organises the desktop into tabs. Select a tab to enable Move Up and Move Down and reorder it. Items are assigned to tabs from the desktop itself, and the layout is saved as you go. The first tab is the one the desktop opens on, so it stays first: it cannot be moved, and no other tab can move above it. That is why both buttons are disabled on the first tab, Move Up is disabled on the second, and Move Down is disabled on the last.

The built-in browser setting

Screenshot: main/console-explorer.png

Console Mode → File Explorer decides when PersonalConsole's own browser is used. There are two switches because there are two different moments, and they can be set separately:

  • Open Folders In The Built-in File Explorer — every button that opens a folder lands here, including the Console Desktop's File Explorer button and any folder shortcut on it. Off means Windows Explorer.
  • Choose Files With The Built-in File Explorer — every button that asks you to choose a file or folder picks here. Off means the ordinary Windows dialog.
  • Show Hidden and System Files — off, the browser also leaves out what Windows keeps at the top of a drive even though it is not marked hidden: the folders (Windows.old, ESD, PerfLogs, anything starting with $ or .) and, at the top of the drive Windows is installed on, loose files such as setup logs. Folders there are still listed, and your other drives are untouched. Turn it on to see everything
  • Icon Size and Background Opacity for the browser window

9. File Explorer

A controller-driven file browser. It opens when you open a folder from inside the app — for example Open Language Folder — and from the Console Desktop. Its window has an icon of its own — a folder with a glowing core and a tentacle wrapped round it — everywhere it is listed: the taskbar, Alt+Tab, the Window Switcher and the Console Desktop's open applications.

The bar across the bottom is this window's control reference:

ButtonAction
AOpen the selected item
BBack — at This PC it closes the tab (the window, on the last tab); hold to exit the window
XActions menu
YNew tab — the + at the end of the tab strip
LT / RTPrevious / next tab, when two or more are open
BackMinimize the window

The breadcrumb across the top shows where you are, and every part of it is a place you can jump to. To its right sit Sort by, View and ✎ PATH — the last of these lets you type a path directly.

Press up from the listing to reach that top row, then left and right to move along it; down takes you back into the files. Moving sideways stays inside the row, so you cannot fall out of it by accident.

Hold a direction to keep moving through the files: after about half a second the steps speed up, and within a couple of seconds they run several times faster. Let go and the next press is a single step again.

The actions menu

Screenshot: explorer/actions__file-menu__dark-city.png

X opens it, and it acts on the selected item:

Select this item · Select up to here · Clear selection · Open in new tab · Copy · Cut · Paste here · Pin to This PC · Rename · New folder · Delete · Run as administrator · Send to Desktop · Add to Profile · Add to Console Desktop · Properties

Entries that do not apply are dimmed rather than hidden, so the menu keeps the same shape.

Tabs

Screenshot: explorer/tabs__strip__dark-city.png

The strip of tabs sits above the path, even when there is only one tab, and ends with a +.

  1. Press Y (the +) for a new tab at This PC, added after the last tab. On a folder or a drive, X → Open in new tab opens that place beside the tab you are on instead.
  2. LT and RT move between the tabs; each tab remembers its folder and the item you were on.
  3. B at This PC closes the tab you are on. On the last tab it closes the window, as before. Hold B closes the window with every tab.

While the File Explorer is open, the Console Desktop's 📁 File Explorer button adds a new tab and brings the window up — also when it was minimised.

Sorting and view

Screenshot: explorer/listing__sort-size.png

Sort by and View live in the top row, next to the path. Each states the setting currently in use and moves to the next one every time you press it:

Sort by: Name → Size → Date modified View: Grid → List

Folders always stay above files in every mode, and both choices are remembered between sessions. The focus stays on the button after each press, so you can cycle straight through the modes.

🔍 SEARCH in the top row, next to PATH, opens the search panel. Press A on the box to type with the Realtime Keyboard; the results follow the text as you type. RIGHT from the box reaches the two choices beside it:

ChoiceWhat it findsA on a result
Everything (default)Files, folders and programs whose name contains the text anywhere — in the folder that is open and every folder inside it. At This PC it searches every drive. Type at least two lettersA program: added to the Console Desktop (below). A file: shown in its own folder, where X has all its actions. A folder: opened
ProgramsOnly the installed programs, each with its icon. With the box empty, all of themAdded to the Console Desktop

Adding a program to the Console Desktop: A on it asks Which tab?; pick one and a shortcut with the program's name goes on your Windows desktop, where the Console Desktop picks it up in that tab. A program that is already there says on the Console Desktop under its name, and A on it only tells you so. Apps from the Microsoft Store are always on the Console Desktop by themselves.

  • On an NTFS drive (the usual Windows drive) results come in a second or two. Opening the panel reads the drive's list of names, so a search typed straight away may first show Reading the drive's file list…. Other drives (a USB stick, Google Drive) are searched folder by folder and take longer. The first 300 files are listed, and the line above them counts them.
  • The best matches come first: the whole name, then names that start with the text, then names with a word that starts with it (update in reddit-update-post.txt), then the text anywhere in the name.
  • From five letters, a typing mistake is forgiven — one wrong, missing, extra or swapped letter (two from nine letters), as long as the first letter is right. ssfpc still finds sffpc. These come after the exact matches.
  • A file made while the panel is open shows up after you close the panel and open it again.
  • Hidden and system files are not searched. Your OneDrive folder is searched like any other folder.
  • While a file is being chosen for something else (a profile's program, an icon), A on any result shows it in its folder instead, so you can pick it there.
  • X on a result opens its options: Open File Location (its folder, with it selected), Run as Administrator, Add to Console Desktop, Copy Path. Options that do not apply to that result are dimmed. X or B closes them.
  • B closes the panel.

Pinning and the Recycle Bin

Pin to This PC keeps a folder on the browser's start page. The Recycle Bin appears there too; inside it, the actions menu offers Restore and Empty Recycle Bin.

Delete asks first, with Cancel selected, and sends the item to the Recycle Bin, where Restore brings it back to where it was.

⚠️ Empty Recycle Bin cannot be undone.

10. Appearance and themes

Screenshot: main/prefs-theme.png

Preferences → Theme is where the look is chosen.

Scopes

The strip at the top has three scopes — Main Application, Virtual Keyboard and Console Desktop — and under each it prints the theme that scope currently uses. They are independent: the keyboard can use a different theme from the main window.

⚠️ If a scope points at a theme that no longer exists, its pill shows Not found with the name it is looking for, instead of quietly falling back to something else.

Applying and editing

To apply: pick a card in the grid. The applied theme is marked with a ✓ badge — the badge follows what is applied, not what the cursor is sitting on.

To edit: select a theme and press Edit — its colours load into the Edit Theme panel: Theme Name, and the Background, Highlight/Accent and Text colours. Each colour row's swatch is the button that opens the colour picker.

The primary button tells you exactly what it will do:

CaptionWhat happens
Save changesThe name is unchanged, so this theme is overwritten
RenameYou changed the name — the theme is renamed in place, and you still have one theme
Save as copyAlways creates a second theme and leaves the original alone. If the name is still taken — you kept it, or it is a built-in's — a copy of Mine is called Mine (copy) (then Mine (copy 2), …); this is also how to make your own version of a built-in theme

⚠️ A name another theme already uses is refused rather than silently overwriting it. ⚠️ Delete removes a custom theme permanently. Built-in themes cannot be deleted.

Export / Import move themes between PCs; Open Theme Folder opens where they are kept.

The rest of the look

Screenshot: main/prefs-appearance.png

Preferences → Appearance:

SettingWhat it does
Virtual Keyboard ThemeWhether the keyboard follows the selected theme
Console Desktop ThemeWhether the console desktop follows it
Logo and Icon TintRecolours the logo and app icons with the accent colour
Device Layout Button IconsController glyphs instead of letters in Device Layout
Controller IconsWhich family's button icons are shown: Automatic, Xbox, PlayStation, Nintendo
Navigation SoundsQuiet sounds in every window the controller drives, a different one for each action: moving the highlight, selecting (A), going back (B), switching tabs (LB/RB/LT/RT), turning a switch on or off, adjusting a slider (the pitch rises with the value) and pressing a direction when there is nowhere further to go (except in File Explorer, the window switcher and System). Styles: Off (default), Glass, Wood, Air, Deep, Bubble, Crisp, Snap or Soft. Choosing one plays a sample. Silent while the Virtual Keyboard is open

11. Controller reference

The pad hints printed on each screen are always right for that screen. This is the general case.

ButtonIn the app's windowsIn a radial menuIn File Explorer
ASelect / activatePick the highlighted entryOpen
BBack; closes the innermost thing that is open. In the main window with nothing open, hold to minimize and keep holding to exit (section 2)Close the menuBack (hold to exit)
X——Actions menu
YOn the Console Desktop, hold: delete a shortcut / close an open application—New tab
LB / RBChange section (change menu in the radial editor)——
LT / RTChange tab (on the Console Desktop: switch between the shortcuts and the open applications)—Change tab, when two or more are open
D-Pad / Left StickMove the focusChoose an entryMove the selection

Sliders are entered with A; left/right then changes the value, and A or B leaves. Left and right do nothing until you have entered the slider, so a value cannot be nudged by accident while passing over it.

A single press moves the smallest amount that setting can take — two pixels on an icon size, one percent on an opacity, ten milliseconds on a timing. Holding a direction grows the step from there and reaches ten percent of the slider's range after about five seconds, then stays there. Letting go and pressing again starts fine once more, so you can travel a long way and still land on the exact value. Because the top speed is a share of each slider's own range, every slider feels the same — a 0–100 one and a 10–1000 one take about the same time to cross.

Hold-to-confirm buttons (Delete, Exit, Empty Recycle Bin) fill a bar while held and only fire when it is full. Letting go early cancels.

Every control in this app can be reached with the controller, the mouse and the keyboard. If one of the three cannot reach something, that is a bug worth reporting.

Detection

Screenshot: main/prefs-controller__dark-city.png

Preferences → Controller shows what the app has found and how it is reading it.

Two of the settings below rely on drivers that do not come with Windows — ViGEmBus and HidHide. The installer puts both on the machine for you, so there is nothing to download by hand; the panel still shows whether each one is present, which is where to look if a setting says it is unavailable. They are not part of this application and uninstalling it leaves them installed, because other controller software may be using them. To remove them, use Apps & Features and look for ViGEm Bus Driver and HidHide. Their licences are in THIRD-PARTY-NOTICES.txt, next to the application.

  • Input Source — Automatic (XInput when it owns a controller, otherwise reads a DInput pad directly), XInput only, or Raw (DInput) only
  • Active Controller — the pad in use and which path it is read through
  • Button Layout — only for a controller read directly (DirectInput). The line says whether the layout in use is a known one or a guess; Map Buttons opens a step that asks you to press A, B, X, Y, the shoulders, the two menu buttons and the two stick clicks, one at a time, and remembers what it learns for that model of controller. Press nothing for eight seconds and that control is left as it was, so you can map only the buttons that are wrong. It takes effect the next time the controller is connected
  • DirectInput Compatibility — lets games that only read Xbox controllers see yours, and mutes it while you type. It needs ViGEmBus, and the panel says whether that is installed. ⚠️ This only mutes a game that has nothing else to read. In DInput mode a game that reads XInput cannot see your pad at all, so the stand-in is its only controller and muting works — but a game that reads controllers the DirectInput way can still see your pad, and which of the two it picks is the game's choice, not a setting. Measured with the pad in DInput mode and hiding off: two of three games settled on the stand-in and stayed quiet while typing, the third settled on the physical pad and the left stick still moved the character. Exclusive Controller Access is the only thing that removes that choice — measured, not assumed: closing that route any other way would mean locking the controller away from the game, and this application has to keep the controller open itself in order to read it at all. In XInput mode the game reads your pad directly and the stand-in cannot mute anything — there Typing Input Lock is what keeps input out of the game, and only for programs that stop reading the pad when they are not the active window. Inside a game that polls it anyway, the Buffer keyboard is the answer.
  • Exclusive Controller Access — stops games reading the controller directly, so the stand-in is the only pad they can see and muting always works. It needs HidHide, and the panel says whether that is installed. 📌 Turn it on if a game keeps reacting to the pad while you type in DInput mode. With hiding off a game sees two controllers — yours and the stand-in — and picks one; if it picks yours, nothing can mute it. Hiding leaves one controller to find, so the answer no longer depends on the game. (Measured across three games: with hiding on, none of them reacted while the Realtime keyboard was open.) ⚠️ Turn this on when a tool such as Steam Input presents the controller to games a second time. That second controller is a real one as far as the game is concerned, so the stand-in cannot mute it and the character keeps moving while you type. Closing that tool has the same effect. 📌 While it is on, the controller is hidden from ordinary programs — and it becomes visible again as soon as the setting is turned off or PersonalConsole closes. ⚠️ What it does not cover, measured rather than assumed. With the controller in its XInput mode a game can still read it: that route is not the one this hides, and switching the setting on does not close it. Typing without the game reacting works there through Typing Input Lock instead (see the Virtual Keyboard settings), or by putting the controller in its DirectInput mode. Programs running with administrator rights can also still see the controller. 📌 It stays on and keeps watching. Turning it on with nothing connected is fine: the status line reads Waiting for a controller and the next controller to appear is hidden on its own. The same applies to a controller a tool presents a second time under a different name, which can happen at any point — including when a game starts. Nothing has to be turned off and on again.

12. Sharing settings with the other people who use this computer

Each Windows account that signs in to this computer gets its own settings. One switch changes that: Preferences → System → Share Settings With Other Accounts.

It starts off, which is what the app has always done: settings stay in the signed-in account's own Documents folder, and nothing changes until it is turned on. What it covers:

Shared when it is onNever shared
Profiles and every button binding in themConsole Desktop icons, tabs and pinned items
Themes and which one is in useFile Explorer's pinned and recent items
Radial menus and the buttons that open them
Keyboard settings, layouts, and learned words

The two on the right describe programs installed on this computer, so another account reading them would erase the ones it does not have. They have no switch and cannot be reached by this one.

Turning it on copies this account's settings into the computer-wide folder, and every account then reads them from there. The account's own copy is left where it is, so turning it back off returns to it. Restart the app for the new location to be read.

⚠️ This is about accounts on this computer, not about your own second machine. Settings already follow you between your machines when your Documents folder syncs, and that is unaffected here.

If another Windows account has already shared its settings, theirs are the copies already in the computer-wide folder, and turning this on simply starts using them. Nothing is copied and nothing is replaced. Your own settings are untouched and come back the moment it is switched off again.

⛔ Nothing here ever deletes or overwrites a file, in either direction. The consequence worth knowing: if settings are already shared by someone else, your own version cannot be made the shared one from inside the app.

13. If something goes wrong

The taskbar looks dead after the app was force-closed. Console Mode hides the Windows taskbar while it owns the screen and hands it back when the app exits. If the app is ended from Task Manager or crashes, a small background copy of PersonalConsole (the second PersonalConsole process you may see in Task Manager) hands the taskbar and desktop icons back within a moment. If that background copy was ended too, start PersonalConsole again and exit it properly, and the taskbar comes back.

A button I just mapped does nothing. The editor's top-left corner names the profile and the layout you edited. Confirm both are the ones actually in use — a binding placed on layout 3 does nothing while layout 1 is active. Also check whether that direction is locked by a stick/D-Pad template (section 4).

A game does not react to the controller. The active profile follows the foreground window; a program with no profile of its own gets the Desktop profile. Use the Emergency Desktop Mode combination (section 3) to force your way back, then give the game its own profile.

Menus work but games do not, or the other way round. See Preferences → Controller. If a game only reads XInput and your pad is in DInput mode, turn on DirectInput Compatibility so the game sees a stand-in controller.

A game bought on Steam reports no controller at all, while other games are fine. Steam can take Xbox-type controllers into its own layer before a game ever sees them, and the stand-in controller this application presents is one of the things it takes. The game is then told there is no controller, no matter what the pad is doing. Measured in one game: with the setting below on, the game showed Input Method: WASD and reacted to nothing; with it off, the same pad appeared instantly as Controller Device: Xbox Controller #1. Two ways to fix it:

  • Once, for the whole library — Steam → Settings → Controller → Show Advanced Settings → Enable Steam Input for Xbox controllers → off. Measured: with that one switch off and no per-game setting at all, the game announced Input method set to Controller on its own. This is the setting to reach for, and it also overrides per-game ones: a game whose own setting says Enable Steam Input still worked while this was off. ⚖️ What it costs: Steam's own layout engine for Xbox pads stops everywhere — community controller configs, Steam layouts, and pad navigation in the Steam overlay. Nothing this application does depends on any of that, because the mapping happens here instead.
  • For one game only, if the trade above is unwanted — Library → right-click the game → Properties → Controller → Disable Steam Input. This has to be repeated per game. 📌 A notice appears over the game. When a Steam game comes to the front while Steam is set to take Xbox controllers and your controller is hidden from games, a short message says so and names the setting to change. It shows once per game, so it never repeats while you play. 📌 Preferences → Controller says so itself. While the stand-in is connected and Steam is set to take Xbox controllers, the line under DirectInput Compatibility adds a warning naming this and where to change it. No warning there means either the setting is off or it could not be read — the app stays quiet rather than guess. 📌 Another way to tell: Steam → Settings → Controller lists the controllers it is holding. If the stand-in controller is missing from that list while games still report none, this is what is happening.

In DInput mode a game ignores the controller until the window is clicked. A game that finds several controllers at startup picks one of them, and with the pad in DInput mode it can pick one that is not the stand-in it should be reading. Clicking makes the game look again, which is why it appears to fix it. The lasting answer is to leave it only one controller to find: turn on Exclusive Controller Access (Preferences → Controller), and connect the pad before starting the game so the hiding is already in place. The status line reads Hiding 1 controller from other programs once it is.

The console desktop will not come forward. It does not take focus from a window you are using — that is deliberate. Minimise or close what is in front of it, or pick up the pad if Auto Hide/Show on Input is on.

A language will not turn off. At least one keyboard language must stay enabled.

Text goes to the wrong place when I type in a game. Use the Buffer Keyboard instead of the Realtime one: it holds the game still and delivers the text when you close the keyboard.

The Realtime keyboard types nothing into a game's chat box. Some games close the chat input when another window takes the focus, often only in their controller mode. Open the chat in the game first, then type with the Buffer Keyboard.

I want to report something. Preferences → System → Open log folder opens the logs. They record what the app did and never contain passwords or usernames.