Skip to content

New generation of 3Wifi Locator. With support for custom databases, a WiFi network map and WiFi location by MAC address

License

Notifications You must be signed in to change notification settings

LowSkillDeveloper/WIFI-Frankenstein

Repository files navigation

WiFi Frankenstein

App Version Platform Kotlin

If you want to add your database to the SmartLinkDB recommendation section in the application for all users, i.e. share your database, then create a ticket in the "Issues" section on github, with a request to add your smartlinkdb link to the application.

πŸ“± Overview

WiFi Frankenstein is a comprehensive WiFi pentesting and database management application for Android. This application serves as the successor to the original 3WiFi Locator, offering significant improvements and new features for WiFi network analysis, mapping, and database management.

The application combines various WiFi tools and functionality into one powerful package, hence the name "Frankenstein" - it's built from the best parts of different WiFi analysis tools.

✨ Features

πŸ“Š Database Management

  • Local Database Support indexation and mapping: The local database supports indexing plus WiFi points can be displayed on the map
  • Local 3WiFi Database Support: Connect and work with huge 3WiFi databases locally
  • Custom Database Integration: Connect any compatible SQLite databases
  • SmartLinkDB: Support for updating databases via the Internet
  • Multiple Manufacturer Databases: 4 separate databases for checking WiFi device manufacturers

πŸ—ΊοΈ Mapping & Location

  • WiFi Maps: View WiFi points from 3WiFi db and custom databases without an internet connection (The map itself requires internet)
  • Clustering Control: Option to enable or disable point clustering on the map
  • Multiple bases: Possibility to display wifi points from several different databases on the map at once.
  • MAC base location: Finding the location of an access point by its MAC address

πŸ› οΈ Tools & Features

  • WPS PixieDust Android (OneShot): If you have root, you can perform a pixeldust attack from your smartphone with built-in wifi module.
  • WiFi Channel Analysis: Page for analyzing WiFi channels, providing insights into channel usage and performance.
  • MAC Address Locating: Find the geographical location of WiFi access points by MAC address
  • More Detailed Information: detection of WiFi network technologies, including RTT, NTB, TWT, and MLD
  • Viewing Saved Passwords: If you have root, you can view passwords to networks to which the phone was connected and they are saved in its memory.
  • WPS Pin Generator: Local pin code generation
  • WPA Password Generator: Local wpa passwords generation
  • Neighbor-based WPS PIN suggestions: multi-level neighbor-based WPS PIN suggestions from Local DB
  • WPS Connect: Possibility to connect via WPS
  • 3WiFi API Integration: Advanced settings and direct API requests
  • Distance Calculation: Measure distance to WiFi access point
  • Offline IP ranges: Using local databases, we find ranges of IP addresses for scanning with RouterScan
  • Updates: Support for updating the application and its components

3WIFI

🎨 Customization

  • Theme Options: Multiple color styles to customize the app appearance
  • Icon Customization: Change the application icon to suit your preferences

πŸ’» Technical Highlights

  • Written in Kotlin 2.0
  • Built on the latest Android SDK
  • Utilizes beta and alpha libraries for optimal performance

⚠️ Known Issues

  • Profile Saving: Saving wifi profiles may sometimes fail

πŸ”„ Comparison with 3WiFi Locator

Feature WiFi Frankenstein 3WiFi Locator
Local in-app Database βœ… Yes ⚠️ Limited
Offline Full 3WiFi Database βœ… Supported ❌ Not supported
Advanced 3WiFi API Settings βœ… Full access ⚠️ Limited API access
WPS PixieDust (OneShot) βœ… Supported (Root) ❌ Not supported
Viewing saved passwords in memory βœ… Supported (Root) βœ… Supported (Root)
WPA Generators (Router Keygen) βœ… Supported ❌ Not supported
WPS Generators βœ… Supported ⚠️ Limited
Neighbor-based WPS PIN suggestions βœ… Supported ❌ Not supported
3WIFI offline IP ranges βœ… Supported ❌ Not supported
WiFi Channel Analysis βœ… Supported ❌ Not supported
Additional WiFi Information βœ… Yes ⚠️ Limited
Custom SQLite Databases βœ… Supported ❌ Not supported
WiFi Maps βœ… Yes ❌ Not supported
WiFi API Maps ⚠️ Limited ❌ Not supported
WiFi Location (geoMAC) βœ… Yes ❌ Not supported
Database Updates βœ… SmartLinkDB ❌ Not supported
App/Component Updates βœ… Supported ⚠️ Notification only
Customizable Themes βœ… Multiple options ⚠️ Dark mode only
Custom App Icon βœ… Supported ❌ Not supported
Manufacturer Databases βœ… 4 databases βœ… 3 databases
Distance Calculation βœ… Supported ❌ Not supported
SDK version βœ… Latest ⚠️Old

πŸ“± Screenshots (Old version)

Screenshot 1 Screenshot 2 Screenshot 3
Screenshot 4 Screenshot 5 Screenshot 6
Screenshot 7 Screenshot 8 Screenshot 9

πŸ“₯ Installation

  1. Download the latest release from the Releases section
  2. Enable installation from unknown sources in your Android settings
  3. Install the APK file
  4. Follow the in-app setup guide for database configuration

πŸ” Permissions

The application requires the following permissions:

  • Location access (for mapping and for wifi scanning to work, Android SDK requirement)
  • Storage access (for database management)
  • Network access (for updates and online features)

πŸ“‹ Requirements

  • Android 5.0 or higher

βš–οΈ Disclaimer

This application is designed for network administrators, security researchers and WiFi enthusiasts to test and analyze their own networks. Always ensure you have proper authorization before analyzing any WiFi network.

πŸ’ Support Development

If you find this project useful and would like to support its development, you can make a donation using cryptocurrency:

Bitcoin (BTC)

19LYe2QhHXp2YAXSPrYydGc8v3t2TPdEPf

Ethereum (ETH)

0x5ebC5Eb2f59E6B62Ca9b221F2549D5067457D9b8

Monero (XMR)

4AC1MepXZA8R6XGcL5mjejWRDqKvmbY3YWGEJTCWmFxJ8gPuLULSYxKSWafy9haMXGYuR2CdF3Vr8Q2kS8pBorVpQ4Lie48

Your support helps maintain and improve this project. Thank you!

🀝 Contributing

Bug reports and feature requests are welcome! Feel free to open issues.

About

New generation of 3Wifi Locator. With support for custom databases, a WiFi network map and WiFi location by MAC address

Resources

License

Stars

Watchers

Forks