Metadata-Version: 2.4
Name: darkelf-cli
Version: 0.2.3
Summary: Privacy-focused OSINT CLI browser over Tor
Author: Dr. Kevin Moore
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE.md
Requires-Dist: requests
Requires-Dist: beautifulsoup4
Requires-Dist: rich
Dynamic: license-file

# Darkelf CLI Browser

A lightweight, privacy-focused terminal browser.

Darkelf CLI Browser lets you search, browse, and investigate data directly from your terminal with a clean, keyboard-driven interface—no GUI required.

---

## 🚀 Features

* 🌐 **CLI Web Browser**
  Navigate web pages directly from the terminal with keyboard controls.

* 🔍 **Search Integration**
  Perform DuckDuckGo searches and browse results in a structured, readable format.

* 📄 **Readable Output**
  Clean, structured display inspired by OSINT AI tools.

* ⌨️ **Keyboard Navigation**
  Fast, efficient navigation without leaving the terminal.

---

## 📦 Installation

```bash
pip install darkelf-cli
```

Or install locally for development:

```bash
pip install -e .
```

---

## ▶️ Usage

Run the tool:

```bash
darkelf-cli
```

---

## 🧭 Browser Controls

| Key                   | Action               |
| --------------------- | -------------------- |
| ↑ / ↓ / w / s / j / k | Scroll page          |
| O                     | Open link by number  |
| U                     | Enter URL            |
| B                     | Go back              |
| H                     | View history         |
| T                     | Manage tabs          |
| F                     | Search               |
| L                     | List links           |
| M                     | Toggle Markdown view |
| /                     | Search within page   |
| N                     | Next match           |
| ?                     | Help menu            |
| Q                     | Quit browser         |

---

## 🔍 Example

Search for a term:

```
Enter search query: hello
```

Navigate results:

```
[1] HELLO - WIKIPEDIA
    A greeting used in everyday language...
    https://en.wikipedia.org/wiki/Hello
```

Press:

```
O → 1
```

To open the result.

---

## ⚠️ Disclaimer

This tool is intended for:

* educational purposes
* ethical OSINT investigations

Do **not** use it for illegal activities.

---

## 🛠️ Development

Project structure:

```
darkelf/
├── darkelf/
│   ├── __init__.py
│   └── cli.py
├── pyproject.toml
└── README.md
```

---

## 📌 Roadmap

* Improved parsing for search engines
* Async page loading
* Enhanced OSINT modules
* Better UI/UX rendering
* Plugin system

---

## 👤 Author

Dr. Kevin Moore

---

## 📄 License

This project is licensed under the **GNU Lesser General Public License v3.0 (LGPL-3.0)**.

You are free to use, modify, and distribute this software under the terms of the LGPL-3.0 license.

See the [LICENSE](LICENSE) file for full details.
