Metadata-Version: 2.4
Name: textual-mitms
Version: 0.2.1
Summary: A tool for capturing full network traffic (HTTP/HTTPS, WebSocket, TCP) based on mitmproxy and the Textual terminal user interface.
Author-email: NhatMinh2805 <minhlapp2@gmail.com>
License: MIT
Project-URL: Homepage, https://github.com/huynhmainhatminh/Textual-Mitms
Project-URL: Repository, https://github.com/huynhmainhatminh/Textual-Mitms
Keywords: mitmproxy,textual,proxy,http,tui
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Internet :: Proxy Servers
Classifier: Topic :: Security
Requires-Python: >=3.11
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: textual[syntax]==8.2.8
Requires-Dist: mitmproxy==11.0.2
Dynamic: license-file

# Textual-Mitms

**Textual-Mitms is a terminal-based MITM proxy tool built on Textual and mitmproxy.**
It allows you to capture, view, and filter HTTP/HTTPS, WebSocket, and TCP packets directly within a TUI—offering a compact, fast, and simple experience without the need to open a web browser.

![Textual-Mitms Demo](gif/demo-textual-mitms.gif)

## Features
- Live HTTP(S) history
- Capture HTTP/2, HTTP/3, and WebSocket packets
- Search 13 field, 10 mode
- Allow / Ignore hosts
- Filter AND — protocol (HTTP/HTTPS/WEBSOCKET), HTTP1/2/3, MIME, 1xx–5xx.
- Copy / Save — body, headers JSON, cURL, URL,..
- The RegexLite tool makes creating regular expressions simple and efficient.
- The Curlconverter tool helps convert cURL commands into various programming languages.
## Installing

#### The package can be installed with `pip` or related tools, for example:

```sh
pip install textual-mitms==0.2.1
```

#### Run CLI
```sh
textual-mitms --help
```
#### Install CA certificate (Run as administrator)
```sh
textual-mitms cert generate
```
```sh
textual-mitms cert status
```
```sh
textual-mitms cert install
```
#### Now you can run textual-mitms via the command line:

```sh
textual-mitms
```
#### Uninstall CA certificate (Run as administrator)
```sh
textual-mitms cert uninstall
```

## Using basic RegexLite
![RegexLite Demo](gif/RegexLite.gif)

## Using basic Curlconverter
![Curlconverter Demo](gif/Curlconverter.gif)

## Dependent
- [mitmproxy](https://docs.mitmproxy.org/) — An interactive TLS-capable intercepting HTTP proxy for penetration testers and software developers.
- [Textual](https://textual.textualize.io/) — The lean application framework for Python. Build sophisticated user interfaces with a simple Python API. Run your apps in the terminal and a web browser.
