PN Web OS Documentation
A comprehensive guide to using PN's privacy-focused browser-based operating system
Table of Contents
Additional Resources
Overview & Architecture
PN Web OS is a browser-based operating system that prioritizes user privacy and security. Built entirely with modern web technologies, it provides a full desktop experience without compromising your data.
Key Features
- • 18 Native Applications: System tools, productivity apps, communication, networking, and development tools
- • 49 Core Services: Comprehensive system services for security, networking, UI, file operations, and advanced features
- • Zero Cloud Dependency: All data stays in your browser
- • End-to-End Encryption: AES-256-GCM encryption for all stored data
- • No Telemetry: We never collect or transmit your data
- • WebAssembly Support: Compile and run C/C++/Rust code in the browser
- • Peer-to-Peer Communications: WebRTC-based decentralized messaging and file sharing
- • IPFS Integration: Decentralized storage and content addressing
- • Open Architecture: Built on standard web technologies
System Architecture
┌─────────────────────────────────────────┐ │ PN Web OS Desktop │ ├─────────────────────────────────────────┤ │ ┌──────────┐ ┌──────────┐ ┌──────────┐│ │ │ Apps │ │ Services │ │ Core ││ │ │ │ │ │ │ ││ │ │ Terminal │ │ Window │ │ Auth ││ │ │ Files │ │ Manager │ │ State ││ │ │ Browser │ │FileSystem│ │ Types ││ │ │ Settings │ │ Notif. │ │ Utils ││ │ └──────────┘ └──────────┘ └──────────┘│ ├─────────────────────────────────────────┤ │ Browser Storage Layer │ │ IndexedDB | LocalStorage | Memory │ └─────────────────────────────────────────┘
Getting Started
1. First Login
When you first access PN Web OS, you'll be prompted to create a secure account:
- • Choose a strong password (minimum 8 characters)
- • Your password is used to derive encryption keys
- • All data is encrypted locally - we never see your password
2. Desktop Interface
The desktop provides a familiar interface with:
- • Taskbar: Access running apps and system functions
- • Start Menu: Launch applications and search
- • Desktop Icons: Quick access to frequently used apps
- • Notification Center: System alerts and updates
3. Window Management
Windows can be:
- • Dragged by their title bar
- • Resized from corners and edges
- • Minimized, maximized, or closed
- • Arranged using keyboard shortcuts
3. System Applications
Core system utilities for managing your PN Web OS environment.
3.1 Terminal
A full-featured command line interface with advanced scripting capabilities and privacy tools.
File System Commands
- •
ls- List directory contents - •
cd [dir]- Change directory - •
pwd- Print working directory - •
cat [file]- Display file contents - •
mkdir [name]- Create directory - •
touch [name]- Create file - •
rm [name]- Remove file/directory
Privacy & System Commands
- •
encrypt [text]- Encrypt a message - •
decrypt [encrypted]- Decrypt a message - •
vpn- Show VPN status - •
privacy- Privacy shield status - •
ps- List running processes - •
uname- System information - •
date- Display current date/time
3.2 File Manager
Manage your encrypted files with an intuitive GUI featuring drag & drop, file search, and recycle bin.
Features
- • Grid and list view modes
- • Drag & drop file operations
- • Context menu (right-click)
- • Quick navigation breadcrumbs
- • File type associations
- • Full-text file search
Security
- • AES-256-GCM encryption for all files
- • Encrypted file metadata
- • Recycle bin with 30-day retention
- • Secure file deletion
- • File compression support
3.3 System Monitor
Real-time system monitoring with process management, resource usage tracking, and cleanup tools.
Monitoring
- • Real-time process list
- • CPU usage per process
- • Memory consumption tracking
- • Network activity monitoring
- • Storage usage statistics
Management
- • Process filtering and search
- • Export process data (JSON)
- • System cleanup utilities
- • Cache management
- • Performance optimization tips
3.4 Settings
Comprehensive system configuration center for privacy, security, appearance, and data management.
Privacy & Security
- • Auto-lock screen settings
- • Permission management
- • Audit log viewer
Appearance & System
- • Theme customization (dark/light)
- • Accessibility controls (WCAG 2.1)
- • Keyboard shortcuts configuration
- • Virtual desktop settings
- • Data export/import
3.5 Developer Tools
Advanced development environment with Python REPL, WASM sandbox, and module loading capabilities.
Features
- • Python REPL (browser-based)
- • WASM sandbox environment
- • Module loader for dependencies
- • Debug console access
- • Code execution logging
Security
- • Sandboxed execution environment
- • No filesystem access by default
- • Permission-based API access
- • Resource usage limits
- • Isolated memory space
4. Productivity Applications
Essential productivity tools for creating, viewing, and managing content.
4.1 Text Editor
Fast, lightweight text editor with syntax highlighting and multi-file support.
Features
- • Syntax highlighting for common languages
- • Multi-file tabs support
- • Auto-save functionality
- • Find and replace
- • Line numbers and code folding
- • Customizable themes
Supported Formats
- • Plain text (.txt)
- • Markdown (.md)
- • JavaScript/TypeScript (.js, .ts)
- • HTML/CSS (.html, .css)
- • JSON (.json)
- • Configuration files
4.2 Image Viewer
View and manipulate images with zoom, rotation, and basic filters.
Features
- • Zoom in/out with smooth scaling
- • Rotate images (90°, 180°, 270°)
- • Flip horizontal/vertical
- • Basic filters (brightness, contrast)
- • Full-screen mode
- • Image information display
Supported Formats
- • JPEG (.jpg, .jpeg)
- • PNG (.png)
- • GIF (.gif)
- • WebP (.webp)
- • SVG (.svg)
- • BMP (.bmp)
4.3 Calculator
Scientific calculator with history and keyboard shortcuts.
Functions
- • Basic arithmetic (+, -, ×, ÷)
- • Scientific functions (sin, cos, tan)
- • Logarithms and exponents
- • Square root and powers
- • Percentage calculations
- • Memory storage (M+, M-, MR, MC)
Features
- • Calculation history
- • Keyboard input support
- • Copy/paste results
- • Degrees/radians mode
- • Expression evaluation
- • Clear and undo functions
4.4 Notes
Encrypted note-taking app with rich text editing and Markdown support.
Features
- • Rich text editor
- • Markdown rendering support
- • Note organization with folders
- • Tags and labels
- • Full-text search
- • Export notes (text, markdown)
Security
- • AES-256-GCM encryption
- • Encrypted metadata
- • Auto-save with encryption
- • Local storage only
- • No cloud synchronization
- • Privacy-first design
4.5 Privacy Browser
Privacy-focused web browser with built-in ad/tracker blocking and fingerprint protection.
Privacy Features
- • Built-in ad blocker
- • Tracker blocking (100+ domains)
- • Automatic HTTPS upgrade
- • Fingerprint protection
- • Cookie isolation
- • Do Not Track header
Features
- • Tabbed browsing
- • Bookmark management
- • History tracking (optional)
- • Private browsing mode
- • Download manager
- • Reader mode
5. Communication Applications
Secure, encrypted communication tools using WebRTC for peer-to-peer connections.
5.1 Secure Messenger
End-to-end encrypted messaging with WebRTC peer-to-peer architecture.
Features
- • End-to-end encryption for all messages
- • WebRTC peer-to-peer connections
- • Contact public key verification
- • Message read receipts
- • Typing indicators
- • File attachment support
Security
- • RSA-2048 key exchange
- • AES-256 message encryption
- • No server message storage
- • Perfect forward secrecy
- • Peer identity verification
- • Decentralized architecture
5.2 Video Call
Peer-to-peer video calling with screen sharing and multi-party support.
Features
- • WebRTC video/audio streaming
- • Screen sharing capabilities
- • Multi-party video calls
- • Camera/microphone controls
- • Connection quality indicators
- • Call recording (local only)
Requirements
- • Camera/microphone permissions
- • STUN/TURN server access
- • Stable network connection
- • Modern browser with WebRTC
- • NAT traversal support
- • Encrypted media streams
5.3 P2P Chat
Fully decentralized peer-to-peer messaging with no server required.
Features
- • True peer-to-peer messaging
- • No central server required
- • Automatic peer discovery
- • Mesh network topology
- • Offline message queuing
- • Group chat support
Privacy Benefits
- • Zero metadata collection
- • No message history on servers
- • Direct peer connections
- • End-to-end encrypted
- • Anonymous peer IDs
- • Self-hosted architecture
6. Network Applications
Decentralized networking tools for file sharing, IPFS, and blockchain exploration.
6.1 P2P File Share
Peer-to-peer file transfer using WebRTC data channels with no file size limits.
Features
- • Direct peer-to-peer transfers
- • WebRTC data channels
- • No file size restrictions
- • Progress tracking
- • Resume interrupted transfers
- • Multiple concurrent transfers
Security
- • Encrypted data channels
- • Files never touch servers
- • Peer identity verification
- • Automatic file encryption
- • Secure connection establishment
- • Privacy-first design
6.2 IPFS Explorer
Browse and interact with the InterPlanetary File System (IPFS) for decentralized storage.
Features
- • Browse IPFS content by CID
- • Upload files to IPFS
- • Pin/unpin content
- • Gateway selection
- • Content preview
- • CID sharing and QR codes
Integration
- • Pinata pinning service
- • Web3.Storage support
- • Public gateway access
- • Content addressing
- • Immutable file storage
- • Decentralized CDN
6.3 Block Explorer
Blockchain explorer for Bitcoin and Ethereum with transaction lookup and address monitoring (read-only).
Features
- • Bitcoin blockchain explorer
- • Ethereum blockchain explorer
- • Transaction lookup by hash
- • Address balance checking
- • Block information display
- • Network statistics
Important Notes
- • Read-only access
- • No wallet functionality
- • No transaction broadcasting
- • Public API integration
- • Educational/monitoring purposes
- • Real-time blockchain data
7. Security Applications
Advanced security tools for password management and credential storage.
7.1 Vault (Password Manager)
Comprehensive encrypted password manager with secure notes, credit cards, and password generation.
Features
- • Password storage & organization
- • Secure notes
- • Credit card information storage
- • Password generator (customizable)
- • Password strength analyzer
- • Search and filtering
Security
- • AES-256-GCM encryption
- • Master password protection
- • Auto-lock after inactivity
- • Encrypted import/export
- • Client-side encryption
- • Local storage only
8. Development Applications
Advanced development tools with WebAssembly compilation capabilities.
8.1 Code Editor (WASM IDE)
WebAssembly-powered integrated development environment for C, C++, and Rust with real-time compilation.
Features
- • C/C++/Rust code editing
- • Real-time WASM compilation
- • Syntax highlighting
- • Code execution in sandbox
- • Error highlighting & debugging
- • Multiple file projects
Supported Languages
- • C (via Emscripten/WASI)
- • C++ (via Emscripten)
- • Rust (via wasm-pack)
- • WebAssembly Text Format (WAT)
- • Sandboxed execution
- • Browser-native compilation
9. Services Reference
PN Web OS includes 49 core services organized into 7 categories providing comprehensive system functionality.
9.1 Core System Services (10)
Manages all application windows (create, close, minimize, maximize, z-index, drag, resize)
Encrypted file system with read/write/delete operations, directory management, and AES-256-GCM encryption
IndexedDB storage backend for persistent data storage in browser
Command-line interpreter for Terminal with 20+ built-in commands
Process tracking, CPU/memory monitoring, and application lifecycle management
System-wide notifications (system, info, warning, error levels)
Permission management system for app capabilities and resource access
Auto-lock functionality with configurable inactivity timeout
9.2 Security & Cryptography Services (5)
AES-256-GCM encryption/decryption, PBKDF2 key derivation (600,000 iterations), hashing
Secure password storage with generation, strength analysis, and encrypted vault
Security audit logging for system events and user actions
Runtime permission checking and enforcement
Feature flag system for enabling/disabling functionality (tier-based access)
9.3 Networking Services (6 active, 3 placeholder)
WebRTC peer-to-peer networking with PeerJS (v1.5.5), STUN/TURN support, NAT traversal
IPFS integration for decentralized storage (Pinata, Web3.Storage)
File synchronization service (client-side ready, backend not implemented)
Network stack management and configuration
Web3 blockchain API (not active, reserved for future use)
Bitcoin API integration (not active, reserved for future use)
DeFi protocol API (not active, reserved for future use)
9.4 File Operations Services (6)
File type associations for auto-opening files with appropriate apps
File compression/decompression using browser native APIs
Full-text file search with indexing and metadata search
Temporary file storage with 30-day retention and restore functionality
Terminal command history with search and persistence
Right-click context menu system for files and UI elements
9.5 UI & Accessibility Services (9)
Global keyboard event handling and input management
Customizable keyboard shortcuts for system and app actions
Touch input handling for mobile/tablet devices
Multi-touch gesture recognition (pinch, swipe, rotate)
WCAG 2.1 AA accessibility features (screen reader support, keyboard navigation, high contrast)
Window snapping to screen edges (left/right/maximize)
Multiple workspace support for window organization
Quick access panel for common settings and toggles
Privacy controls (Do Not Track, auto-delete history, telemetry off)
9.6 Advanced Services (4)
WebAssembly runtime environment for executing WASM modules
WASM compilation service for C/C++/Rust (Emscripten, wasm-pack)
System cleanup utilities for cache, temp files, and optimization
Account recovery options and backup code management
9.7 Infrastructure Services (3)
Service initialization and dependency management (server-side)
Client-side service initialization and bootstrapping
Central service registry and dependency injection
10. Advanced Features
Cutting-edge technologies and advanced capabilities that set PN Web OS apart.
10.1 WebAssembly Compilation
Compile and execute C, C++, and Rust code directly in your browser using WebAssembly.
- • WASM runtime environment
- • C/C++ via Emscripten
- • Rust via wasm-pack
- • Real-time compilation in Code Editor
- • Sandboxed execution
- • No server-side compilation needed
- • Browser-native performance
- • Memory-safe execution
- • Resource usage limits
- • Debugging support
10.2 Peer-to-Peer Communications
WebRTC-based decentralized communication eliminating the need for centralized servers.
Technology
- • WebRTC for media/data channels
- • PeerJS v1.5.5 library
- • STUN/TURN servers for NAT traversal
- • ICE candidate exchange
Applications
- • Secure Messenger
- • Video Call
- • P2P Chat
- • P2P File Share
10.3 IPFS Integration
InterPlanetary File System integration for decentralized, immutable file storage.
- • Content-addressed storage (CID)
- • Immutable file references
- • Pin/unpin content
- • Gateway access (public/private)
- • Pinata pinning service
- • Web3.Storage integration
- • Decentralized CDN
- • Persistent availability
10.4 Encryption & Privacy
Military-grade encryption and client-side security for maximum privacy.
Encryption Standards
- • AES-256-GCM for file/data encryption
- • PBKDF2 key derivation (600,000 iterations)
- • RSA-2048 for key exchange
- • SHA-256 hashing
Privacy Architecture
- • Privacy-first design
- • Client-side encryption only
- • No cloud data storage
- • Local-only processing
10.5 Virtual Desktops
Multiple workspace support for organizing windows across different contexts.
- • Multiple independent workspaces
- • Window organization by task/project
- • Keyboard shortcuts for switching
- • Persistent workspace state
- • Per-desktop wallpapers
- • Smooth transitions
11. Security & Privacy
Privacy-First Architecture
PN Web OS implements a privacy-first architecture:
- • All encryption happens client-side in your browser
- • Your master password never leaves your device
- • We cannot access your data even if we wanted to
- • No cloud servers store your information
Encryption Standards
File Encryption
AES-256-GCM with PBKDF2 key derivation (600,000 iterations)
Message Encryption
End-to-end encryption using RSA-2048 for key exchange with AES-256 for message content
Password Storage
Encrypted vault with additional master password protection
Privacy Controls
- • Do Not Track: DNT header sent with all requests
- • Auto-delete History: Configurable automatic history cleanup
- • No Telemetry: Zero data collection or transmission
- • Local-only Data: All data stays in browser (IndexedDB)
- • Encrypted Storage: All persistent data encrypted at rest
Compliance & Standards
- • WCAG 2.1 AA: Accessibility compliance for all users
- • Privacy by Design: Privacy-first architecture from the ground up
- • GDPR-friendly: No personal data collection or processing
- • Browser Sandbox: Isolated execution environment security
- • Open Standards: WebRTC
12. File System & Encryption
The PN Web OS file system provides a secure, encrypted storage solution that runs entirely in your browser. All files are encrypted before storage and decrypted on-demand.
File System Features
- • Encrypted Storage: AES-256-GCM encryption
- • File Compression: Native browser compression APIs
- • Full-text Search: Indexed search with metadata
- • Recycle Bin: 30-day retention for deleted files
- • File Associations: Auto-open with appropriate apps
- • Context Menus: Right-click file operations
Storage Backend
- • IndexedDB: Browser-native persistent storage
- • No Limits: Storage quota based on available disk space
- • Local Only: Data never leaves your device
- • Encrypted Metadata: File names and attributes encrypted
- • ACID Transactions: Reliable data integrity
- • Fast Access: Optimized for performance
File System Structure
/
├── home/
│ └── user/
│ ├── Documents/
│ ├── Downloads/
│ ├── Pictures/
│ └── .config/
└── system/
└── apps/Terminal Commands
| Command | Description |
|---|---|
| ls | List directory contents |
| cd [dir] | Change directory |
| pwd | Print working directory |
| cat [file] | Display file contents |
| mkdir [name] | Create directory |
| touch [name] | Create file |
| rm [name] | Remove file or directory |
| encrypt [text] | Encrypt a message |
| decrypt [encrypted] | Decrypt a message |
| vpn | Show VPN status |
| privacy | Show privacy shield status |
13. Development Guide
Creating a New Application
To create a new application for PN Web OS:
- Create a new component in
/lib/webos/apps/ - Implement the
AppComponentPropsinterface - Register the app in the desktop applications array
- Add appropriate icon and metadata
Application Template
'use client'
import { AppComponentProps } from '@/lib/webos/types'
import { useWebOS } from '@/lib/webos/context/WebOSContext'
export default function MyApp({ window }: AppComponentProps) {
const webos = useWebOS()
return (
<div className="h-full bg-pn-gray-900">
<h1 className="text-white p-4">My Application</h1>
</div>
)
}Complete API Reference
fileSystem
Encrypted file system operations
- •
readFile(path)- Read file contents - •
writeFile(path, data)- Write file data - •
mkdir(path)- Create directory - •
rm(path)- Remove file/directory - •
ls(path)- List directory contents - •
encrypt(data, password)- Encrypt data - •
decrypt(encrypted, password)- Decrypt data
windowManager
Window creation and management
- •
createWindow(app)- Create new window - •
closeWindow(id)- Close window - •
minimizeWindow(id)- Minimize window - •
maximizeWindow(id)- Maximize/restore window - •
snapWindow(id, position)- Snap to edge - •
bringToFront(id)- Focus window
notificationService
System notifications
- •
system(message)- System notification - •
info(message)- Info notification - •
warn(message)- Warning notification - •
error(message)- Error notification
processManager
Process lifecycle and monitoring
- •
startProcess(name, metadata)- Start process - •
stopProcess(pid)- Stop process - •
listProcesses()- Get all processes - •
getProcessInfo(pid)- Get process details
crypto
Cryptography operations
- •
encrypt(data, key)- AES-256-GCM encryption - •
decrypt(encrypted, key)- AES-256-GCM decryption - •
hash(data)- SHA-256 hashing - •
deriveKey(password, salt)- PBKDF2 key derivation
permissions
Permission management
- •
request(permission)- Request permission - •
check(permission)- Check if granted - •
revoke(permission)- Revoke permission
WebOS Context Hook
Access WebOS services using the useWebOS() hook:
const webos = useWebOS()
// Access services
webos.fileSystem.readFile('/home/user/file.txt')
webos.notificationService.info('Hello World')
webos.windowManager.createWindow(myApp)
// Access user state
const { username, tier } = webos.userAccount & Authentication
Learn about the different ways to access PN Web OS, account creation, mode switching, and security features.
Getting Started
Interactive mode chooser to help you select the best access mode for your needs.
Account Modes
Detailed explanations of Demo, Free-Instant, Free Account, and Premium modes.
FAQ
Common questions about accounts, modes, data storage, and security features.
Quick Reference
Printable quick reference guide with mode comparison and essential information.
Security Documentation
Deep dive into our security architecture, encryption model, account recovery process, and cryptographic implementation details.
Technical Analysis
Comprehensive technical breakdown of PN Web OS architecture, performance analysis, and implementation strategies.
PN Web OS Documentation v1.1.0
Launch Web OS →