LunarWolf Browser
if you consider supporting me, please donate to my cashapp
> ## Notice
>The support for this project has ended, i am working on something better
If your looking for the perfect Framework for your next web browser build, then look no further because your search is over, i have been in your situation of searching for a electron browser base project that isent old or depricated, so i took the time to re create a browser-base project we all know and loved (see the [License](#license) section).
This Browser is a fork of the wexond Browser Basse project, which can be found [`here`](https://github.com/ironiumstudios/browser-base)
Table of Contents:
Motivation
Compiling and editing Chromium directly may be challenging and time consuming, so we decided to build LunarWolf with modern web technologies. Hence, the development effort and time is greatly reduced. Either way Firefox is based on Web Components and Chrome implements new dialogs in WebUI (which essentially is hosted in WebContents).
Features
- LunarWolf Shield - Browse the web without any ads and don't let websites to track you. Thanks to the LunarWolf Shield powered by Cliqz, websites can load even 8 times faster!
- Chromium without Google services and low resources usage - Since LunarWolf uses Electron under the hood which is based on only several and the most important Chromium components, it's not bloated with redundant Google tracking services and others.
- Fast and fluent UI - The animations are really smooth and their timings are perfectly balanced.
- Highly customizable new tab page - Customize almost an every aspect of the new tab page!
- Customizable browser UI - Choose whether LunarWolf should have compact or normal UI.
- Tab groups - Easily group tabs, so it's hard to get lost.
- Scrollable tabs
- LunarWolf supports Chrome extensions - Install some extensions directly from Chrome Web Store, otherwise follow the documentation on installing custom extensions* View the full documentation for installing the extensions
here
Other basic features
- Downloads popup with currently downloaded items (download manager WebUI page is WIP)
- History manager
- Bookmarks bar & manager
- Settings
- Find in page
- Dark and light theme
- Omnibox with autocomplete algorithm similar to Chromium
- State of the art tab system
Instructions for setting up your build environment for windows, Linux and mac os
- if your starting on linux or mac os this is the following command below before installing npm
sudo apt update # Checks for the latest version
- Now for installing npm on mac os and linux run the following command in your terminal
sudo apt install npm # this command will install npm for linux and mac os
-
To Help you keep track of all your versions and make things a little easier for you, Download nvm (Node Version Manegar) from here
-
after installing NVM Run your terminal or Command Prompt, then type the following command
nvm install 22.5.1 # this installed the compatible version of node.js for this project
after installing the correct version of node.js we want the nvm to use this version as its main defalt version slot, you can do this by running
nvm use 22.5.1 # sets the version you specified as defalt if your on windows but this command is also required to be ran on linux and mac os as well
and if your using linux or mac os run this command alongsize the other one
nvm alias default 22.5.1 # Sets the node version as the main defalt alias on linux and mac os
make sure you have the 31.2.1 version of electron installed, you can do so by running this command in your terminal or command prompt
npm install -g electron@31.2.1
- Next up is installing yarn package manegar, which you can find from
here
Note: New Versions of Node.js No Longer Need Windows Build Tools Alongside it, because node already includes them out of the box
Building and Running Commands for Linux, mac os, and windows
Now in the main LunarWolf-main folder run the commands below
yarn install # Install needed depedencies.
yarn run build # Builds native modules using Electron headers.
yarn run rebuild # Rebuilds native modules using Electron headers.
yarn run start # Starts the LunarWolf App
Compiling and yarn lint Commands for Windows
yarn compile-win32 # Package LunarWolf for Windows
yarn lint # Runs linter
yarn lint-fix # Runs linter and automatically applies fixes
Compiling and yarn lint Commands for Linux and mac os
$ yarn compile-linux # Package LunarWolf for Linux
$ yarn compile-darwin # Package LunarWolf for macOS
More commands can be found in package.json
.
Documentation
Guides and the API reference are located in docs
directory.
License
This Project Uses a MIT License, Which is free.