Astro IPFS Client

A native macOS IPFS client built with Boxo and Wails, providing a fast and user-friendly interface for interacting with the InterPlanetary File System.

Features

CID Support

• CIDv0
• CIDv1

IPLD (InterPlanetary Linked Data)

• UnixFS - Directories and files
• Raw Nodes - Direct block access
• HAMT Shards - Scalable large directory support

Content Routing

• DHT - Distributed Hash Table for peer and content discovery
• IPNI - InterPlanetary Network Indexer for efficient content routing

Block Exchange

• Bitswap - IPFS's primary block exchange protocol
• HTTP - Gateway-based content retrieval

Installation

Prerequisites

• Go 1.25.4 or later
• Node.js and npm
• Wails CLI

Building from Source

1. Install Wails CLI

   go install github.com/wailsapp/wails/v2/cmd/wails@latest

2. Clone the repository

   git clone https://github.com/dozyio/astro-ipfs-client.git
   cd astro-ipfs-client

3. Build the application

   wails build

Development

Running in Development Mode

wails dev

This will start the application in development mode with hot reload enabled for both frontend and backend changes.

Roadmap

Planned features in no particular order

• UnixFS Symlinks
• Non-UnixFS DAG support
• IPNS (InterPlanetary Naming System)
• DNSLink resolution
• GraphSync protocol
• CAR file import/export
• OS tray integration (requires Wails v3)
• Multi-window support (requires Wails v3)
• Auto-update functionality
• Leech mode UI toggle (partially implemented)
• Bandwidth limiter
• UPnP / NAT-PMP / PCP support
• Protocol registration (ipfs:// URLs)
• Manual peer connections
• File adder/uploader
• IP blocklist management
• Delete cache when removing downloads

Known Issues

• Bandwidth reporting inaccuracies when downloading from the same peer
• HTTP download bandwidth reporting not functioning correctly

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

See the repository for license information.