Kardoo

A simple and clean desktop tool to view, edit and manage your VCF (vCard) contact files.

---

Features

• 📂 Open single or multi-contact .vcf files
• ✏️ Edit all standard vCard fields (v2.1, v3.0, v4.0)
  • Name, photo, birthday, anniversary
  • Phone numbers, emails, addresses, URLs
  • Organization, title, role, nickname
  • Languages, messaging (IMPP), related persons
  • Notes, geo, timezone, gender, categories
  • Sound (pronunciation) — playback or download
• 💾 Save changes back to the original .vcf file
• 🔍 Search contacts by name or organization
• 🖼️ Change contact photo from a local image file
• ⚠️ Unsaved changes protection on contact switch or file open

---

🏗️ Tech Stack

Layer	Technology
Framework	Wails v2
Frontend	React + Vite
UI	Ant Design
Backend	Go
i18n	react-i18next
QR Code	qrcode
Date parsing	dayjs

---

Getting Started

Prerequisites

• Go 1.21+
• Node.js 18+
• Wails CLI

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

Install & Run

git clone https://github.com/your-username/kardoo.git
cd kardoo
wails dev

Build

wails build

The compiled binary will be in build/bin/.

---

License

MIT © 2025 abdelkader