{"id":17685921,"url":"https://github.com/felipealfonsog/novanav","last_synced_at":"2025-06-12T11:04:23.851Z","repository":{"id":224144726,"uuid":"762546609","full_name":"felipealfonsog/NovaNav","owner":"felipealfonsog","description":"NovaNav: Lightweight browser, delivering fast, distraction-free browsing experience. It offers essential browsing functionalities while focusing on simplicity and efficiency.","archived":false,"fork":false,"pushed_at":"2024-09-03T03:36:14.000Z","size":2607,"stargazers_count":8,"open_issues_count":1,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-05-08T20:28:52.377Z","etag":null,"topics":["browser","browsing","distraction-free","fast","lightweight","minimalistic"],"latest_commit_sha":null,"homepage":"","language":"C++","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-3-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/felipealfonsog.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null},"funding":{"github":["felipealfonsog"],"patreon":"felipealfonsogl","custom":["https://www.buymeacoffee.com/felipealfonsog"]}},"created_at":"2024-02-24T02:44:39.000Z","updated_at":"2024-09-03T03:36:18.000Z","dependencies_parsed_at":"2024-03-27T06:24:22.446Z","dependency_job_id":"f0674f0b-d277-42c5-8df9-2db59314e163","html_url":"https://github.com/felipealfonsog/NovaNav","commit_stats":null,"previous_names":["felipealfonsog/novanav"],"tags_count":10,"template":false,"template_full_name":null,"purl":"pkg:github/felipealfonsog/NovaNav","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/felipealfonsog%2FNovaNav","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/felipealfonsog%2FNovaNav/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/felipealfonsog%2FNovaNav/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/felipealfonsog%2FNovaNav/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/felipealfonsog","download_url":"https://codeload.github.com/felipealfonsog/NovaNav/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/felipealfonsog%2FNovaNav/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":259453488,"owners_count":22860084,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["browser","browsing","distraction-free","fast","lightweight","minimalistic"],"created_at":"2024-10-24T10:29:29.022Z","updated_at":"2025-06-12T11:04:23.776Z","avatar_url":"https://github.com/felipealfonsog.png","language":"C++","funding_links":["https://github.com/sponsors/felipealfonsog","https://patreon.com/felipealfonsogl","https://www.buymeacoffee.com/felipealfonsog","https://www.paypal.me/felipealfonsog"],"categories":[],"sub_categories":[],"readme":"#### NovaNav - Super Lightweight Browser 🌐 \n\nNovaNav: Lightweight browser delivering a fast, distraction-free browsing experience for Linux (AUR package available \u0026 Bash installer for Arch \u0026 Debian), working smoothly. During the Bash installation, you can choose macOS, but it is not stable yet. It offers essential browsing functionalities while focusing on simplicity and efficiency. This is my own version of Arc Browser, mostly for Linux, keeping in mind the proportions because it's a project done solely by me from scratch.\n\n \u003cimg src=\"./images/icons/icon-small.png\" alt=\"NovaNav-Logo\" width=\"68\" height=\"68\"\u003e\n\nNovaNav was inspired by Arc Browser due to its minimalist interface. However, there is no version of Arc available for Linux. Therefore, I wanted to create a minimalist and distraction-free web browser, which is the essence of this project. NovaNav offers essential browsing functionalities while focusing on complete simplicity and efficiency. With NovaNav, users can effortlessly navigate the web, open multiple tabs, and adjust zoom settings for optimal viewing using the keyboard. The browser's clean interface and intuitive design make it ideal for users who prefer a clutter-free browsing experience. By minimizing distractions and prioritizing essential features, NovaNav aims to provide a seamless and enjoyable web browsing experience.\n\n[![Download Install NovaNav](https://custom-icon-badges.demolab.com/badge/Install-NovaNav%20Browser-blue.svg?style=for-the-badge\u0026logo=nnav-mini-icon\u0026logoColor=white)](https://github.com/felipealfonsog/NovaNav#installation)\n\n\u003c!--\n[![Install NovaNav](https://img.shields.io/badge/Install-NovaNav%20Browser-purple?style=for-the-badge)](https://github.com/felipealfonsog/NovaNav#installation)\n--\u003e\n\n\u003csub\u003e* This is currently an experimental phase where the primary focus is on making the system functional and establishing a practical and logical pathway that aligns with both my vision and the project's goals. It might contain errors, bugs, etc. Many other non-core elements of the project are considered secondary.\u003c/sub\u003e\n\n![Version](https://img.shields.io/github/release/felipealfonsog/NovaNav.svg?style=flat\u0026color=blue)\n![Main Language](https://img.shields.io/github/languages/top/felipealfonsog/NovaNav.svg?style=flat\u0026color=blue)\n[![Open Source? Yes!](https://badgen.net/badge/Open%20Source%20%3F/Yes%21/blue?icon=github)](https://github.com/Naereen/badges/)\n\n\n[![BSD 3-Clause License](https://img.shields.io/badge/License-BSD%203--Clause-blue.svg)](https://opensource.org/licenses/BSD-3-Clause)\n\n\u003c!--\n[![GPL license](https://img.shields.io/badge/License-GPL-blue.svg)](http://perso.crans.org/besson/LICENSE.html)\n--\u003e\n\n[![Vim Powered](https://img.shields.io/badge/Vim-Powered-%2311AB00.svg?logo=vim\u0026logoColor=white)](https://www.vim.org)\n[![VS Code Powered](https://img.shields.io/badge/VS%20Code-Powered-%23007ACC.svg?logo=visualstudiocode\u0026logoColor=white)](https://code.visualstudio.com/)\n\n\n#\n\n#### Screenshots\n\n[![View Screenshots](https://img.shields.io/badge/View-Screenshots-green)](#)\n\n#### Screenshot Linux\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"./images/novanav-cpp/sshot-linux-novanav-cpp.png\" alt=\"Screenshot Linux\" width=\"400\" height=\"350\"\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"./images/novanav-cpp/sshot-linux-novanav-cpp_2.png\" alt=\"Screenshot Linux\" width=\"400\" height=\"350\"\u003e\n\u003c/p\u003e\n\n\u003c!-- \n#### Screenshot macOS\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"./images/macos/sshot-2.png\" alt=\"Screenshot macOS\" width=\"400\" height=\"350\"\u003e\n\u003c/p\u003e\n\n--\u003e\n\n#\n\n#### Packages needed:\n\nIf you're using Arch Linux, you can find NovaNav Browser in your program menu after installation!\n\nC++ Version:\n\n  - qt5-base\n  - qt5-webengine\n\n\n#\n\n#### Installation\n#### Via AUR using YAY (Version written in C++)\n\n[![NovaNav in C++](https://img.shields.io/badge/NovaNav-C++%20Version-EE6352)](#)\n\n[![AUR](https://img.shields.io/aur/version/novanav)](https://aur.archlinux.org/packages/novanav)\n\n\u003c!-- \n[![AUR](https://img.shields.io/aur/version/novanav.svg)](https://aur.archlinux.org/packages/novanav)\n--\u003e\n\nhttps://aur.archlinux.org/packages/novanav\n\nNovaNav Browser is available on AUR (Arch User Repository), and it can be installed using the `yay` package manager. Follow the steps below to install NovaNav:\n\n1. Make sure you have `yay` installed. If not, you can install it with the following command:\n   \n   ```\n   sudo pacman -S yay\n   ```\n   \n   Once yay is installed, you can install by running the following command:\n   \n   ```\n   yay -S novanav\n   ```\n\nThis command will automatically fetch the package from AUR and handle the installation process for you.\nYou can find NovaNav Browser in your program menu!\n\n\n#\n\n#### Bash Installer 🚀 for Linux (Arch and Debian) - macOS*: (Version written in C++)\n\n[![Bash Installer Version](https://img.shields.io/badge/Bash%20Installer%20Version-Available-brightgreen)](#)\n\n#### To Install it: \n\nTo install NovaNav, simply run the installer script available [here](https://github.com/felipealfonsog/NovaNav/raw/main/installer.sh).\n\nOr just Copy - Paste in your terminal and use -curl- to start downloading the installer:\n\n   ```\n   curl -O https://raw.githubusercontent.com/felipealfonsog/NovaNav/main/installer.sh\n   ```\n\nIf you want to use -wget- just copy/paste this line:\n\n   ```\n   wget https://github.com/felipealfonsog/NovaNav/raw/main/installer.sh\n   ```\n\n   On macOS to download - wget - just install it with Homebrew:\n\n   ```\n   brew install wget\n   ```\n\n#### Important note when installing:\n\nIf you encounter issues executing the file in the terminal, like this message \"-bash: ./installer.sh: Permission denied\", follow these simple steps to fix it:\n\n1. Open your terminal.\n2. Navigate to the directory where the installer script is located using the `cd` command.\n3. Run the following command to grant execute permission to the installer script:\n\n   ```\n   chmod +x installer.sh\n   ```\n   \n4. Now you can run the installer without any problems.\n\n   ```\n   ./installer.sh\n   ```\n   NOTE: The script will ask for -sudo permissions-. Just simply type in macOS your macOS user password, and in Linux your -sudo- password.\n\nNow type 'novanav' in the terminal and enjoy using NovaNav Browser! 😊🚀\n\n***If you're using Arch Linux, you can find NovaNav Browser in your program menu!.***\n\nFeel free to reach out if you need any further assistance!\n\n#### Updating with the script: \n\nIf you want to update NovaNav (novanav) in your system, re-run the script:\n\n   ```\n   ./installer.sh\n   ```\nPlease note that if you encounter any issues or have suggestions, feel free to raise an issue on the [NovaNav repository](https://github.com/felipealfonsog/NovaNav/issues). Your feedback is invaluable!\n\nThank you for joining me on this journey, and I hope it brings value to your life and workflow. Let's continue making technology accessible and enjoyable for everyone!\n\n\u003csub\u003e* on macOS version might contain lots of errors, bugs, etc.\u003c/sub\u003e\n\n#\n\n\n#### Current Features\n#### 🚀 Current Features (Some might be in progress)\n\n- Tab Management: Open multiple tabs and switch between them seamlessly.\n- URL Navigation: Enter URLs directly or use the search bar to navigate to websites.\n- Zoom Control: Adjust zoom settings to customize the display of web pages.\n- User-friendly Interface: Clean and intuitive interface for easy navigation and usage.\n- Basic Settings: Customize settings such as homepage and default search engine.\n\n\n#\n\n#### How-to - NovaNav\n\n```\nctrl+t (New tab)\nctrl+v (hide tabs for distraction-free)\nctrl+q (quit)\n```\n\n#\n\n#### NovaNav Browser written in other languages (Experimental part of the project)*\n\n[![NovaNav under development](https://img.shields.io/badge/NovaNav-In%20Other%20Languages-blue)](#)\n\n\n\n\n\u003cdetails\u003e\n\n\u003csummary\u003e\u003cstrong\u003eNovaNav written in C++ 🚀 - (Manual instructions)*\u003c/strong\u003e\u003c/summary\u003e\n\n\u003cbr\u003e\n\n\n[![Install NovaNav](https://img.shields.io/badge/Install-NovaNav%20Browser-purple)](https://github.com/felipealfonsog/NovaNav#installation)\n#### Via AUR using YAY (Version written in C++)\n\n[![NovaNav in Python](https://img.shields.io/badge/NovaNav-Python%20Version-yellow)](#)\n\n[![AUR](https://img.shields.io/aur/version/novanav-cpp)](https://aur.archlinux.org/packages/novanav-cpp)\n\n\u003c!-- \n[![AUR](https://img.shields.io/aur/version/novanav-cpp.svg)](https://aur.archlinux.org/packages/novanav-cpp)\n--\u003e\n\nhttps://aur.archlinux.org/packages/novanav-cpp\n\nNovaNav Browser is available on AUR (Arch User Repository), and it can be installed using the `yay` package manager. Follow the steps below to install NovaNav:\n\n1. Make sure you have `yay` installed. If not, you can install it with the following command:\n   \n   ```\n   sudo pacman -S yay\n   ```\n\n   Once yay is installed, you can install by running the following command:\n   \n   ```\n   yay -S novanav-cpp\n   ```\n\n   Or just:\n  \n   ```\n   yay -S novanav\n   ```\n\nThis command will automatically fetch the package from AUR and handle the installation process for you.\nYou can find NovaNav Browser in your program menu!\n\n#\n\n##### Instructions for Compiling from Source\n\nPrerequisites\n\nMake sure you have the following dependencies installed on your system:\n\n- Qt 5 Base\n- Qt 5 WebEngine\n\nCompilation Steps\n\n1. Clone the NovaNav repository from GitHub:\n\n```\ngit clone https://github.com/felipealfonsog/NovaNav.git\n```\n\nNavigate to the directory containing the source code:\n\n```\ncd NovaNav/src/cpp\n```\n\nConfigure the build using qmake. You can adjust parameters as needed:\n\n```\nqmake PREFIX=/usr/local\n```\n\nCompile the source code:\n\n```\nmake\n```\n\nOnce compilation is complete, the novanav binary will be generated in the current directory.\n\nInstallation\nTo install NovaNav system-wide after compilation, you can use the provided PKGBUILD or manually copy the binary to /usr/local/bin, the icon to /usr/share/pixmaps, and the .desktop file to /usr/share/applications, located in the 'src' folder.\n\n\u003csub\u003e* It might contain lots of errors, bugs, etc. Meanwhile, Keep it simple now with C++ stable version, running smomothly!\u003c/sub\u003e\n\n\u003c/details\u003e\n\n\n\u003cdetails\u003e\n\n\u003csummary\u003e\u003cstrong\u003eNovaNav written in Python 🚀 - beta/testing (experimental alternative in progress)*\u003c/strong\u003e\u003c/summary\u003e\n\n\u003cbr\u003e\n\n##### Python version: \n\n  - python\n  - python-pip\n  - python-pyqt5\n  - python-pyqt5-webengine\n\n[![Install NovaNav](https://img.shields.io/badge/Install-NovaNav%20Browser-purple)](https://github.com/felipealfonsog/NovaNav#installation)\n#### Via AUR using YAY (Version written in Python)\n\n[![NovaNav in Python](https://img.shields.io/badge/NovaNav-Python%20Version-yellow)](#)\n\n[![AUR](https://img.shields.io/aur/version/novanav-py)](https://aur.archlinux.org/packages/novanav-py)\n\n\u003c!-- \n[![AUR](https://img.shields.io/aur/version/novanav-py.svg)](https://aur.archlinux.org/packages/novanav-py)\n--\u003e\n\nhttps://aur.archlinux.org/packages/novanav-py\n\nNovaNav Browser is available on AUR (Arch User Repository), and it can be installed using the `yay` package manager. Follow the steps below to install NovaNav:\n\n1. Make sure you have `yay` installed. If not, you can install it with the following command:\n   \n   ```\n   sudo pacman -S yay\n   ```\n\n   Once yay is installed, you can install by running the following command:\n   \n   ```\n   yay -S novanav-py\n   ```\n\nThis command will automatically fetch the package from AUR and handle the installation process for you.\nYou can find NovaNav Browser in your program menu!\n\n\n#### 🚀 Requirements \u0026 Instructions for compiling and executing manually.\n\nInstall Python3, then:\n\nYou might need perhaps to create an enviroment for pip: \n```\npython3 -m venv novanav-env\nsource novanav-env/bin/activate\n```\n\nIf not, just go with this:\n\n```\npip3 install -r requirements.txt\n```\n\nRunt it with: \n\n```\npython3 ./src/novanav.py\n```\n\n\n\u003csub\u003e* It might contain lots of errors, bugs, etc. Meanwhile, Keep it simple now with C++ stable version, running smomothly!\u003c/sub\u003e\n\n\u003c/details\u003e\n\n\n\u003cdetails\u003e\n\n\u003csummary\u003e\u003cstrong\u003eNovaNav written in Rust 🚀 - beta/testing (experimental alternative in progress)*\u003c/strong\u003e\u003c/summary\u003e\n\n\u003cbr\u003e\n\nImportant library to install:\n\n```\nsudo pacman -S libsoup\n```\n\nIn Arch, add this line to .bashrc:\n\n```\nexport PKG_CONFIG_PATH=/usr/lib/pkgconfig:$PKG_CONFIG_PATH\n```\n\n Instructions for installation/compiling the program written in Rust*: \n\n\n\nAdd that to the [dependencies] section of your `Cargo.toml` file:\n```\nvim Cargo.toml\n```\n\nTo test it , run this command on terminal:\n\n```\nchmod +x run_novanav_rust.sh\n./run_novanav_rust.sh\n```\nCompiling: \n\n```\nrustc src/rust/novanav.rs\n./novanav\n```\n\n\u003csub\u003e* It might contain lots of errors, bugs, etc. Meanwhile, Keep it simple now with C++ stable version, running smomothly!\u003c/sub\u003e\n\n\u003c/details\u003e\n\n\n#\n\n[![Errors Reported](https://img.shields.io/badge/Errors-Reported-blue)](#)\n\n\u003cdetails\u003e\n\n\u003csummary\u003e\u003cstrong\u003eErrors, Fixes and tips\u003c/strong\u003e\u003c/summary\u003e\n\u003cbr\u003e\n\n\nTo force the link and overwrite all conflicting files (Errors).\n\nIf you get this error while you are trying to run the software in the terminal or the software doesn't show up, follow the next steps on macOS or Linux:\n\nE.g.:\n\n```\nuser@host src % python3 novanav_linux.py\nTraceback (most recent call last):\n  File \"/Users/user/NovaNav/src/novanav_linux.py\", line 2, in \u003cmodule\u003e\n    from PyQt5.QtCore import QUrl, Qt\nModuleNotFoundError: No module named 'PyQt5'\n```\n\nInstall or reinstall pyqt5 with the following command in brew:\nE.g.:\n\n```\nuser@host src % brew install pyqt5\n==\u003e Downloading https://formulae.brew.sh/api/formula.jws.json\n############################################################################################################ 100.0%\nWarning: Formula pyqt5 was renamed to pyqt@5.\n==\u003e Downloading https://formulae.brew.sh/api/cask.jws.json\n############################################################################################################ 100.0%\nWarning: pyqt@5 5.15.10 is already installed, it's just not linked.\nTo link this version, run:\n  brew link pyqt@5\nuser@host src % brew link pyqt@5\nLinking /usr/local/Cellar/pyqt@5/5.15.10... \nError: Could not symlink bin/pylupdate5\nTarget /usr/local/bin/pylupdate5\nalready exists. You may want to remove it:\n  rm '/usr/local/bin/pylupdate5'\n\nTo force the link and overwrite all conflicting files:\n  brew link --overwrite pyqt@5\n\nTo list all files that would be deleted:\n  brew link --overwrite pyqt@5 --dry-run\n\n```\n\n**So, if you want to delete all files that will be deleted by `brew link --overwrite`, use the `--dry-run` option\nThen run,**\n\n```\nrm '/usr/local/bin/pylupdate5'\n```\n\n```\nbrew link --overwrite pyqt@5\n```\n\n```\nbrew link --overwrite pyqt@5 --dry-run\n```\nThe last one will show you what would delete if you proceed. If everything looks good, hit return. Then you should have PyQt5 properly installed.\n\nAnd then try running your program again.\n\nE.g.:\n\n```\nuser@host src % rm '/usr/local/bin/pylupdate5'\nuser@host src % brew link --overwrite pyqt@5\n\nLinking /usr/local/Cellar/pyqt@5/5.15.10... 5279 symlinks created.\n```\n\n```\nuser@host src % python3 novanav.py  \n```\n\nThen should be fine with no errors. \n\n\u003csub\u003eIf you still have problems please let me know.\nAlso if you want to install `pyrcc5` (which is not necessary but can help) just do a normal installation using pip: I am using Python 3.x.\u003c/sub\u003e\n\n\u003c/details\u003e\n\n\n#\n\n\n#### 🌟 Contact the Creator and Engineer Behind This Project\n\n\n\n👨‍💻 **Felipe Alfonso González**  \n📧 Email: [f.alfonso@res-ear.ch](mailto:f.alfonso@res-ear.ch)  \n🐦 x (Twitter): [@felipealfonsog](https://twitter.com/felipealfonsog)  \n🔗 GitHub: [felipealfonsog](https://github.com/felipealfonsog)  \n📄 License: BSD 3-Clause  \n\n\n#\n\n#### 🤝 Support and Contributions\n\nIf you find this project helpful and would like to support its development, there are several ways you can contribute:\n\n- **Code Contributions**: If you're a developer, you can contribute by submitting pull requests with bug fixes, new features, or improvements. Feel free to fork the project (development branch) and create your own branch to work on.\n- **Bug Reports and Feedback**: If you encounter any issues or have suggestions for improvement, please open an issue on the project's GitHub repository. Your feedback is valuable in making the project better.\n- **Documentation**: Improving the documentation is always appreciated. If you find any gaps or have suggestions to enhance the project's documentation, please let me know.\n\n[![Buy Me a Coffee](https://img.shields.io/badge/Buy%20Me%20a%20Coffee-%E2%98%95-FFDD00?style=flat-square\u0026logo=buy-me-a-coffee\u0026logoColor=black)](https://www.buymeacoffee.com/felipealfonsog)\n[![PayPal](https://img.shields.io/badge/Donate%20with-PayPal-00457C?style=flat-square\u0026logo=paypal\u0026logoColor=white)](https://www.paypal.me/felipealfonsog)\n[![GitHub Sponsors](https://img.shields.io/badge/Sponsor%20me%20on-GitHub-%23EA4AAA?style=flat-square\u0026logo=github-sponsors\u0026logoColor=white)](https://github.com/sponsors/felipealfonsog)\n\nYour support and contributions are greatly appreciated! Thank you for your help in making this project better. If you need to mail me, this is the way: f.alfonso@res-ear.ch (I'm Felipe, the Computer Science Engineer behind this idea. Cheers!)\n\n\n#### 📄 License\n\nThis project is licensed under the [BSD 3-Clause License](LICENSE). It will have some restrictions, ask about it.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffelipealfonsog%2Fnovanav","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffelipealfonsog%2Fnovanav","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffelipealfonsog%2Fnovanav/lists"}