How fahimahamed1/fasonrat works
FasonRat is a self-hosted Android remote-management platform: operators use a web dashboard to manage connected devices, while an Android agent reports device data and handles remote commands. The README documents device access, screen control, resilience, APK customization, and administration; the source index identifies the corresponding backend, frontend, and agent modules. Some cross-process wiring and unsampled route implementations are not shown, so those links are omitted or marked unverified rather than inferred as direct calls.
Main entry points: SocketCommandRouter.java Command router · pages Management pages · MainService.java Foreground service · index.ts Server entry
Components 23
Web dashboard
- Dashboard app
frontend/src/App.tsx - Management pages
frontend/src/pages - API client
frontend/src/services/api.ts - Socket client
frontend/src/services/socket.ts
Backend services
- Server entry
backend/src/index.ts - Authentication
backend/src/auth/index.ts - API routes
backend/src/routes - Device sockets
backend/src/services/socket.ts - Background tasks
backend/src/services/tasks.ts - Application data
backend/src/db/schema.ts - APK builder
backend/src/routes/builder.ts
Android agent
- Android agent
fason/app/src/main/java/com/fason/app/core/FasonApp.java - Foreground service
fason/app/src/main/java/com/fason/app/service/MainService.java - Agent connection
fason/app/src/main/java/com/fason/app/core/network/SocketClient.java - Command router
fason/app/src/main/java/com/fason/app/core/network/SocketCommandRouter.java - Command protocol
fason/app/src/main/java/com/fason/app/core/Protocol.java - Background resilience
fason/app/src/main/java/com/fason/app/receiver
Device capabilities
- Device data access
fason/app/src/main/java/com/fason/app/features - File transfer
fason/app/src/main/java/com/fason/app/core/network/TransferHelper.java - Screen control
fason/app/src/main/java/com/fason/app/features/hvnc/HVncManager.java - Accessibility features
fason/app/src/main/java/com/fason/app/core/FasonAccessibilityService.java
Other components
- Operator
- HTTP interface
Connections 22
- Operator → Dashboard app: uses
README.md - Dashboard app → Management pages: presents
README.md - Management pages → API client: requests data
- Management pages → Socket client: receives updates
- API client → HTTP interface: sends requests
- HTTP interface → Server entry: serves
- Server entry → Authentication: registers
backend/src/index.ts - Server entry → API routes: registers
backend/src/index.ts - API routes → Application data: reads and writes
backend/src/routes/auth.ts - API routes → Device sockets: uses sockets
- Background tasks → Application data: uses
backend/src/services/tasks.ts - Android agent → Foreground service: starts
fason/app/src/main/java/com/fason/app/core/FasonApp.java - Foreground service → Agent connection: connects through
fason/app/src/main/java/com/fason/app/service/MainService.java - Foreground service → Command router: dispatches commands
fason/app/src/main/java/com/fason/app/service/MainService.java - Command router → Command protocol: uses messages
- Agent connection → Device sockets: exchanges events
README.md - Command router → Device data access: invokes features
fason/app/src/main/java/com/fason/app/features/hvnc/HVncManager.java - Command router → File transfer: handles transfers
- Command router → Screen control: controls screen
fason/app/src/main/java/com/fason/app/features/hvnc/HVncManager.java - Accessibility features → Screen control: forwards events
fason/app/src/main/java/com/fason/app/core/FasonAccessibilityService.java - Foreground service → Background resilience: uses watchdog
fason/app/src/main/java/com/fason/app/service/MainService.java - Management pages → APK builder: configures builds