Skip to content
This repository was archived by the owner on Sep 19, 2025. It is now read-only.

Commit 3395e8c

Browse files
authored
Update README.md
1 parent 1b1b1b4 commit 3395e8c

File tree

1 file changed

+55
-24
lines changed

1 file changed

+55
-24
lines changed

README.md

Lines changed: 55 additions & 24 deletions
Original file line numberDiff line numberDiff line change
@@ -1,25 +1,56 @@
1-
# Navegador-B-sico-E-Leve-Com-Python-
2-
# Como Usar
3-
Para usar Primeiro Baixe As dependências
1+
# Navegador Simples e Leve com Python
2+
3+
Este é um navegador web básico e leve desenvolvido em Python, utilizando a biblioteca **PyQt5** e o **QtWebEngine** (que é baseado no Chromium). Ele foi projetado para ser fácil de usar e inclui funcionalidades essenciais como navegação, gerenciamento de perfis e busca inteligente.
4+
5+
## Funcionalidades Principais
6+
7+
* **Navegação Essencial:** Botões de Voltar, Avançar, Recarregar e Home.
8+
* **Barra de URL Inteligente:** Detecta automaticamente se o que foi digitado é uma URL ou um termo de pesquisa, usando o Google como padrão. Inclui um ícone de cadeado para indicar a segurança da conexão (HTTPS).
9+
* **Gerenciamento de Perfis:**
10+
* Inicie no **Modo Convidado** (sem salvar histórico ou cookies).
11+
* Crie e carregue **perfis persistentes** para manter seus dados de navegação.
12+
* Opção para **deletar** perfis existentes.
13+
* **Leve e Flexível:** Desenvolvido em Python para fácil customização e entendimento.
14+
15+
## Como Usar
16+
17+
Para colocar o navegador para funcionar, siga os passos abaixo:
18+
19+
### 1. Pré-requisitos e Instalação de Dependências
20+
21+
Este projeto foi desenvolvido e testado no **Arch Linux**, e as instruções de instalação das dependências refletem isso.
22+
23+
É **altamente recomendado** usar um ambiente virtual para isolar as dependências do projeto do restante do seu sistema Python.
24+
25+
#### No Arch Linux:
26+
27+
1. **Instale Python e `pip` (se ainda não tiver):**
28+
```bash
29+
sudo pacman -S python python-pip
30+
```
31+
2. **Crie e Ative o Ambiente Virtual:**
32+
```bash
33+
python3 -m venv ~/.venv/navegador-env
34+
source ~/.venv/navegador-env/bin/activate
35+
```
36+
* **Para usuários Fish Shell:** Use `source ~/.venv/navegador-env/bin/activate.fish`
37+
* **Para usuários PowerShell:** Use `~/.venv/navegador-env/Scripts/Activate.ps1`
38+
*(Se você usa Debian/Ubuntu, talvez precise instalar `python3-venv` separadamente com `sudo apt install python3-venv`.)*
39+
40+
3. **Instale as Bibliotecas PyQt5 e PyQtWebEngine:**
41+
```bash
42+
pip install PyQt5 PyQtWebEngine
43+
```
44+
* **Observação para Arch Linux:** Para o `PyQtWebEngine` funcionar corretamente com o Qt5, é fundamental que as bibliotecas base do Qt5 WebEngine estejam instaladas no sistema. Se você tiver problemas, tente instalar os pacotes do sistema:
45+
```bash
46+
sudo pacman -S python-pyqt5 python-pyqt5-webengine
47+
```
48+
Se você já instalou `python-pyqt6` anteriormente, não se preocupe, `pacman` deve gerenciar as dependências do `python-pyqt5-webengine` corretamente.
49+
50+
### 2. Baixe o Navegador
51+
52+
Se você ainda não clonou o repositório, faça isso:
53+
454
```bash
5-
sudo pacman -S python3 --noconfirm
6-
sudo pacman -S python-pip --noconfirm # Substitua pacman pelo seu gerenciador de pacotes e suas flags # a maioria das distros vem com o venv ja no pacote python mas algumas(especialmente debian/ubuntu) precisa instalar separadamente
7-
python3 -m venv ~/.venv
8-
source ~/.venv/bin/activate # se usa bash
9-
# source ~/.venv/bin/activate.fish # se usa fish
10-
# source ~/.venv/bin/activate.ps1 # se usa powershell
11-
pip install PyQt5 cefpython3
12-
```
13-
depois baixe o navegador
14-
```bash
15-
sudo pacman -S git
16-
git clone https://github.com/pedrodev2025/Navegador-B-sico-E-Leve-Com-Python-.git
17-
```
18-
depois Entre no Repositório
19-
```bash
20-
cd Navegador-B-sico-E-Leve-Com-Python-
21-
```
22-
depois execute
23-
```bash
24-
python3 navegador.py
25-
```
55+
sudo pacman -S git # Instala o Git, se ainda não estiver instalado
56+
git clone [https://github.com/pedrodev2025/Navegador-B-sico-E-Leve-Com-Python-.git](https://github.com/pedrodev2025/Navegador-B-sico-E-Leve-Com-Python-.git)

0 commit comments

Comments
 (0)