friTap

https://fkie-cad.github.io/friTap/
Admin
friTap is a powerful cybersecurity research tool that simplifies SSL/TLS traffic analysis by...
Tokens:221,563
Snippets:2,935
Trust Score:9.7
Update:3 months ago
Show doc for...
Tokens:
Raw
### Windows Quick Start

Source: https://fkie-cad.github.io/friTap/platforms

Install friTap and run it with administrative privileges on Windows.

```bash
# Install Python from python.org or Windows Store

# Install friTap
pip install fritap

# Run as Administrator
fritap -k keys.log --pcap traffic.pcap chrome.exe
```

--------------------------------

### Quick Start friTap Commands

Source: https://fkie-cad.github.io/friTap

Initial installation and basic usage examples for desktop and mobile application analysis.

```bash
# Install friTap
pip install fritap

# Basic usage - Desktop application
sudo fritap --pcap capture.pcap firefox

# Mobile application analysis
fritap -m -k keys.log com.example.app
```

--------------------------------

### Setup Local MkDocs Development

Source: https://fkie-cad.github.io/friTap/development/documentation

Commands to install dependencies and serve documentation locally.

```bash
# Install MkDocs and dependencies
pip install mkdocs mkdocs-material

# Serve documentation locally
mkdocs serve

# Open browser to http://127.0.0.1:8000
```

--------------------------------

### Linux Quick Start

Source: https://fkie-cad.github.io/friTap/platforms

Install dependencies and run friTap on Linux systems.

```bash
# Install dependencies
sudo apt update && sudo apt install python3 python3-pip

# Install friTap
pip3 install fritap

# Basic usage
sudo fritap -k keys.log --pcap traffic.pcap firefox
```

--------------------------------

### macOS Quick Start

Source: https://fkie-cad.github.io/friTap/platforms

Install dependencies and configure BPF permissions for friTap on macOS.

```bash
# Install Homebrew and dependencies
brew install python@3.11

# Install friTap
pip3 install fritap

# Configure BPF permissions
sudo chmod 644 /dev/bpf*

# Basic usage
sudo fritap -k keys.log --pcap traffic.pcap Safari
```

--------------------------------

### Manual Development Setup

Source: https://fkie-cad.github.io/friTap/development/contributing

Configures the Python virtual environment, installs dependencies, and builds the TypeScript agent manually.

```bash
# Python environment
python -m venv venv
source venv/bin/activate  # Linux/macOS
# venv\Scripts\activate   # Windows

# Install development dependencies
pip install -r requirements-dev.txt
pip install -e .

# Node.js dependencies (for TypeScript agent)
npm install

# Install frida-tools for latest frida-compile
pip install --upgrade frida-tools

# Verify setup
python run_tests.py summary
npm run build
```

--------------------------------

### Setup Development Environment

Source: https://fkie-cad.github.io/friTap/platforms/macos

Commands to install Xcode Command Line Tools, Homebrew, Python, and the friTap package.

```bash
# Install Xcode Command Line Tools
xcode-select --install

# Install Homebrew (recommended package manager)
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# Install Python (if not using system Python)
brew install python@3.11

# Install friTap
pip3 install fritap
```

--------------------------------

### Configure and Verify Test Environment

Source: https://fkie-cad.github.io/friTap/development/development-setup?q=

Commands to check the status of the test environment, install dependencies, and perform initial setup.

```bash
# Check test environment status
python run_tests.py summary

# Install missing test dependencies
pip install -r tests/requirements.txt

# Setup test environment
python run_tests.py setup
```

--------------------------------

### Install Documentation Tools

Source: https://fkie-cad.github.io/friTap/development/development-setup?q=

Installs tools for generating project documentation.

```bash
# Documentation generation
pip install mkdocs mkdocs-material

# API documentation
pip install pdoc3
```

--------------------------------

### Install Fritap on macOS

Source: https://fkie-cad.github.io/friTap/platforms

Setup instructions using Homebrew-managed Python or pyenv for version management on macOS.

```bash
# Homebrew-managed Python
brew install python@3.11
pip3 install fritap

# pyenv for version management
brew install pyenv
pyenv install 3.11.0
pyenv global 3.11.0
```

--------------------------------

### Format Code Examples

Source: https://fkie-cad.github.io/friTap/CONTRIBUTING_TO_DOCS?q=

Examples of how to present CLI and Python code blocks with syntax highlighting.

```bash
fritap -k keys.log firefox
```

```python
from friTap import SSL_Logger
logger = SSL_Logger()
```

--------------------------------

### Build Output Example

Source: https://fkie-cad.github.io/friTap/development/development-setup?q=

Expected output when running the build command.

```bash
$ npm run build
> friTap build
> frida-compile agent/fritap_agent.ts -o friTap/fritap_agent.js

Compiling main agent...
✓ Generated friTap/fritap_agent.js (450KB)
```

--------------------------------

### Automated Development Setup

Source: https://fkie-cad.github.io/friTap/development/contributing

Clones the repository and executes the automated setup script to configure dependencies and hooks.

```bash
# Clone repository
git clone https://github.com/fkie-cad/friTap.git
cd friTap

# Run automated setup script
python dev/setup_dev.py
```

--------------------------------

### Fritap Help Examples

Source: https://fkie-cad.github.io/friTap/api/cli

Various command-line examples derived from the Fritap help menu, covering diverse capture scenarios and flags.

```bash
fritap -m -p ssl.pcap com.example.app
fritap -m --pcap log.pcap --verbose com.example.app
fritap -m -k keys.log -v -s com.example.app
fritap -m -k keys.log -v -c <custom hook script> -s com.example.app
fritap -m --patterns pattern.json -k keys.log -s com.google.android.youtube
fritap --pcap log.pcap "$(which curl) https://www.google.com"
fritap -H 192.168.0.1:1234 --pcap log.pcap com.example.app
fritap -m -p log.pcap --enable_spawn_gating -v -do -sot --full_capture -k keys.log com.example.app
fritap -m -p log.pcap --enable_spawn_gating -v -do --anti_root --full_capture -k keys.log com.example.app
fritap -m -p log.pcap --enable_default_fd com.example.app
```

--------------------------------

### Install Documentation Dependencies

Source: https://fkie-cad.github.io/friTap/CONTRIBUTING_TO_DOCS?q=

Commands to install required Python packages for building the documentation.

```bash
pip install -r docs/requirements.txt
```

```bash
pip install mkdocs-material mkdocstrings[python] mkdocs-mermaid2-plugin
```

--------------------------------

### Install friTap via PyPI

Source: https://fkie-cad.github.io/friTap/getting-started/installation

Standard installation command for the latest stable version of friTap.

```bash
pip install fritap
```

```bash
pip install --upgrade fritap
```

--------------------------------

### Advanced friTap Execution Examples

Source: https://fkie-cad.github.io/friTap/platforms/wine?q=

Examples demonstrating verbose output, debug mode, and handling file paths with spaces.

```bash
# Analyze a Windows game
sudo fritap --experimental -k game_keys.log wine ~/.wine/drive_c/Games/game.exe

# Analyze with verbose output
sudo fritap --experimental -v -k keys.log wine /path/to/app.exe

# Debug mode for troubleshooting
sudo fritap --experimental -do -v wine /path/to/app.exe

# Spawn target whose path contains spaces — quote it so the shell passes one
# token; friTap preserves the argv and spawns it intact (no space-splitting).
sudo fritap --experimental -s -k keys.log wine "/home/u/.wine/drive_c/Program Files/App/app.exe"
```

--------------------------------

### Key Extraction CLI Example

Source: https://fkie-cad.github.io/friTap/development/documentation?q=

Practical example of extracting keys from Firefox and viewing the output.

```bash
# Extract keys from Firefox
fritap -k firefox_keys.log firefox

# View extracted keys
head firefox_keys.log
```

--------------------------------

### Install and Verify friTap

Source: https://fkie-cad.github.io/friTap

Standard installation via PyPI and verification of the CLI tool.

```bash
# Install from PyPI
pip install fritap

# Verify installation
fritap --help
```

--------------------------------

### Install Frida and Analysis Tools

Source: https://fkie-cad.github.io/friTap/development/development-setup?q=

Installs the Frida framework and optional analysis dependencies.

```bash
# Frida framework and tools
pip install frida-tools

# Optional analysis dependencies
pip install scapy watchdog
pip install AndroidFridaManager  # For Android development
```

--------------------------------

### Install Fritap on Windows

Source: https://fkie-cad.github.io/friTap/platforms

Commands for configuring a virtual environment or installing Fritap system-wide on Windows.

```bash
# Virtual environment
python -m venv fritap_env
fritap_env\Scripts\activate
pip install fritap

# System-wide installation
pip install fritap
```

--------------------------------

### Install Fritap on Linux

Source: https://fkie-cad.github.io/friTap/platforms

Commands for setting up a virtual environment or performing a system-wide installation on Linux systems.

```bash
# Virtual environment setup
python3 -m venv fritap_env
source fritap_env/bin/activate
pip install fritap

# System-wide installation
sudo pip3 install fritap
```

--------------------------------

### Test Documentation Examples and Links

Source: https://fkie-cad.github.io/friTap/development/documentation

Executes automated test scripts for Python and CLI examples and validates build integrity using mkdocs.

```bash
# Test all code examples
cd docs/examples
python test_python_examples.py

# Test CLI examples
bash test_cli_examples.sh

# Check for broken links
mkdocs build --strict
```

--------------------------------

### Install friTap via pip

Source: https://fkie-cad.github.io/friTap/getting-started/installation

Standard installation command for friTap on desktop platforms.

```bash
pip3 install fritap
```

```bash
pip install fritap
```

--------------------------------

### Install Development Utilities

Source: https://fkie-cad.github.io/friTap/development/development-setup?q=

Installs tools for package management, distribution, and code quality.

```bash
# Package management and distribution
pip install setuptools wheel twine

# Code quality tools
pip install isort bandit safety
```

--------------------------------

### Install Optional Dependencies

Source: https://fkie-cad.github.io/friTap/getting-started/installation

Install system-level tools and development packages to enable enhanced functionality and local development.

```bash
# Wireshark for live analysis
sudo apt install wireshark

# tcpdump for packet capture
sudo apt install tcpdump

# Development tools
pip install pytest ruff mypy
```

--------------------------------

### Install Wireshark Backend

Source: https://fkie-cad.github.io/friTap/api/cli

Installs the friTap extcap backend to enable friTap as a capture interface within Wireshark.

```bash
fritap install-backend wireshark
```

--------------------------------

### Install friTap for Development

Source: https://fkie-cad.github.io/friTap/getting-started/installation

Commands to clone the repository and install the package in editable mode with development dependencies.

```bash
# Clone the repository
git clone https://github.com/fkie-cad/friTap.git
cd friTap

# Install in development mode
pip install -e .

# Install with development dependencies
pip install -e .[dev]
```

--------------------------------

### Perform a Lean Installation

Source: https://fkie-cad.github.io/friTap/getting-started/installation

Installs friTap without dependencies to minimize footprint, requiring a manual minimal requirements file.

```bash
pip install friTap --no-deps && pip install -r requirements-minimal.txt
```

--------------------------------

### Install Linux Dependencies

Source: https://fkie-cad.github.io/friTap/development/contributing

Install essential build tools and Python development headers on Linux systems.

```bash
sudo apt-get install build-essential python3-dev
```

--------------------------------

### Dynamic discovery output example

Source: https://fkie-cad.github.io/friTap/platforms/wine?q=

Example output showing resolved function addresses and generated patterns for GnuTLS.

```text
[gnutls dyn] resolved _gnutls_call_keylog_func @ 0x780fa5c54e90
[gnutls dyn] version-specific pattern (32 bytes): 55 48 89 E5 41 57 41 56 …
[gnutls dyn] --patterns override:  { "modules": { "gnutls": { "wine": { "x64": { … } } } } }
```

--------------------------------

### Ubuntu/Debian Configuration

Source: https://fkie-cad.github.io/friTap/platforms/linux?q=

Installation of dependencies and management of AppArmor or Snap-specific constraints.

```bash
# Install dependencies
sudo apt install python3-dev libssl-dev

# AppArmor considerations
sudo aa-disable /usr/bin/fritap

# Snap package considerations
fritap --help  # If installed via snap
```

--------------------------------

### Continuous Monitoring Workflow

Source: https://fkie-cad.github.io/friTap/examples

Starts a live capture process for real-time monitoring.

```bash
# 1. Start live capture
fritap -l target &

# 2. Open Wireshark to live pipe
# File → Open → Select named pipe
```

--------------------------------

### iOS Quick Start

Source: https://fkie-cad.github.io/friTap/platforms

Run friTap on a jailbroken iOS device with Frida installed.

```bash
# Setup jailbroken device with frida
# Install Frida via Cydia/Sileo

# Basic usage
fritap -m -k keys.log --pcap traffic.pcap com.example.app
```

--------------------------------

### Troubleshoot Import Errors

Source: https://fkie-cad.github.io/friTap/development/development-setup?q=

Commands to verify installation and check Python path configuration.

```bash
# Ensure friTap is installed in development mode
pip install -e .

# Check Python path
python -c "import sys; print(sys.path)"

# Verify friTap import
python -c "import friTap; print(friTap.__version__)"
```

--------------------------------

### Android Quick Start

Source: https://fkie-cad.github.io/friTap/platforms

Initialize frida-server and run friTap on a rooted Android device.

```bash
# Setup device with root and frida-server
adb devices
adb shell su -c "/data/local/tmp/frida-server &"

# Basic usage
fritap -m -k keys.log --pcap traffic.pcap com.example.app
```

--------------------------------

### Run friTap with protocol flags

Source: https://fkie-cad.github.io/friTap/api/cli

Examples of launching friTap with specific protocol configurations and key logging.

```bash
fritap --protocol ssh -k keys.log sshd
fritap --protocol auto -k keys.log target
```

--------------------------------

### Install and Verify Frida

Source: https://fkie-cad.github.io/friTap/platforms/linux?q=

Install the frida-tools package and verify the installation with basic commands.

```bash
# Install frida-tools
pip3 install frida-tools

# Verify installation
frida --version

# Test local device
frida-ps
```

--------------------------------

### Initialize Python Environment

Source: https://fkie-cad.github.io/friTap/development/development-setup?q=

Sets up a virtual environment and installs the project in development mode along with dev dependencies.

```bash
# Create and activate virtual environment
python -m venv venv
source venv/bin/activate  # Linux/macOS
# venv\Scripts\activate   # Windows

# Install friTap in development mode
pip install -e .

# Install development dependencies
pip install -r requirements-dev.txt
```

--------------------------------

### Install Wine on Linux

Source: https://fkie-cad.github.io/friTap/platforms/wine?q=

Commands to install the Wine package on various Linux distributions and verify the installation.

```bash
# Ubuntu/Debian
sudo apt install wine wine64

# Fedora
sudo dnf install wine

# Arch Linux
sudo pacman -S wine

# Verify installation
wine --version
```

--------------------------------

### Example usage of ReplayController

Source: https://fkie-cad.github.io/friTap/api/python?q=

Demonstrates the typical workflow of opening a .tap file, iterating through summaries, and loading a specific flow.

```python
from friTap import ReplayController

with ReplayController("capture_20260507_153933.tap") as rc:   # offline / CI-runnable
    meta = rc.load()
    print("flows:", rc.flow_count)
    for summary in rc.get_summaries():
        print(summary.flow_id, summary.protocol, summary.host)
    flow = rc.get_flow(rc.get_summaries()[0].flow_id)
    print(flow.to_dict())
```

--------------------------------

### Install Python on macOS

Source: https://fkie-cad.github.io/friTap/getting-started/installation

Install Python 3 using Homebrew.

```bash
brew install python3
```

--------------------------------

### Prepare macOS System

Source: https://fkie-cad.github.io/friTap/platforms/macos

Initial system configuration steps for analysis environments.

```bash
# Disable SIP if necessary (not recommended for production)
# Grant required permissions to Terminal
# Install development tools
```

--------------------------------

### Install cryptography backend

Source: https://fkie-cad.github.io/friTap/protocols/telegram

Install the required cryptography library for offline decryption.

```bash
pip install cryptography
```

--------------------------------

### Initialize Analysis with Simple Targets

Source: https://fkie-cad.github.io/friTap/getting-started/concepts

Start by testing against known endpoints to verify basic functionality and key extraction.

```bash
fritap -k keys.log curl https://httpbin.org/get
```

--------------------------------

### Install ADB

Source: https://fkie-cad.github.io/friTap/getting-started/installation

Commands to install Android Debug Bridge on desktop platforms.

```bash
# Linux/macOS
sudo apt install android-tools-adb  # Ubuntu/Debian
brew install android-platform-tools # macOS

# Windows
# Download from https://developer.android.com/studio/releases/platform-tools
```

--------------------------------

### Install Homebrew on macOS

Source: https://fkie-cad.github.io/friTap/getting-started/installation

Command to install the Homebrew package manager on macOS.

```bash
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
```

--------------------------------

### Install frida-compile

Source: https://fkie-cad.github.io/friTap/development/development-setup?q=

Installs frida-tools to ensure the latest version of frida-compile is available.

```bash
# Install frida-tools (includes latest frida-compile)
pip install --upgrade frida-tools

# Verify installation
frida-compile --version
```

--------------------------------

### Process Spawning

Source: https://fkie-cad.github.io/friTap/api/cli

Launch an executable or app directly to capture startup activity.

```bash
fritap -s -k keys.log firefox
fritap -m -s -k keys.log com.example.app
```

--------------------------------

### Install Node.js Dependencies

Source: https://fkie-cad.github.io/friTap/development/development-setup?q=

Installs the necessary Node.js packages for TypeScript compilation.

```bash
# Install Node.js dependencies for TypeScript compilation
npm install

# Key dependencies include:
# - @types/frida-gum: TypeScript definitions for Frida
# - typescript: TypeScript compiler
# - Other build tools
```

--------------------------------

### Keylog Format Example

Source: https://fkie-cad.github.io/friTap/api/python?q=

Example of the keylog format used for SSL/TLS decryption.

```text
# -> key: CLIENT_RANDOM abc def
```

--------------------------------

### Clone and Run Automated Setup

Source: https://fkie-cad.github.io/friTap/development/development-setup?q=

Use the provided Python script to automatically configure the development environment after cloning the repository.

```bash
# Clone the repository
git clone https://github.com/fkie-cad/friTap.git
cd friTap

# Run automated setup
python dev/setup_dev.py
```

--------------------------------

### Code Block Syntax Examples

Source: https://fkie-cad.github.io/friTap/development/documentation

Examples of language-specific code blocks for documentation.

```bash
fritap -k keys.log target_app
```

```python
from friTap import SSL_Logger
logger = SSL_Logger("target_app")
```

```typescript
import { log } from "./util/log.js";
log("TypeScript example");
```

--------------------------------

### Initialize FriTapConfig

Source: https://fkie-cad.github.io/friTap/api/python?q=

Create a configuration instance by specifying the target application, device behavior, and output file paths.

```python
config = FriTapConfig(
    target="com.example.app",
    device=DeviceConfig(mobile=True, spawn=True),
    output=OutputConfig(pcap="capture.pcap", keylog="keys.log"),
)
```

--------------------------------

### Verify friTap installation

Source: https://fkie-cad.github.io/friTap/getting-started/installation

Use these commands to confirm the installation and view available options.

```bash
# Check version
fritap --version

# Check help
fritap --help
```

--------------------------------

### Install frida-server on iOS

Source: https://fkie-cad.github.io/friTap/getting-started/installation

Commands to SSH into an iOS device and install the server package.

```bash
# SSH into your device
ssh root@your-device-ip

# Install frida-server
cydia://package/re.frida.server
```

--------------------------------

### Initialize SSL Logger in Python

Source: https://fkie-cad.github.io/friTap/development/documentation

A complete example demonstrating how to initialize the SSL_Logger and extract keys from a target process.

```python
# Complete example with imports and error handling
import logging
from friTap import SSL_Logger

# Configure logging
logging.basicConfig(level=logging.INFO)

try:
    # Initialize SSL logger
    logger = SSL_Logger(
        target="firefox",
        mobile=False,
        verbose=True
    )

    # Start key extraction
    with logger:
        results = logger.extract_keys("firefox_keys.log")

        print(f"Analysis complete:")
        print(f"  Keys extracted: {len(results['keys'])}")
        print(f"  Libraries detected: {results['metadata']['libraries']}")
        print(f"  Duration: {results['metadata']['duration']:.2f}s")

except Exception as e:
    print(f"Error: {e}")
    print("Try running with sudo or check if target process exists")
```

--------------------------------

### System Preparation Commands

Source: https://fkie-cad.github.io/friTap/platforms/windows

Initial configuration steps required before running analysis tools on Windows.

```bash
# Run as Administrator
# Disable antivirus temporarily
# Configure Windows Firewall exceptions
# Install required dependencies
```

--------------------------------

### Initialize FriTap Configuration

Source: https://fkie-cad.github.io/friTap/api/python?q=

Example of constructing a FriTapConfig object to define target application, device settings, and output files.

```python
config = FriTapConfig( target="com.example.app", device=DeviceConfig(mobile=True, spawn=True), output=OutputConfig(pcap="capture.pcap", keylog="keys.log"), )
```

--------------------------------

### Install Node.js Dependencies via npm

Source: https://fkie-cad.github.io/friTap/development/development-setup?q=

Command to install dependencies defined in package.json.

```bash
npm install
```

--------------------------------

### Execute documentation build and deployment commands

Source: https://fkie-cad.github.io/friTap/development/documentation

Commands for building the site, deploying to GitHub Pages, and validating link integrity.

```bash
# Build documentation
mkdocs build

# Deploy to GitHub Pages (maintainers only)
mkdocs gh-deploy

# Check for broken links
mkdocs build --strict
```

--------------------------------

### Execute friTap with pattern files and CLI flags

Source: https://fkie-cad.github.io/friTap/advanced/patterns

Examples of using pattern files, debug output, and manual offset overrides via the command line.

```bash
# Use a pattern file for key extraction (deep-merged on top of defaults)
fritap --patterns patterns.json -k keys.log target_app

# Mobile target
fritap -m --patterns android_patterns.json -k keys.log com.example.app

# See what matched / why it did not (debug output)
fritap -do -v --patterns patterns.json target_app

# Use fixed addresses instead of scanning
fritap --offsets offsets.json -k keys.log target_app

# Force a full library scan (do not trust cached/known module lists)
fritap --force-scan --patterns patterns.json -k keys.log target_app
```

--------------------------------

### Install macOS Dependencies

Source: https://fkie-cad.github.io/friTap/development/contributing

Install Node.js and Xcode command line tools on macOS.

```bash
brew install node
xcode-select --install
```

--------------------------------

### Example Pull Request Content

Source: https://fkie-cad.github.io/friTap/development/pull-requests?q=

A concrete example of a well-structured pull request submission.

```markdown
## Add BoringSSL Pattern-Based Hooking Support

This PR adds support for BoringSSL detection and hooking using byte patterns, 
enabling friTap to work with statically-linked BoringSSL in applications like 
Flutter and Chrome.

## Type of Change

- [x] New feature (non-breaking change that adds functionality)

## Changes Made

- **Agent Changes**:
  - Added `agent/ssl_lib/boringssl_patterns.ts` with pattern-based detection
  - Implemented ARM64, x64, and ARMv7 pattern matching
  - Added fallback patterns for different BoringSSL versions

- **Platform Integration**:
  - Updated Linux, Android, and Windows platform handlers
  - Added pattern file loading and validation

- **Testing**:
  - Added unit tests for pattern matching logic
  - Created integration tests with mock BoringSSL modules
  - Added ground truth tests with Flutter applications

- **Documentation**:
  - Updated pattern-based hooking guide
  - Added BoringSSL-specific examples
  - Created troubleshooting section

## Testing

- [x] Tests pass locally (`python run_tests.py`)
- [x] New tests added for pattern matching functionality
- [x] Manual testing performed on:
  - [x] Linux (Ubuntu 20.04, Flutter app)
  - [x] Android (API 28, 30, 33 with Chrome and Flutter apps)
  - [x] Windows (Windows 10, Chrome browser)
  - [ ] macOS (pending access to test environment)
  - [ ] iOS (requires jailbroken device)

## Example Usage

```bash
# Generate patterns with BoringSecretHunter
mkdir -p binary results  
cp libflutter.so binary/
docker run --rm -v "$(pwd)/binary":/usr/local/src/binaries -v "$(pwd)/results":/host_output boringsecrethunter

# Use patterns with friTap
fritap --patterns results/libflutter.so_patterns.json -k keys.log com.flutter.app

```
```

--------------------------------

### Set Up Analysis Environment

Source: https://fkie-cad.github.io/friTap/platforms/linux?q=

Creates a dedicated directory and a Python virtual environment for isolated friTap execution.

```bash
# Create dedicated analysis directory
mkdir ~/fritap_analysis
cd ~/fritap_analysis

# Set up virtual environment
python3 -m venv fritap_env
source fritap_env/bin/activate
pip install fritap
```

--------------------------------

### Troubleshoot friTap Installation

Source: https://fkie-cad.github.io/friTap/troubleshooting/common-issues?q=

Commands to update environment tools and resolve dependency conflicts during installation.

```bash
# Update pip and setuptools
python -m pip install --upgrade pip setuptools

# Install with verbose output to see error details
pip install -v fritap

# Try installing dependencies separately
pip install frida frida-tools
pip install fritap
```

--------------------------------

### Install friTap on WSL2

Source: https://fkie-cad.github.io/friTap/platforms/windows

Commands to install WSL2 and the friTap package within a Linux environment.

```bash
# Install WSL2 (recommended for Linux-like environment)
wsl --install -d Ubuntu

# In WSL2 terminal:
sudo apt update
sudo apt install python3 python3-pip
pip3 install fritap
```

--------------------------------

### Download frida-server

Source: https://fkie-cad.github.io/friTap/platforms/android?q=

Steps to identify device architecture and download the corresponding frida-server binary.

```bash
# Check device architecture
adb shell getprop ro.product.cpu.abi

# Download matching frida-server from GitHub releases
# Example for ARM64:
wget https://github.com/frida/frida/releases/download/17.0.0/frida-server-17.0.0-android-arm64.xz
xz -d frida-server-17.0.0-android-arm64.xz

```

--------------------------------

### Install Development Tools

Source: https://fkie-cad.github.io/friTap/platforms/ios

Commands to install necessary dependencies for friTap development on macOS and Linux.

```bash
# Install required tools
# macOS (recommended)
brew install usbmuxd
brew install libimobiledevice

# Linux
sudo apt install usbmuxd libimobiledevice-tools

# Install frida-tools
pip3 install frida-tools
```

--------------------------------

### Verify Development Setup

Source: https://fkie-cad.github.io/friTap/development/development-setup?q=

Runs tests to verify Python imports, TypeScript compilation, and the test framework.

```bash
# Test Python installation
python -c "import friTap; print('friTap imported successfully')"

# Test TypeScript compilation
npm run build

# Verify compiled agents exist
ls -la friTap/fritap_agent.js friTap/fritap_agent_legacy.js

# Run test framework check
python run_tests.py summary
```

--------------------------------

### Install TUI Dependencies

Source: https://fkie-cad.github.io/friTap/getting-started/tui?q=

Commands to ensure the required Textual package is installed for TUI functionality.

```bash
pip install fritap[tui]      # extras form shown by friTap's error message
pip install textual>=0.80.0  # or install Textual directly
```

--------------------------------

### Install missing Frida tools

Source: https://fkie-cad.github.io/friTap/getting-started/installation

Install frida-tools via pip if the frida command is not found.

```bash
# Install frida-tools
pip install frida-tools

# Verify installation
frida --version
```

--------------------------------

### Execute CLI Commands

Source: https://fkie-cad.github.io/friTap/development/documentation

Examples of checking the version and running key extraction via the command line interface.

```bash
# Show command progression and expected output
$ fritap --version
friTap 1.3.5.0

$ fritap -k keys.log firefox
[*] Starting friTap analysis
[*] Target: firefox (PID: 12345)
[*] Detected libraries: OpenSSL 1.1.1
[*] SSL hooks installed successfully
[*] Key extraction active
[*] Press Ctrl+C to stop

# After user browses some HTTPS sites
^C
[*] Analysis stopped
[*] Extracted 5 SSL keys to keys.log

$ head keys.log
CLIENT_RANDOM 52345678... ABCDEF123456...
CLIENT_RANDOM 87654321... FEDCBA987654...
```

--------------------------------

### Install Python Core Development Tools

Source: https://fkie-cad.github.io/friTap/development/development-setup?q=

Installs essential testing, linting, and type-checking tools.

```bash
# Essential development tools
pip install pytest pytest-cov black flake8 mypy

# Testing utilities
pip install pytest-mock pytest-timeout pytest-xdist

# Pre-commit hooks
pip install pre-commit
```
Tokens:
Raw