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)

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.

IroniumStudios / LunarWolf-Browser

readme