alyaparan / jsdoodu

JS.Doodu captures comprehensive browser and system information, sending it to a Node.js server for storage and analysis. Ideal for web developers, data analysts, and cybersecurity enthusiasts seeking insights from client-side data.

JS.Doodu

Version 1.1.0

JS.Doodu is a sophisticated web application designed to capture detailed browser and system information from the client and send it to a Node.js server for storage and analysis. This tool is perfect for web developers, data analysts, cybersecurity enthusiasts, and ethical hackers looking to gain deep insights into client-side environments.

Features

• IP Address Detection: Automatically fetches and logs the client's IP address.
• Browser Information: Collects comprehensive browser details such as name, version, language, and more.
• System Information: Gathers data about the client's operating system, platform, and hardware.
• Network Information: Logs network-related information like connection type and downlink speed.
• Geolocation: Captures the client's geographic location (latitude and longitude).
• Device Capabilities: Detects available device features such as battery status, media devices, and sensors.
• Performance Metrics: Logs navigation timing and other performance-related metrics.
• BeEF-XSS Integration: Utilizes BeEF-XSS for advanced browser exploitation framework features, accessible via http://127.0.0.1:3000/hook.js.
• JSON Data Viewer: A Python-based Qt application for analyzing, filtering, and monitoring captured JSON files.

Installation

1. Clone the Repository:

   git clone https://github.com/alyaparan/jsdoodu.git
   cd jsdoodu

2. Navigate to the Server Directory:

   cd server

3. Install Server Dependencies:

   npm install

4. Start the Node.js Server:

   node server.js

5. Open Another Terminal and Navigate to the Website Directory:

   cd ../website

6. Start the HTTP Server for the Website:

   python3 -m http.server 80

7. Access the Application: Open a web browser and navigate to http://localhost. This will load the index.html page and start capturing client-side data.

8. Install Python Dependencies.:

   pip install -r requirements.txt

9. Run the JSON Data Viewer:

   python3 json_viewer.py

File Structure

The project directory structure is as follows:

jsdoodu/
    ├── server/
    │   ├── node_modules/
    │   ├── package-lock.json
    │   ├── package.json
    │   └── server.js
    ├── website/
    │   ├── client.js
    │   ├── favicon.ico
    │   ├── index.html
    │   ├── script.js
    │   └── styles.css
    ├── json_viewer.py
    ├── config.json
    ├── jsdoodu.log
    ├── README.md
    ├── .gitignore
    ├── LICENSE
    └── CODE_OF_CONDUCT.md

Directories and Files

• server/: Contains the Node.js server files.

  • node_modules/: Directory for Node.js dependencies.
  • package-lock.json, package.json: Node.js package management files.
  • server.js: Main server script.

• website/: Contains the client-side files for the web application.

  • client.js: Client-side JavaScript file.
  • favicon.ico: Favicon for the website.
  • index.html: Main HTML file for the application.
  • script.js: Additional JavaScript functionality for the website.
  • styles.css: CSS styles for the website.

• json_viewer.py: Python script for viewing, analyzing, and managing captured JSON files.

• config.json: Config JSON script for Python file and web configuration.

• jsdoodu.log: JS.Doodu log file for Python script to log web requests.

JSON Data Viewer Features

• Data Visualization: Visualize data using Plotly.
• Advanced Filtering: Filter JSON files based on specific criteria.
• Real-time Monitoring: Monitor new JSON files being added to the directory.
• Export and Import: Export filtered data to CSV.
• Search Functionality: Search for specific terms or values within the JSON files.
• Comparison Tool: Compare two or more JSON files side-by-side.
• Summary and Statistics: Display summary statistics of the data.
• Help Documentation: Provide in-app documentation and help sections.
• Error Handling and Logging: Track and manage errors or issues within the application.
• Notifications and Alerts: Send notifications or alerts based on specific conditions.
• Customizable Dashboard: Customize the interface and display preferences.
• Multi-language Support: Extend using Qt's translation features.
• Data Backup and Recovery: Placeholder for future enhancements.
• Batch Processing: Enable batch processing capabilities.

Usage

1. Server Automatically Setup and Startup:

   • Navigate to jsdoodu/ directory and run command:

     python3 jsdoodu.py

2. Accessing the Application:

   • Open a web browser and visit http://localhost. This will load index.html and initiate data capture from the client's browser.

3. Running JSON Data Viewer:

   • Navigate to jsdoodu/ directory and run command:

     python3 json_viewer.py

4. BeEF-XSS Integration:

   • The application integrates BeEF-XSS capabilities via http://127.0.0.1:3000/hook.js. Ensure your BeEF-XSS server is running on this endpoint for advanced browser exploitation features.

Contributing

• Code of Conduct: Please adhere to our Code of Conduct when contributing.
• Contributing Guidelines: Read the Contributing Guidelines before submitting pull requests.

License

This project is licensed under the MIT License. See the LICENSE file for details.

Contact

For questions or concerns, you can contact the project creator at:

• Website: alikparanyan.com
• Email: [email protected]
• Personal Gmail: [email protected]