osnr/TabFS
TabFS
TabFS is a browser automation tool and virtual filesystem that maps browser tabs and page elements to files. It provides a FUSE-based bridge that allows external scripts and tools to interact with a browser's JavaScript runtime through standard file system operations.
The system enables the execution of JavaScript expressions and the manipulation of DOM elements by reading and writing synthetic files. Users can control tab state, create new tabs, and inspect metadata such as URLs and titles using a file manager or shell.
The project covers capabilities for browser automation, including accessing page input fields and extracting page resources. It also supports browser extension development by allowing extensions to be reloaded via shell scripts.
Features
- Browser Automation Tools - Implements a programmable interface for controlling web browsers and extracting data using filesystem operations.
- FUSE Virtual Filesystems - Provides a FUSE-based virtual filesystem that maps browser tab states and controls to a directory structure.
- Live Page Content Extraction - Provides a way to extract variables, input values, and page resources from live browser tabs via virtual files.
- Browser Automation - Provides a framework for controlling browsers and executing JavaScript using standard file system operations.
- DOM-to-File Mappings - Represents browser DOM elements and internal page variables as individual read-write files within a virtual directory.
- Filesystem-to-Process Dispatchers - Translates filesystem write operations into JavaScript execution calls sent to specific browser tab contexts.
- Browser Runtime Virtual Filesystems - Maps browser tabs and page elements to a virtual filesystem for management via standard shell operations.
- Path-to-Resource Resolvers - Routes filesystem requests to the correct browser tab by parsing directory paths into unique tab identifiers.
- JavaScript Execution Bridges - Provides a bridge to execute JavaScript expressions and manipulate DOM elements through a filesystem interface.
- Tab JavaScript Executors - Runs scripts or evaluates expressions within a specific tab by writing to a virtual directory.
- Tab-to-Filesystem Mounts - Exposes open tabs as a virtual directory to manage tab data using standard file system operations.
- Bidirectional WebView Bridges - Implements a bidirectional communication bridge between the host filesystem and the browser's JavaScript runtime.
- Page Asset Extractors - Retrieves images, scripts, and assets from a page as files in a virtual subdirectory.
- FUSE-Based Filesystem Mounts - Uses FUSE to expose the browser's internal state as a mounted directory on the operating system.
- Runtime Expression Evaluation - Enables real-time execution of JavaScript expressions within a running browser environment to inspect state.
- Runtime State Serializers - Converts live browser metadata like URLs and titles into text-based file contents for external tool access.
- Tab Metadata Inspectors - Provides the ability to read or modify URLs, titles, and active status of open tabs via virtual files.
- Input Field Manipulations - Provides low-level operations for filling and manipulating web page input fields via virtual files.
- Tab Lifecycle Controllers - Controls the lifecycle and state of browser tabs, including navigation and reloads.
- Tab Openers - Allows programmatically opening new browser tabs by writing target URLs to virtual files.
- Tab Managers - Manages the lifecycle of open tabs, including organization and deletion, via file manager operations.
- Headless Browser Controllers - Provides a control layer to manage headless browser instances and page content via a virtual directory.
