# SeedSigner User Guide

![SeedSigner Logo](guides/en/images/SeedSigner_Logo.png){w=400px align=center}

---

## What is SeedSigner?

SeedSigner is an open-source, air-gapped Bitcoin signing device that helps you manage seed phrases and sign transactions securely. Built using affordable, off-the-shelf hardware components (Raspberry Pi Zero, camera module, and LCD display), SeedSigner provides a stateless solution for Bitcoin key management without storing private keys on the device.

### Key Features

- **🔒 Air-gapped Security**: Complete network isolation for maximum security
- **📱 QR Code Communication**: Interact with wallets via QR codes only
- **🎲 Multiple Entropy Sources**: Generate seeds using camera, dice, or calculation methods
- **🔧 Open Source**: Fully auditable code and hardware design
- **💰 Cost-effective**: Build your own device for under $50
- **🛡️ Stateless Design**: No private key storage on device

---

## 🌍 User Guides by Language

Choose your preferred language to access the complete SeedSigner user guide:

### 🇺🇸 English

**[📖 English User Guide](guides/en/README_en.md)**
*Complete documentation in English*

### 🇪🇸 Español

**[📖 Guía del Usuario en Español](guides/es/README_es.md)**
*Documentación completa en español*

### 🇫🇷 Français

**[📖 Guide d'Utilisation en Français](guides/fr/README_fr.md)**
*Documentation complète en français*

### 🇩🇪 Deutsch

**[📖 Benutzerhandbuch auf Deutsch](guides/de/README.md)**
*Vollständige Dokumentation auf Deutsch*

### 🇮🇹 Italiano

**[📖 Guida Utente in Italiano](guides/it/README.md)**
*Documentazione completa in italiano*

### 🇳🇱 Nederlands

**[📖 Gebruikershandleiding in het Nederlands](guides/nl/README.md)**
*Volledige documentatie in het Nederlands*

### ​🇨​​🇦​ Català

**[📖 Guia d'Usuari en Català](guides/ca/README.md)**
*Documentació completa en català*

### 🇯🇵 日本語 (Beta)

**[📖 日本語ユーザーガイド](guides/ja/README.md)**
*日本語での完全なドキュメント*

### 🇨🇳 简体中文 (Beta)

**[📖 简体中文用户指南](guides/zh/README.md)**
*简体中文完整文档*

---

## 🤝 Contributing

We welcome contributions to improve and expand this user guide!

### How to Contribute

- **Translations**: Help us add new languages or improve existing translations
- **Content**: Suggest improvements to existing documentation
- **Screenshots**: Provide updated screenshots for your language
- **Bug Reports**: Report any errors or unclear instructions

### Adding a New Language

1. Fork this repository
2. Create a new directory under `guides/` using the appropriate language code
3. Translate the content while maintaining the same structure
4. Update this main README.md to include your language
5. Submit a pull request

### Language Codes

We use ISO 639-1 language codes for directory naming:

- `en` - English
- `es` - Spanish
- `fr` - French
- `de` - German
- `it` - Italy
- `nl` - Nederlands
- `ca` - Catalan
- `ja` - Japanese
- `zh` - Chinese

---

## 🔗 Official Resources

- **SeedSigner Website**: [seedsigner.com](https://seedsigner.com/)
- **Official GitHub**: [github.com/SeedSigner/seedsigner](https://github.com/SeedSigner/seedsigner)
- **Hardware Guide**: [seedsigner.com/hardware](https://seedsigner.com/hardware/)
- **Community Support**: Visit the SeedSigner community forums and chat groups

---

## ⚠️ Important Security Notice

SeedSigner is designed for users who understand Bitcoin security principles. Always:

- ✅ Verify your seed phrase backups
- ✅ Practice with small amounts first
- ✅ Maintain air-gap security
- ✅ Use in private environments
- ✅ Double-check all transaction details

**Remember**: Bitcoin transactions are irreversible. Take time to understand each step before proceeding with real funds.

---

## 📄 License

This user guide is released under the MIT License. The SeedSigner software and hardware designs are open source - see the official repository for licensing details.

---

*This community-maintained guide is updated regularly. For the latest official information, always refer to the SeedSigner project's official resources.*