privacy-toolkit/tools/frame
2025-12-31 19:44:07 -07:00
..
install.sh Initial commit 2025-12-31 19:44:07 -07:00
README.md Initial commit 2025-12-31 19:44:07 -07:00

Frame Wallet

Privacy-focused, system-wide web3 wallet for Linux.

What is Frame?

Frame is a native OS-level wallet that provides:

  • Hardware wallet support (Ledger, Trezor, GridPlus Lattice)
  • Multi-chain support (Ethereum, Optimism, Arbitrum, Polygon, etc.)
  • System tray integration
  • No browser extension required
  • Open source and auditable

Why Frame?

Privacy Benefits:

  • No tracking or analytics
  • Open source (MIT license)
  • No account required
  • Works offline for signing

Security Benefits:

  • Hardware wallet isolation from browser
  • Native OS process (not a browser extension)
  • System-level permission model
  • No extension attack surface

Installation

./install.sh

This will:

  1. Install Frame from official sources
  2. Create X11-mode launcher at ~/bin/frame
  3. Create desktop entry with proper Electron flags

Display Compatibility

Frame is an Electron app. The install script forces X11 mode for stability:

--ozone-platform=x11  # Force X11 (Wayland has issues)

If you want to try Wayland, edit ~/bin/frame and use:

  • Auto-detect: --ozone-platform-hint=auto
  • Pure Wayland: --enable-features=UseOzonePlatform --ozone-platform=wayland

Usage

frame                    # Launch Frame

Then:

  1. Click the Frame icon in system tray
  2. Add accounts (hot wallet or hardware)
  3. Connect to dapps via Frame's injected provider

Hardware Wallet Setup

Ledger

  1. Install Ledger Live and update firmware
  2. Install Ethereum app on Ledger
  3. Enable "Blind signing" in Ethereum app settings
  4. Connect Ledger and unlock
  5. Frame will detect it automatically

Trezor

  1. Update Trezor firmware via Trezor Suite
  2. Connect Trezor
  3. Frame will prompt for PIN

GridPlus Lattice

  1. Pair Lattice via Frame settings
  2. Frame connects over network

Resources