If you’re enjoying Agent, don’t forget to give a star 🌟 on GitHub!
Changes:
v0.1.4 (5/27/2024; tldr: ✨Ryujinx✨, Settings, ScriptAPI, Bug fixes and improvements.):
- GUI:
- Fix an issue with
Realm
(fallback to normal). - Fix an issue when launching from the command line.
- Allow disabling clipboard copy.
- Allow modifying the websocket server's host and port.
- Add error message when websocket port is already used.
- Allow modifying the Overlay shortcut key.
- If both Overlay shortcut keys are the same, the Overlay will turn to "single shortcut key" mode.
- Added Brazilian Portuguese and Thai language support.
- ProcessSelector
- Scripting:
- Minor optimization in
libLoader.js
. - Added
libInit_global.js
. - Added
localStorage
,sessionStorage
like API. - Added
Breakpoint.toggle()
.
- Engine:
- Experimental ✨Ryujinx✨ support (Windows, Linux; I don't own a macOS device).
- Experimental re-attach for Yuzu, Ryujinx,... (Ryujinx may unstable).
- libWebsocket: OCR (lens).
- Dependencies:
- Update to Frida 16.2.5.
- Update to Electron 27.3.11.
v0.1.3 (1/11/2023; tldr: OCR, Overlay: InGame, External, Browser.):
- Overlay display:
-
Desktop: External Overlay (Windowed or Fullscreen borderless)
Ctrl+Alt+E
: toggle external overlay visibilityCtrl+Alt+D
: toggle external overlay input (Lock|Unlock)
-
Browser: Use the power of browser extensions
http://127.0.0.1:9001/
-
InGame: (fullscreen exclusive)
- inject to DiscordOverlay
-
v0.1.3 (9/20/2022; tldr: macOS build, remote connect: wine, vmware, emulator,...):
- Experiment macOS support (x64, arm64).
- Allow switch to another runtime (debugging purposes, port: 9229).
- Allow connect to remote frida-server (usecase: wine, vmware, emulator,...),
PID picker: inputhost
then Drag-n-Drop.
Or input target manually:host|targetNameOrPID
, example:127.0.0.1|game.exe
: connect to 127.0.0.1 (frida-server default port 27042), attach game.exe127.0.0.1:1337|:666
: connect to 127.0.0.1 (port 1337), attach process pid = 666127.0.0.1|::R:/game1/game.exe
: connect to 127.0.0.1 -> run game.exe then attach.
v0.1.3 (7/24/2022; tldr: Android build, DeepL, UI API):
- DeepL (free api, experiment; console only)
- scripts dropdown + search, auto update.
- UI API (mod menu like):
loadHtml(str,base?)
,loadHtmlFromFile(path)
, bridge:- UI->Script:
rpc.exports
- Script->UI: electron like (but reverse).
- UI:
rpc.on
,rpc.handle
- Script:
rpc.send
,rpc.invoke
|rpc.sendSync
- UI:
- UI->Script:
- Experiment Android support, requirements:
- Root: frida-server https://github.com/ViRb3/magisk-frida
- Non-Root: Frida's Gadget (manual inject), patched (arm64):
- PPSSPP: please wait...
Usage: 1. Target: type `usb` (Agent will attach frontmost application) 2. Select a script 3. Press Attach button 4. Switch to target application (fast).
v0.1.2 (3/20/2022; tldr: Linux build, command line):
- Fix Drag-n-Drop (HiDPI support), icon.
- Command line:
Usage:
agent [options]
Options:
--target="path to executable" Path to executable (RUN)
--script="path to script" Path to script
--args="command line" RUN command line
--delay=0 [optional] wait (ms)
--pname="process name" [optional] ATTACH pname instead target
Examples:
/* Run -> Attach (for emulated games) */
agent --target="D:\yuzu.exe" --script="D:\script.js" --args="-p \"D:\game.nsp\""
/* Run -> wait 3s -> attach (for PC games) */
agent --target="D:\game.exe" --script="D:\script.js" --delay=3000
/* Run -> wait 3s -> attach game.bin */
agent --target="D:\game.exe" --script="D:\script.js" --delay=3000 --pname="game.bin"
/* Attach existing process */
agent --script="D:\script.js" --pname="game.bin"
v0.1.1 (tldr: script updater):
- New UI
- Script updater:
Script... -> dropdown -> update scripts
123
Fix
Unable to attach...
macOS: Disable SIP
Linux: Run agent asroot
orsudo sysctl kernel.yama.ptrace_scope=0
Download:
💉Agent: Windows | Linux | macOS (x64, arm64)
🤖OCR_Server (optional): ocrServer-01012024-win32-x64.zip
(Extract and run ocrServer.exe
; Agent will connect to server via HTTP protocol).