Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 6 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,12 @@

## Unreleased

- Focus new tabs before session setup and preserve immediately typed search text,
including explicit new-tab URLs and native toolbar clicks.
- Add real independent private windows, session bookmarks/history, temporary
download management, process metrics, tab search and explicit session clearing.
- Expand the Chrome-style profile with tab reordering, source viewing, local-file
opening, search/toolbar focus, platform aliases and legacy-default migration.
- Unify Chrome-style keyboard shortcuts across browser chrome and page input,
including tab cycling/selection, real URL reopening with a fresh identity,
find, zoom, reload, fullscreen, page save/print and DevTools.
Expand Down
5 changes: 5 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -43,6 +43,11 @@ Live rules cover header values and supported text bodies, including when
manual interception is off. See the [rule limits](docs/interception-and-rules.md)
before relying on a transformation.

The [keyboard profile](docs/keyboard-shortcuts.md) includes new private windows,
session bookmarks/history, downloads and tab search. New tabs focus the address
bar immediately. Browsing records stay in memory; bookmark/history data is not
made persistent by these controls.

Research tools do not automatically crawl, scan, or attack targets. Passive
notes do not issue extra requests and are not confirmed vulnerability reports.
JWT inspection decodes claims; it does not verify their signature.
Expand Down
204 changes: 123 additions & 81 deletions docs/keyboard-shortcuts.md
Original file line number Diff line number Diff line change
@@ -1,86 +1,126 @@
# Keyboard and tab behavior
# Keyboard and private browser controls

Status: unreleased source changes after 1.0.2. These shortcuts work in browser
chrome and focused web pages, including page text fields. They are local to the
browser, not system-wide hotkeys. Native copy/paste, undo/redo, selection and
ordinary typing are left to the focused field.
Status: unreleased source changes after 1.0.2. Shortcuts work in browser chrome
and focused pages, including text fields. They are not system-wide hooks.
The profile was checked against [Chrome's desktop shortcut reference](https://support.google.com/chrome/answer/157179?hl=en).
Fathi implements equivalents where it has the feature; it is not a Chrome clone.

## Defaults
## Windows and Linux defaults

| Action | Keys |
| --- | --- |
| New tab | Ctrl+T |
| Close tab | Ctrl+W, Ctrl+F4, or middle-click its tab |
| Reopen last closed tab | Ctrl+Shift+T |
| Next / previous tab | Ctrl+Tab / Ctrl+Shift+Tab; Ctrl+PageDown / Ctrl+PageUp |
| New private window | Ctrl+N or Ctrl+Shift+N |
| New tab / reopen closed tab | Ctrl+T / Ctrl+Shift+T |
| Close tab / window | Ctrl+W or Ctrl+F4 / Ctrl+Shift+W |
| Next / previous tab | Ctrl+Tab or Ctrl+PageDown / Ctrl+Shift+Tab or Ctrl+PageUp |
| Move tab right / left | Ctrl+Shift+PageDown / Ctrl+Shift+PageUp |
| Select tab 1–8 / last tab | Ctrl+1–8 / Ctrl+9 |
| Address bar | Ctrl+L, Alt+D, Ctrl+K, F6 |
| Reload / bypass cache | Ctrl+R or F5 / Ctrl+Shift+R or Ctrl+F5 |
| Back / forward | Alt+Left / Alt+Right; Ctrl+[ / Ctrl+] |
| Home / stop loading | Alt+Home / Escape |
| Find in page | Ctrl+F |
| Next / previous match | Enter / Shift+Enter in Find; Ctrl+G / Ctrl+Shift+G; F3 / Shift+F3 |
| Zoom in / out / reset | Ctrl+Plus (or Ctrl+=) / Ctrl+- / Ctrl+0 |
| Search open tabs | Ctrl+Shift+A |
| Address bar / explicit search | Ctrl+L or Alt+D / Ctrl+K or Ctrl+E |
| Next / previous browser area | F6 / Shift+F6 |
| Page / first enabled toolbar item / last toolbar item | Ctrl+F6 / Alt+Shift+T / F10 |
| Bookmarks bar / open dialog focus | Alt+Shift+B / Alt+Shift+A |
| Browser menu | Alt+F or Alt+E; arrow keys navigate, Escape dismisses, X quits this instance |
| Back / forward / home | Alt+Left / Alt+Right / Alt+Home |
| Reload / bypass cache | Ctrl+R or F5 / Ctrl+Shift+R, Shift+F5 or Ctrl+F5 |
| Stop loading / dismiss | Escape |
| Find / next / previous match | Ctrl+F / Ctrl+G or F3 / Ctrl+Shift+G or Shift+F3 |
| Find selected text | Ctrl+Alt+E |
| Find-bar next / previous match | Enter / Shift+Enter |
| Bookmark current page / all open tabs | Ctrl+D / Ctrl+Shift+D |
| Bookmark manager / bar visibility | Ctrl+Shift+O / Ctrl+Shift+B |
| History / downloads / task metrics | Ctrl+H / Ctrl+J / Shift+Escape |
| Clear session data options | Ctrl+Shift+Delete |
| View source / inspect page | Ctrl+U / Ctrl+Shift+C |
| Page DevTools | F12, Ctrl+Shift+I or Ctrl+Shift+J |
| Open local file / save page | Ctrl+O / Ctrl+S |
| Print dialog | Ctrl+P or Ctrl+Shift+P |
| Zoom in / out / reset | Ctrl+Plus or Ctrl+= / Ctrl+- / Ctrl+0 |
| Fullscreen | F11 |
| Print / save page | Ctrl+P / Ctrl+S |
| Page DevTools | F12, Ctrl+Shift+I, Ctrl+Shift+J |
| Close window / quit | Ctrl+Shift+W / Ctrl+Q |
| Settings / guide | Ctrl+, / Ctrl+/ |
| Fingerprint settings | Ctrl+D |
| Device / proxy / interceptor | Ctrl+Shift+M / Ctrl+Shift+P / Ctrl+Alt+I |

On macOS, Command is also accepted for the Ctrl-style letter/number bindings.
Use **Control+Tab** to cycle tabs: Command+Tab belongs to macOS and is not
overridden. OS-reserved shortcuts and function-key settings can take precedence.
Native print dialogs, save dialogs, fullscreen transitions and OS-specific
shortcuts still need manual validation on each packaged target; automated live
keyboard checks currently run on Windows.

Fathi is not claiming every Chrome feature or shortcut. There is no new
multi-window manager, bookmark manager or persistent history/download library
in this change. Ctrl+D remains Fathi's fingerprint settings shortcut. Closing
the last tab retains the existing behavior of opening a fresh private tab;
Ctrl+Shift+W explicitly closes the window.

## Customization

Use Settings → Shortcuts to record, clear, save or reset bindings. Ctrl+Tab and
Ctrl+Shift+Tab can now be recorded. Ordinary Tab / Shift+Tab moves between
fields; Backspace clears a binding and Escape leaves the recorder.

Chrome-style aliases are active only while their action keeps its default
binding. Rebinding or clearing an action disables its aliases. Explicit custom
bindings take precedence, and existing saved bindings are preserved. In
particular, older configurations may still bind Ctrl+Shift+I to the interceptor.
Reset shortcuts (or rebind it) to use Ctrl+Shift+I for DevTools and Ctrl+Alt+I
for interception. The same resolver is used for chrome and webview input.

## Smoother tabs without weakening isolation

- Switching tabs focuses the selected page and keeps its tab visible, without
animating through intermediate tabs during rapid keyboard switching.
- New blank tabs focus the address bar. Background links stay in the background
and open next to their originating tab.
- Closing a tab removes it and selects its neighbor immediately; session cleanup
is still awaited, but does not leave stale tab indexes while input continues.
- Background loads no longer reset the foreground progress indicator. User zoom
is not reset on every document-ready event. Reduced-motion preferences are
respected.

Reopening keeps at most **10 URL/device entries in memory**, not on disk, and
creates a **new partition and fingerprint**. It does not restore cookies,
storage, passwords, POST submissions, page form contents or the old identity.
Internal identity/device replacement does not populate the reopen stack. All
entries disappear when the browser closes. Printing, saving a page and copying
diagnostics are explicit user-directed exports, not automatic persistence.

## About diagnostics

About displays the actual host OS name/version/build, machine architecture,
application architecture, Chromium/Electron/Node versions and packaged versus
development status. These values are not the tab's spoofed identity. Both info
APIs use the same collector; no Windows edition is guessed from a kernel number.
Copied diagnostics exclude usernames, hostnames, local paths and browsing data.
| Settings / guide | Ctrl+, / Ctrl+/ or F1 |
| Fingerprint / device / proxy / interception | Ctrl+Alt+D / Ctrl+Alt+M / Ctrl+Alt+P / Ctrl+Alt+I |
| Quit this window's application instance | Ctrl+Q |

In the address bar, **Alt+Enter** opens the input in a new foreground tab;
**Ctrl+Enter** completes a bare site name to `https://www.<name>.com`. A leading
`?` forces a search rather than URL navigation. Native page/text controls keep
Tab/Shift+Tab, Space/Shift+Space, Home/End, page scrolling, word navigation,
selection, copy/paste and undo/redo. Non-Latin physical letter keys are normalized
for browser commands; IME composition and AltGraph typing are not intercepted.

## macOS

Command is accepted for the common letter/number bindings. Use **Control+Tab**
to cycle tabs; Command+Tab belongs to macOS. Additional Command aliases include
Y for history, Shift+J for downloads, Option+B for bookmarks, Option+U for source,
Option+I/J for DevTools, Shift+H for home, Option+F for search, and E for finding
selected text. Command+Left/Right navigates history; Option+Left/Right remains
native text navigation. Command+H/M is left to the native hide/minimize handling.
Control+Command+F is an additional fullscreen shortcut.

OS-reserved gestures, function-key settings and native dialogs can take
precedence. Automated live keyboard tests run on Windows; native printing,
file pickers and packaged macOS/Linux GUI behavior still require manual checks.

## New-tab focus

New blank tabs, explicit `fathi://newtab` URLs, the plus button and Fathi's new-tab
button focus the **top address/search bar**. Foreground creation dismisses panels
that would cover it. Focus happens before asynchronous session/proxy setup and
text typed immediately is preserved. Page readiness does not reselect or erase
that text. Background tabs do not steal focus.

## Private feature semantics

- **Windows:** Ctrl+N and Ctrl+Shift+N launch real, independent application
processes, each with its own window, temporary directories, tab sessions and
fingerprint maps. All Fathi windows are private; there is no persistent normal
mode. Configuration is shared on disk but not live-synchronized. Quitting one
instance does not terminate the other windows. Cross-window tab dragging is
not implemented.
- **Bookmarks:** up to 200 deduplicated HTTP(S) bookmarks in memory, with a bar,
manager and removal controls. Bookmark-all uses a flat session collection,
not a persistent folder. These disappear on window close.
- **History:** up to 300 in-memory HTTP(S) visits for the current window. Internal
pages, executable URL schemes and local file paths are not recorded here.
- **Downloads:** up to 100 tracked records with native progress, active
pause/resume/cancel, and completed-file reveal/save-copy controls. Files use
unique names in the temporary download directory and are wiped on exit.
Only an explicit Save a copy action exports them outside it. Records expose no
local paths to the renderer; downloads are never executed automatically.
- **Task manager:** read-only process CPU/memory metrics for this instance, not
an arbitrary PID termination interface.
- **Clear data:** opens a confirmation panel; the shortcut alone deletes
nothing. The button clears this window's history, cookies, storage, auth and
cache. It retains bookmarks and does not affect independent windows. Reload a
page to reset data already held in its JavaScript memory.
- **Source/inspection:** source uses Chromium's actual `view-source:` viewer in
a fresh isolated tab, so authenticated pages may require signing in again.
Inspect opens DevTools at the top-left page element; it is not a promise of
Chrome's interactive element-picker or exact console-panel selection.

Closing the last tab still opens a fresh private tab. Reopen keeps at most
10 URL/device entries in memory and always creates a new partition/fingerprint;
it does not restore cookies, passwords, POST data, forms or the old identity.
Printing, saving, copying and file selection are explicit user-directed actions.

## Customization and compatibility

Settings → Shortcuts supports recording, clearing, saving and reset. Tab and
Shift+Tab move between recorder fields; Ctrl+Tab can be captured; Backspace
clears and Escape leaves the recorder. Rebinding/clearing disables that action's
aliases. Explicit custom bindings take precedence.

Known shipped legacy bindings migrate once to free Ctrl+D for bookmarks,
Ctrl+Shift+P for printing and Ctrl+Shift+I for DevTools. Distinct custom bindings
and already-versioned profiles are preserved. If a custom binding already claims
the migration's target, it is not overwritten; resolve the conflict or reset the
profile deliberately. Only configuration is persisted, never the session library.

Google accounts/guest profiles, sync, password/payment management, Chrome-only
feedback services, tab groups/multi-selection, split view, caret-browsing controls
and address predictions are not implemented or mapped to unrelated actions.
This is broad desktop shortcut coverage, **not every feature in Chrome**.

## Validation

Expand All @@ -89,8 +129,10 @@ npm test
npx electron . --fathi-e2e --fathi-browser-audit --fathi-identity-audit --fathi-intercept-audit
```

The browser audit sends real Electron key events through focused webviews and
chrome. It checks tab navigation from a textarea, numbered tabs, custom guest
bindings, shortcut recording, find matches, zoom, close/reopen with new identity,
background selection and actual About system fields. Unit tests cover all
default/alias resolution, IME/AltGraph safeguards and runtime diagnostics.
The live audit uses real key/mouse input and isolated local fixtures. It opens
and closes actual additional browser processes, reads a completed download,
checks source viewing, clears actual session storage, verifies immediate typing
and new-tab buttons, and exercises tab movement and library shortcuts. Unit
tests cover default/alias/platform matching, migration, library caps, download
state and safe window launch construction. Existing identity and interception
audits remain enabled.
2 changes: 1 addition & 1 deletion package.json
Original file line number Diff line number Diff line change
Expand Up @@ -25,7 +25,7 @@
"license": "MIT",
"main": "src/main/main.js",
"scripts": {
"test": "node tools/check-syntax.js && node --test tools/test-research.js tools/test-network.js tools/test-identity.js tools/test-certificate.js tools/test-update-fallback.js tools/test-intercept.js tools/test-shortcuts.js tools/test-system-info.js && node tools/test-rules.js",
"test": "node tools/check-syntax.js && node --test tools/test-research.js tools/test-network.js tools/test-identity.js tools/test-certificate.js tools/test-update-fallback.js tools/test-intercept.js tools/test-shortcuts.js tools/test-system-info.js tools/test-session-library.js tools/test-downloads.js tools/test-window-launcher.js tools/test-settings-shortcuts.js && node tools/test-rules.js",
"start": "electron .",
"icons": "node tools/make-icons.js && node tools/make-installer-art.js",
"dist:win": "electron-builder --win nsis portable --x64 --publish never",
Expand Down
Loading
Loading