|
1 | 1 | <h1 align="center"> |
2 | 2 |
|
3 | | - |
| 3 | + |
4 | 4 |
|
5 | 5 | [Extract CRX](https://MainRoute-Core.github.io/Extract-CRX/) |
6 | 6 |
|
7 | 7 | </h1> |
8 | 8 |
|
9 | | -Effortlessly **download** or **convert** source code for browser extensions with **Extract CRX**. |
| 9 | +Effortlessly **download**, **explore**, and **audit** source code for browser extensions with **Extract CRX**. |
10 | 10 |
|
11 | | -Whether it's for **Chrome**, **Firefox**, **Edge**, or **Opera**, simply enter the extension ID or URL, select your desired format, and download the extension with ease or upload a CRX/XPI file to convert it to ZIP. |
| 11 | +Whether it's for **Chrome**, **Firefox**, **Edge**, or **Opera**, simply enter the extension ID or URL, select your desired format, and download the extension with ease, or upload a local CRX/XPI file to inspect and convert it. |
| 12 | + |
| 13 | +--- |
12 | 14 |
|
13 | 15 | ## 🚀 Features |
14 | 16 |
|
15 | | -- **Multi-Browser Stores Support**: |
16 | | - - **Chrome Web Store** → Google Chrome |
17 | | - - **Mozilla Add-ons** → Firefox |
18 | | - - **Microsoft Edge Add-ons** → Edge |
19 | | - - **Opera Add-ons** → Opera |
20 | | - - Also supports **Allizom**, **Dev.Allizom**, and **Thunderbird** domains for Firefox. |
21 | | -- **Smart Browser Detection**: Automatically detects the browser from the extension URL. |
22 | | -- **CRX & XPI to ZIP Conversion**: Upload CRX/XPI files and convert them to ZIP. |
23 | | -- **Flexible Download Formats**: Download as CRX, XPI, or ZIP. |
24 | | -- **Keyboard Shortcuts**: Press `/` to quickly focus on the input field. |
25 | | -- **Simple & Clean Interface**: A sleek glassmorphic UI for a modern experience. |
| 17 | +### 📥 Multi-Store Downloader |
| 18 | +- **Universal URL Parsing**: Input raw extension URLs from the Chrome Web Store, Mozilla Add-ons, Microsoft Edge Add-ons, or Opera Add-ons. |
| 19 | +- **Auto-Browser Detection**: Automatically recognizes the target browser from the pasted URL. |
| 20 | +- **Format Flexibility**: Download packages in their native formats (`.crx`, `.xpi`) or package them as a standard `.zip` file. |
| 21 | +- **CORS Fallback Proxy**: Includes a bypass option (`Route via CORS Fallback Proxy`) to fetch assets when standard browser requests are blocked by CORS policies. |
26 | 22 |
|
27 | | -## 🔹 How To Use |
| 23 | +### 📁 In-Browser File Explorer |
| 24 | +- **Interactive Directory Tree**: Browse the internal structure of any uploaded `.crx` or `.xpi` package without extracting files to your local machine. |
| 25 | +- **Dynamic File Filtering**: Search for specific files inside the package tree with real-time filtering. |
| 26 | +- **Asset Download**: Export individual files from the extension tree directly to your disk. |
| 27 | + |
| 28 | +### 🔍 Code & Media Viewer |
| 29 | +- **Syntax Highlighting**: View source code (JavaScript, JSON, CSS, HTML) with native coloring powered by PrismJS. |
| 30 | +- **Interactive Code Search**: Search within files with live highlight markers and match counters. |
| 31 | +- **Code Beautifier**: De-minify and format compressed JavaScript, JSON, or CSS layouts with one click. |
| 32 | +- **Visual Asset Previewer**: Preview images (PNG, JPG, GIF, WEBP, ICO, SVG) with auto-calculated pixel dimensions and file type readouts. |
| 33 | + |
| 34 | +### 🛡️ Manifest Security & Migration Audit |
| 35 | +- **Risk Assessment**: Analyzes the extension's declared permissions and rates the overall risk level (Low, Medium, or High). |
| 36 | +- **Permission Breakdown**: Explains exactly what each permission can access in plain language. |
| 37 | +- **Manifest V3 Migration Guide**: Identifies deprecated Manifest V2 declarations (such as background scripts, blocking web requests, or browser actions) and recommends equivalent Manifest V3 updates. |
28 | 38 |
|
29 | | -### **📥 Downloading Extensions** |
| 39 | +### 🕰️ local Extraction History |
| 40 | +- **Access Logs**: Keeps track of your last 20 downloaded extensions in a locally cached dashboard. |
| 41 | +- **Quick Re-extraction**: Re-download or audit previous extensions with a single click. |
30 | 42 |
|
31 | | -1. Enter the **extension ID** or **URL**. |
32 | | -2. Select a **browser**. |
33 | | -3. Choose the **format** (CRX, ZIP, or XPI). |
34 | | -4. Click **Start Download** to get the source file. |
| 43 | +--- |
35 | 44 |
|
36 | | -### **🔄 Converting CRX/XPI to ZIP** |
| 45 | +## ⌨️ Keyboard Shortcuts |
| 46 | + |
| 47 | +Improve your workflow with built-in keyboard actions: |
| 48 | +* Press `/` to automatically navigate to the **Extract** tab and focus on the input bar. |
| 49 | +* Use `Left Arrow` or `Right Arrow` to switch active tabs when focused on the tab bar. |
| 50 | + |
| 51 | +--- |
| 52 | + |
| 53 | +## 🔹 How To Use |
37 | 54 |
|
38 | | -1. Drag & drop or select a `.crx` or `.xpi` file. |
39 | | -2. Click **Convert and Download**. |
40 | | -3. The ZIP file will be generated and downloaded. |
| 55 | +### **1. Downloading Extension Source Files** |
| 56 | +1. Paste the **extension ID** or **URL** into the input field. |
| 57 | +2. The correct browser and metadata card will be generated automatically. |
| 58 | +3. Select your desired format (e.g., `ZIP` or `CRX`). |
| 59 | +4. Click **Start Download** (toggle the *CORS Fallback Proxy* if the direct download is blocked). |
41 | 60 |
|
42 | | -## ❗ Important Notes |
| 61 | +### **2. Inspecting or Converting a Package** |
| 62 | +1. Drag and drop any `.crx` or `.xpi` file anywhere on the interface (or select it from the **Convert** tab). |
| 63 | +2. Browse the extracted file system using the directory tree. |
| 64 | +3. Click any text or image file to open the interactive code viewer and audit permissions inside the security panel. |
| 65 | +4. Click **Convert and Download** to package the entire source directory into a standard `.zip` archive. |
43 | 66 |
|
44 | | -- 🚫 ZIP downloads are restricted due to CORS policies in Chrome, Edge, Opera and Thunderbird. |
45 | | -- 🛠️ Use the new "**Convert to ZIP**" feature by uploading a `.crx` or `.xpi` file. |
| 67 | +--- |
46 | 68 |
|
47 | 69 | ## 📜 License |
48 | 70 |
|
49 | 71 | 📄 Licensed under the Apache License v2.0 |
50 | | -© 2026 [MainRoute Core](https://MainRoute-Core.github.io/) |
| 72 | +© 2026 [MainRoute Core](https://MainRoute-Core.github.io/) |
0 commit comments