| .cursor/rules | ||
| .github | ||
| .DS_Store | ||
| .gitignore | ||
| config.js | ||
| crx-extractor.js | ||
| download.png | ||
| extensions-preload.js | ||
| extensions.html | ||
| forge.config.js | ||
| index.html | ||
| itworks.html | ||
| libbrowz.js | ||
| LICENSE | ||
| logo.png | ||
| main.js | ||
| package-lock.json | ||
| package.json | ||
| preload.js | ||
| README.md | ||
| renderer.js | ||
| sneedium-maker-mac.sh | ||
| sneedium-maker.sh | ||
| styles.css | ||
Sneedium
A basic web browser in Electron. With a functioning adblocker, privacy redirection technologies, and Chrome extension support!
Testing, compiling, and creation notes
To clone and run this repository you'll need Node.js (which comes with npm) installed on your computer. From your command line:
# Install dependencies
npm install
# Run the app
npm start
# Run in development mode (with dev tools)
npm run dev
Supports compiling via electron packager. Install and run it with:
npm install --save-dev electron-packager
npm run make
Keep in mind you also need a copy of the WINE project and need to be on Linux.
A basic Electron application needs just these files:
package.json- Points to the app's main file and lists its details and dependencies.main.js- Starts the app and creates a browser window to render HTML. This is the app's main process.index.html- A web page to render. This is the app's renderer process.preload.js- A content script that runs before the renderer process loads.
Chrome Extension Support
Sneedium now supports loading and using Chrome extensions. Extensions are managed through a dedicated Extension Manager interface:
- Click the extension button (🧩) in the browser toolbar to open the extension manager
- Install extensions by clicking the "Install Extension" button and selecting a .crx file
- Extensions are stored in the
SneedExtensionsfolder in your home directory - You can also manually install extensions by unpacking them into subdirectories of the
SneedExtensionsfolder
Note: Not all Chrome extensions may work perfectly due to API differences between Chrome and Electron. Features like sync and Chrome Web Store integration are not supported.
License
Disclaimer
"Insider's Look" builds are outdated. If you want changes, compile it or download the new binaries.
What is Privacy Redirection Technology (PRT)?
This is a simple technology that replaces a bad URL with a more privacy friendly service, when we know that ADs aren't 100% blocked, or just to provide a better UX. TLDR: Clickjacking for the greater good. This will NEVER use affilate links or whatnot, and how it works can be seen here.