alamin/websurfx
alamin/websurfx
0
0
Fork 0
mirror of https://github.com/neon-mmd/websurfx.git synced 2024-11-22 22:18:23 -05:00
Code Issues Releases Activity

Merge branch 'neon-mmd:master' into master

Browse Source
This commit is contained in:
Sam sunder 2023-05-27 12:58:09 +05:30 committed by GitHub
commit fa273bdde9
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
7 changed files with 131 additions and 81 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

90
README.md
View File

@ -5,68 +5,26 @@
<b align="center"><a href="README.md">Readme</a></b> |
<b><a href="https://discord.gg/SWnda7Mw5u">Discord</a></b> |
<b><a href="https://github.com/neon-mmd/websurfx">GitHub</a></b> |
<b><a href="https://github.com/neon-mmd/websurfx/wiki">Documentation</a></b>
<b><a href="./docs/README.md">Documentation</a></b>
<br /><br />
<a href="./LICENSE">
<img
alt="GitHub"
src="https://img.shields.io/github/license/neon-mmd/websurfx?style=flat-square"
/>
</a>
<a href="https://github.com/neon-mmd/websurfx/stargazers">
<img
alt="GitHub Repo stars"
src="https://img.shields.io/github/stars/neon-mmd/websurfx?style=flat-square"
/>
</a>
<a href="https://github.com/neon-mmd/websurfx/forks">
<img
alt="GitHub forks"
src="https://img.shields.io/github/forks/neon-mmd/websurfx?style=flat-square"
/>
</a>
<a href="#">
<img
alt="GitHub code size in bytes"
src="https://img.shields.io/github/languages/code-size/neon-mmd/websurfx?style=flat-square"
/>
</a>
<a href="https://github.com/neon-mmd/websurfx/issues">
<img
alt="GitHub issues"
src="https://img.shields.io/github/issues/neon-mmd/websurfx?style=flat-square"
/>
</a>
<a href="https://github.com/neon-mmd/websurfx/pulls">
<img
alt="GitHub pull requests"
src="https://img.shields.io/github/issues-pr/neon-mmd/websurfx?style=flat-square"
/>
</a>
<a href="https://github.com/neon-mmd/websurfx/actions">
<img
alt="GitHub Workflow Status"
src="https://img.shields.io/github/actions/workflow/status/neon-mmd/websurfx/rust.yml?style=flat-square"
/>
</a>
<a href="">
<img
alt="GitHub release (latest by date including pre-releases)"
src="https://img.shields.io/github/v/release/neon-mmd/websurfx?include_prereleases"
/>
</a>
<a href=""
><img
alt="Maintenance"
src="https://img.shields.io/maintenance/yes/2023?style=flat-square"
/>
</a>
<a href="">
<img
alt="GitHub contributors"
src="https://img.shields.io/github/contributors-anon/neon-mmd/websurfx?style=flat-square"
/>
</a>
<a href="https://gitpod.io/#https://github.com/neon-mmd/websurfx">
<img
alt="Gitpod"
@ -126,7 +84,7 @@
<img align="center" src="./images/404_error_page.png" />
**[⬆️ Back to Top](#websurfx)**
**[⬆️ Back to Top](#--)**
# Features 🚀
@ -136,20 +94,22 @@
- 💨 Ad-free and clean results
- 🌟 and lots more...
**[⬆️ Back to Top](#websurfx)**
**[⬆️ Back to Top](#--)**
# Installation and Testing 🛠️
> For full setup instructions, see: [**Installation**](https://github.com/neon-mmd/websurfx/wiki/installation)
> For full setup instructions, see: [**Installation**](./docs/installation.md)
To get started with Websurfx, clone the repository, edit the config file, which is located in the `websurfx`{.verbatim} directory, and install the Redis server by following the instructions located [here](https://redis.io/docs/getting-started/) and then run the websurfx server and redis server using the following commands:
Before you can start building `websurfx`, you will need to have `Cargo` installed on your system. You can find the installation instructions [here](https://doc.rust-lang.org/cargo/getting-started/installation.html).
To get started with Websurfx, clone the repository, edit the config file, which is located in the `websurfx/` directory, and install the Redis server by following the instructions located [here](https://redis.io/docs/getting-started/) and then run the websurfx server and redis server using the following commands:
``` shell
git clone https://github.com/neon-mmd/websurfx.git
cd websurfx
cargo build
cargo build -r
redis-server --port 8082 &
./target/debug/websurfx
./target/release/websurfx
```
Once you have started the server, open your preferred web browser and navigate to <http://127.0.0.1:8080> to start using Websurfx.
@ -157,36 +117,36 @@ Once you have started the server, open your preferred web browser and navigate t
> **Warning**
> Please be aware that the project is still in the testing phase and is not ready for production use.
**[⬆️ Back to Top](#websurfx)**
**[⬆️ Back to Top](#--)**
# Configuration 🔧
> For full configuration instructions, see: [**Configuration**](https://github.com/neon-mmd/websurfx/wiki/configuration)
> For full configuration instructions, see: [**Configuration**](./docs/configuration.md)
Websurfx is configured through the config.lua file, located at `websurfx/config.lua`.
**[⬆️ Back to Top](#websurfx)**
**[⬆️ Back to Top](#--)**
# Theming 🎨
> For full theming and customization instructions, see: [**Theming**](https://github.com/neon-mmd/websurfx/wiki/theming)
> For full theming and customization instructions, see: [**Theming**](./docs/theming.md)
Websurfx comes with several themes and color schemes by default, which you can apply and edit through the config file. Supports custom themes and color schemes using CSS, allowing you to develop your own unique-looking website.
**[⬆️ Back to Top](#websurfx)**
**[⬆️ Back to Top](#--)**
# Multi-Language Support 🌍
> **Note**
> Currently, we do not support other languages, but in the future, we will start accepting contributions regarding language support because we believe that language should not be a barrier to entry.
**[⬆️ Back to Top](#websurfx)**
**[⬆️ Back to Top](#--)**
# System Requirements 📊
At present, we only support x86_64 architecture systems, but we would love to have contributions that extend to other architectures as well.
**[⬆️ Back to Top](#websurfx)**
**[⬆️ Back to Top](#--)**
# FAQ (Frequently Asked Questions) 🗨️
@ -202,13 +162,13 @@ Websurfx is distributed under the **AGPLv3** license to keep the source code ope
Rust was chosen as the programming language for Websurfx because of its memory safety features, which can help prevent vulnerabilities and make the codebase more secure. Rust is also faster than C++, which contributes to Websurfx's speed and responsiveness. Furthermore, the Rust ownership and borrowing system enables secure concurrency and thread safety in the program.
**[⬆️ Back to Top](#websurfx)**
**[⬆️ Back to Top](#--)**
# More Contributers Wanted 📣
We are looking for more willing contributors to help grow this project. For more information on how you can contribute, check out the [project board](https://github.com/neon-mmd/websurfx/projects?query=is%3Aopen) and the [CONTRIBUTING.md](CONTRIBUTING.md) file for guidelines and rules for making contributions.
**[⬆️ Back to Top](#websurfx)**
**[⬆️ Back to Top](#--)**
# Supporting Websurfx 💖
@ -224,20 +184,20 @@ Several areas that we need a bit of help with at the moment are:
- Submit a PR to add a new feature, fix a bug, update the docs, add a theme, widget, or something else.
- Star Websurfx on GitHub.
**[⬆️ Back to Top](#websurfx)**
**[⬆️ Back to Top](#--)**
# Documentation 📘
> **Note**
> We welcome any contributions to the [documentation](https://github.com/neon-mmd/websurfx/wiki) as this will benefit everyone who uses this project.
> We welcome any contributions to the [documentation](./docs/) as this will benefit everyone who uses this project.
**[⬆️ Back to Top](#websurfx)**
**[⬆️ Back to Top](#--)**
# Roadmap 🛣️
> Coming soon!! 🙂.
**[⬆️ Back to Top](#websurfx)**
**[⬆️ Back to Top](#--)**
# Contributing 🙋
@ -251,13 +211,13 @@ Check out this [video](https://youtu.be/FccdqCucVSI) by Mr. Nick on how to contr
If you are a developer, have a look at the [CONTRIBUTING.org](CONTRIBUTING.md) document for more information.
**[⬆️ Back to Top](#websurfx)**
**[⬆️ Back to Top](#--)**
# License 📜
Websurfx is licensed under the [AGPLv3](LICENSE) license.
**[⬆️ Back to Top](#websurfx)**
**[⬆️ Back to Top](#--)**
# Credits 🤝
@ -271,7 +231,7 @@ We would like to thank the following people for their contributions and support:
<br />
</p>
**[⬆️ Back to Top](#websurfx)**
**[⬆️ Back to Top](#--)**
---

14
docs/configuration.md
View File

@ -1,6 +1,15 @@
# Configuration
Everything in websurfx can be configured through the config file located at `websurfx/config.lua`.
## Installed From Source
If you have built `websurfx` from source then the configuration file will be located under project directory (codebase) at `websurfx/`
> **Note**
> If you have built websurfx with unstable/rolling/edge branch then you can copy the configuration file from `websurfx/config.lua` located under project directory (codebase) to `~/.config/websurfx/` and make the changes there and rerun the websurfx server. _This is only available from unstable/rolling/edge version_.
## Installed From Package
If you have installed `websurfx` using the package manager of your Linux distro then the default configuration file will be located at `/etc/xdg/websurfx/`. You can copy the default config to `~/.config/websurfx/` and make the changes there and rerun the websurfx server.
Some of the configuration options provided in the file are stated below. These are subdivided into three categories:
@ -12,6 +21,7 @@ Some of the configuration options provided in the file are stated below. These a
- **port:** Port number on which server should be launched.
- **binding_ip_addr:** IP address on the which server should be launched.
- **production_use:** Whether to use production mode or not (in other words this option should be used if it is to be used to host it on the server to provide a service to a large number of users). If production_use is set to true. There will be a random delay before sending the request to the search engines, this is to prevent DDoSing the upstream search engines from a large number of simultaneous requests. This is newly added option and hence is only available in the **edge version**.
## Website
@ -39,4 +49,4 @@ Some of the configuration options provided in the file are stated below. These a
- **redis_connection_url:** Redis connection url address on which the client should connect on.
[⬅️ Go back to Home](https://github.com/neon-mmd/websurfx/wiki).
[⬅️ Go back to Home](./README.md)

4
docs/faq.md
View File

@ -2,7 +2,7 @@
## Why Websurfx?
The main goal of the Websurfx project is to provide a fast, secure, and privacy-focused [meta search engine](https://en.wikipedia.org/wiki/Metasearch_engine). While there are many meta search engines available, they do not always guarantee the security of their search engine, which is essential for ensuring privacy. For example, memory vulnerabilities can leak private or sensitive information, which is never good. Websurfx is written in Rust, which guarantees memory safety and eliminates such problems. Many meta search engines also lack key features such as advanced image search, which is required by many graphic designers, content creators, and others. Websurfx aims to provide these features and others, such as proper NSFW blocking, to improve the user experience.
The primary purpose of the Websurfx project is to create a fast, secure, and privacy-focused [meta-search engine](https://en.wikipedia.org/wiki/Metasearch_engine). While there are numerous meta-search engines available, not all of them guarantee the security of their search engine, which is critical for maintaining privacy. Memory flaws, for example, can expose private or sensitive information, which is never a good thing. Also, there is the added problem of Spam, ads, and unorganic results which most engines don't have the full-proof answer to it till now but with Websurfx I finally put a full stop to this problem, also, Rust is used to write Websurfx, which ensures memory safety and removes such issues. Many meta-search engines also lack important features like advanced picture search, which is required by many graphic designers, content providers, and others. Websurfx attempts to improve the user experience by providing these and other features, such as proper NSFW blocking and Micro-apps or Quick results (like providing a calculator, currency exchanges, etc in the search results).
## Why AGPLv3?
@ -12,4 +12,4 @@ Websurfx is released under the AGPLv3 license to ensure that the source code rem
Rust was chosen as the programming language for Websurfx due to its memory safety features, which can help prevent vulnerabilities and make the codebase more secure. Rust is also faster than C++, which helps to make Websurfx fast and responsive. In addition, Rust's ownership and borrowing system allows for safe concurrency and thread safety in the codebase.
[⬅️ Go back to Home](https://github.com/neon-mmd/websurfx/wiki).
[⬅️ Go back to Home](./README.md)

59
docs/installation.md
View File

@ -1,16 +1,49 @@
# Stable
# Install From Package
To get started with Websurfx, clone the repository, edit the config file which is located in the `websurfx` directory and install redis server by following the instructions located [here](https://redis.io/docs/getting-started/) and then run the websurfx server and redis server using the following commands:
## Arch Linux
You can install `Websurfx` through the [Aur](https://aur.archlinux.org/packages/websurfx-git), Currently we only support `Rolling/Edge` version. You can install the rolling/edge version by running the following command (using [paru](https://github.com/Morganamilo/paru)):
```bash
paru -S websurfx-edge-git
```
After installing it you can run the websurfx server by running the following commands:
``` bash
redis-server --port 8082 &
websurfx
```
Once you have started the server, open your preferred web browser and navigate to http://127.0.0.1:8080/ to start using Websurfx.
If you want to change the port or the ip or any other configuration setting checkout the [configuration docs](./configuration.md).
## Other Distros
The package is currently not available on other Linux distros. With contribution and support it can be made available on other distros as well 🙂.
# Install From Source
Before you can start building `websurfx`, you will need to have `Cargo` installed on your system. You can find the installation instructions [here](https://doc.rust-lang.org/cargo/getting-started/installation.html).
## Stable
To get started with Websurfx, clone the repository, edit the config file which is located in the `websurfx` directory and install redis server by following the instructions located [here](https://redis.io/docs/getting-started/) and then build and run the websurfx server by running the following commands:
```shell
git clone https://github.com/neon-mmd/websurfx.git
cd websurfx
cargo build
cargo build -r
redis-server --port 8082 &
./target/debug/websurfx
./target/release/websurfx
```
# Rolling/Edge/Unstable
Once you have started the server, open your preferred web browser and navigate to http://127.0.0.1:8080/ to start using Websurfx.
If you want to change the port or the ip or any other configuration setting checkout the [configuration docs](./configuration.md).
## Rolling/Edge/Unstable
If you want to use the rolling/edge branch, run the following commands instead:
@ -18,13 +51,15 @@ If you want to use the rolling/edge branch, run the following commands instead:
git clone https://github.com/neon-mmd/websurfx.git
cd websurfx
git checkout rolling
cargo build
cargo build -r
redis-server --port 8082 &
./target/debug/websurfx
./target/release/websurfx
```
Once you have started the server, open your preferred web browser and navigate to http://127.0.0.1:8080/ to start using Websurfx.
If you want to change the port or the ip or any other configuration setting checkout the [configuration docs](./configuration.md).
# Docker Deployment
Before you start, you will need [Docker](https://docs.docker.com/get-docker/) installed on your system first.
@ -61,7 +96,11 @@ colorscheme = "catppuccin-mocha" -- the colorscheme name which should be used fo
theme = "simple" -- the theme name which should be used for the website
-- Caching
redis_connection_url = "redis://redis:6379" -- redis connection url address on which the client should connect on.
redis_connection_url = "redis://127.0.0.1:8082" -- redis connection url address on which the client should connect on.
production_use = false -- whether to use production mode or not (in other words this option should be used if it is to be used to host it on the server to provide a service to a large number of users)
-- if production_use is set to true
-- There will be a random delay before sending the request to the search engines, this is to prevent DDoSing the upstream search engines from a large number of simultaneous requests.
```
After this run the following command to deploy the app:
@ -74,7 +113,7 @@ This will take around 5-10 mins for first deployment, afterwards the docker buil
## Unstable/Edge/Rolling
For the unstable/rolling/edge version, follow the same steps as above with an addition of one command for cloning the repository which makes the cloning step as follows:
For the unstable/rolling/edge version, follow the same steps as above (as mentioned for the stable version) with an addition of one command which has to be performed after cloning and changing directory into the repository which makes the cloning step as follows:
```bash
git clone https://github.com/neon-mmd/websurfx.git
@ -82,4 +121,4 @@ cd websurfx
git checkout rolling
```
[⬅️ Go back to Home](https://github.com/neon-mmd/websurfx/wiki).
[⬅️ Go back to Home](./README.md)

2
docs/introduction.md
View File

@ -10,4 +10,4 @@ Most meta search engines tend to be slow, lack high level of customization and m
Websurfx is a project which seeks to provide privacy, security, speed and all the features which the user wants.
[⬅️ Go back to Home](https://github.com/neon-mmd/websurfx/wiki).
[⬅️ Go back to Home](./README.md)

43
docs/theming.md
View File

@ -321,4 +321,45 @@ footer {
}
```
[⬅️ Go back to Home](https://github.com/neon-mmd/websurfx/wiki).
### Styles for the about page
This part is only available right now in the **rolling/edge/unstable** version
```css
.about-container article{
font-size: 1.5rem;
color:var(--fg);
padding-bottom: 10px;
}
.about-container article h1{
color: var(--2);
font-size: 2.8rem;
}
.about-container article div{
padding-bottom: 15px;
}
.about-container a{
color:var(--3);
}
.about-container article h2{
color: var(--3);
font-size: 1.8rem;
padding-bottom: 10px;
}
.about-container p{
color:var(--fg);
font-size: 1.6rem;
padding-bottom: 10px;
}
.about-container h3{
font-size: 1.5rem;
}
```
[⬅️ Go back to Home](./README.md)

BIN
images/main_page.png
View File

Binary file not shown.
Side by Side Swipe Overlay

Before

Width:  |  Height:  |  Size: 36 KiB

After

Width:  |  Height:  |  Size: 36 KiB