Skip to content

Commit c68274c

Browse files
committed
Update README.md
1 parent 134247d commit c68274c

1 file changed

Lines changed: 50 additions & 28 deletions

File tree

README.md

Lines changed: 50 additions & 28 deletions
Original file line numberDiff line numberDiff line change
@@ -1,50 +1,72 @@
11
<h1 align="center">
22

3-
![Extract CRX](icons/192.png)
3+
![Extract CRX](https://MainRoute-Core.github.io/Extract-CRX/icons/192.png)
44

55
[Extract CRX](https://MainRoute-Core.github.io/Extract-CRX/)
66

77
</h1>
88

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**.
1010

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+
---
1214

1315
## 🚀 Features
1416

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.
2622

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.
2838

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.
3042

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+
---
3544

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
3754

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).
4160

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.
4366

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+
---
4668

4769
## 📜 License
4870

4971
📄 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

Comments
 (0)