Skip to content

nullvoidweb/nullvoid

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

21 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

NULL VOID Browser Extension

Enterprise-grade security and privacy for your browsing experience


DEVELOPMENT STATUS: This extension is currently in active development. Features may change, and some functionality might be unstable. We welcome contributions from the community! If you'd like to help improve NULL VOID, please check out our Contributing section below.


Table of Contents


Overview

NULL VOID is an enterprise-grade browser extension that provides comprehensive security and privacy protection through Remote Browser Isolation (RBI), smart threat prevention, disposable email services, and secure file viewing capabilities.

Main popup interface with all features

Why NULL VOID?

  • Zero Trust Browsing: Isolate potentially dangerous websites in remote browser environments
  • Real-time Threat Detection: Powered by VirusTotal API integration
  • Privacy First: Generate disposable emails on-the-fly
  • Secure File Viewing: View files without downloading them to your local machine
  • AI Assistant: Built-in AI chat for assistance and support

Key Features

1. Remote Browser Isolation (RBI)

Remote Browser Isolation workflow

Browse untrusted websites safely by rendering them in isolated cloud environments. NULL VOID supports multiple geographic regions:

  • Singapore (sg-rbi-api.nullvoids.live)
  • United States (us-rbi-api.nullvoids.live)
  • United Kingdom (uk-rbi-api.nullvoids.live)
  • Canada (ca-rbi-api.nullvoids.live)

Benefits:

  • Protects your device from malware and exploits
  • Isolates tracking cookies and scripts
  • Prevents drive-by downloads
  • Real-time streaming via WebSocket

2. Smart Prevention System

Smart Prevention System in action

Our intelligent threat detection system includes:

Ad Blocking

  • Blocks intrusive advertisements
  • Removes tracking pixels
  • Filters sponsored content
  • Improves page load times

Malicious Website Detection

  • Pattern-based threat detection
  • Known malicious domain blocking
  • Phishing site identification
  • Scam website prevention

VirusTotal Integration

  • Real-time URL scanning
  • Download verification before execution
  • Detailed threat analysis reports
  • Automatic polling for pending analyses

3. Disposable Email Service

Generate temporary email addresses

  • Generate temporary email addresses instantly
  • Powered by mail.tm API
  • Perfect for sign-ups and registrations
  • Auto-generated secure passwords
  • No personal information required

4. Secure File Viewer

View files securely without downloading

  • Preview files without downloading
  • Supports multiple file formats
  • Sandboxed viewing environment
  • Prevents malicious file execution

5. AI Chat Assistant

Built-in AI assistant

  • Integrated AI chat support
  • Context-aware assistance
  • Security recommendations
  • Privacy-focused conversations

Architecture

Extension Components

NULL VOID Extension
│
├── Background Service Worker
│   ├── Event Listeners
│   ├── State Management
│   └── API Communication
│
├── Content Scripts
│   ├── Smart Prevention System
│   ├── Page Analysis
│   └── DOM Manipulation
│
├── Popup Interface
│   ├── Feature Controls
│   ├── Status Display
│   └── Settings Panel
│
└── Web Accessible Resources
    ├── RBI Browser
    ├── File Viewer
    └── AI Chat Interface

Detailed system architecture

Technology Stack

Component Technology
Extension Framework Chrome Extension Manifest V3
Frontend HTML5, CSS3, Vanilla JavaScript
API Integration VirusTotal API v3, Mail.tm API
Remote Isolation Browserless.io, Custom RBI APIs
Real-time Communication WebSocket (wss://)
State Management Chrome Storage API
Testing Node.js, Custom Test Framework

Smart Prevention System

How It Works

The Smart Prevention System operates as a content script that runs on every webpage you visit. It performs three layers of protection:

Layer 1: Ad Blocking

  • Identifies and removes ad elements using CSS selectors
  • Blocks common ad network requests
  • Improves page performance and privacy

Layer 2: Pattern-Based Detection

  • Analyzes URLs and page content for suspicious patterns
  • Matches against known malicious domain database
  • Blocks access before page loads completely

Layer 3: VirusTotal Verification

// Automatic URL scanning workflow
1. User navigates to new URL
2. System checks cache for previous scans
3. If not cached, submits URL to VirusTotal
4. Polls for analysis results (max 30 seconds)
5. Displays warning if threats detected
6. Blocks downloads from malicious sources

Configuration

You can customize Smart Prevention behavior:

// Toggle individual components
- Ad Blocking: ON/OFF
- Malicious Detection: ON/OFF
- VirusTotal Scanning: ON/OFF

Warning Dialogs

Example warning for suspicious content

When threats are detected, NULL VOID displays informative warnings:

  • Pending Analysis: Yellow warning while VirusTotal analyzes the URL
  • Suspicious Content: Orange warning for potential threats
  • Malicious Detected: Red warning with detailed threat information
  • Safe Content: Green indicator for verified safe URLs

Technologies Used

Core Technologies

  • JavaScript ES6+: Modern JavaScript features and async/await
  • Chrome Extension APIs:
    • chrome.storage - State persistence
    • chrome.runtime - Background communication
    • chrome.scripting - Dynamic script injection
    • chrome.tabs - Tab management
    • chrome.declarativeNetRequest - Network filtering

External APIs

  1. VirusTotal API v3

  2. Mail.tm API

  3. Browserless.io

Project Structure

NullVoid/
│
├── README.md                          # This file
├── src/                               # Extension source code
│   ├── manifest.json                  # Extension manifest
│   ├── background.js                  # Background service worker
│   ├── popup.html                     # Popup UI
│   ├── popup.css                      # Popup styles
│   ├── popup-fixed.js                 # Popup logic
│   ├── smart-prevention-system.js     # Core security module
│   ├── auth-service.js               # Authentication handling
│   ├── disposable-email.js           # Email service
│   ├── file-viewer-secure.html       # File viewer UI
│   ├── file-viewer-secure.js         # File viewer logic
│   ├── rbi-browser.html              # RBI interface
│   ├── rbi-browser-browserless.js    # RBI implementation
│   ├── ai-chat-full.html             # AI chat UI
│   ├── ai-chat-full.js               # AI chat logic
│   ├── ai-chat-ui.js                 # AI chat components
│   ├── ai-chat-extension.js          # AI chat integration
│   ├── debug-toggle.js               # Debug utilities
│   ├── browserless-config.js         # Browserless configuration
│   │
│   ├── icons/                        # Extension icons
│   │   ├── icon16.png
│   │   ├── icon48.png
│   │   └── icon128.png
│   │
│   ├── manifests/                    # Browser-specific manifests
│   │   ├── chrome.json
│   │   └── firefox.json
│   │
│   └── rules/                        # Blocking rules
│       ├── ad-blocking-rules.json
│       └── malicious-blocking-rules.json
│
├── tests/                            # Test suite
│   └── virus-total-api.test.js      # VirusTotal tests
│
└── docs/                             # Documentation & images
    └── images/                       # Screenshots & diagrams
        ├── banner.png
        ├── popup-interface.png
        ├── rbi-architecture.png
        ├── smart-prevention.png
        ├── virustotal-scan.png
        ├── disposable-email.png
        ├── file-viewer.png
        ├── ai-chat.png
        ├── architecture-diagram.png
        ├── load-extension.png
        ├── extension-loaded.png
        ├── getting-started.png
        ├── rbi-usage.png
        ├── email-generation.png
        ├── file-viewing.png
        ├── prevention-layers.png
        ├── virustotal-flow.png
        ├── warning-dialog.png
        └── test-results.png

Contributing

NULL VOID is under active development and we need your help! Whether you're a developer, designer, security researcher, or just an enthusiast, there are many ways you can contribute to make this extension better.

We welcome all contributions to NULL VOID! Here's how you can help:

Ways to Contribute

  1. Report Bugs: Open an issue with detailed reproduction steps
  2. Suggest Features: Share your ideas for new functionality
  3. Submit Pull Requests: Fix bugs or implement new features
  4. Improve Documentation: Help make our docs better
  5. Security Research: Report vulnerabilities responsibly

Development Workflow

  1. Fork the repository
  2. Create a feature branch (git checkout -b feature/amazing-feature)
  3. Make your changes
  4. Test thoroughly
  5. Commit with clear messages (git commit -m 'Add amazing feature')
  6. Push to your fork (git push origin feature/amazing-feature)
  7. Open a Pull Request

Code Style Guidelines

  • Use meaningful variable names
  • Comment complex logic
  • Follow existing code structure
  • Test your changes
  • Update documentation as needed

License

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


Security

Reporting Vulnerabilities

If you discover a security vulnerability, please email security@anishalx.dev instead of using the issue tracker.

Security Features

  • All API keys are configurable
  • HTTPS-only connections
  • No data collection or tracking
  • Local storage only
  • Open source for transparency

Support

Get Help

FAQ

Q: Is NULL VOID free to use?
A: Yes, NULL VOID is completely free and open source.

Q: Does NULL VOID collect my data?
A: No, we don't collect any user data. All processing happens locally or through your direct API calls.

Q: Can I use NULL VOID in Firefox?
A: Not yet, but Firefox support is planned for future releases.

Q: How do I get a VirusTotal API key?
A: Sign up at VirusTotal for a free API key, then configure it in the extension settings.


Acknowledgments

  • VirusTotal for their comprehensive threat intelligence API
  • Mail.tm for disposable email services
  • Browserless.io for remote browser isolation technology
  • The open-source community for inspiration and support

Stats

GitHub stars GitHub forks GitHub issues GitHub license


Made with love by the NULL VOID Team

Back to Top

About

Cross-Browser Privacy Extension - The official url is https://nullvoid.zone.id

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published