A powerful, modern web-based contact management application that allows you to import, edit, and export VCF (vCard) contact files directly in your browser. No server required, no data uploaded to the cloud - everything happens locally on your device.
- Import VCF Files: Support for standard vCard format (v3.0)
- Export Modified Contacts: Download your edited contacts as a new VCF file
- Cross-Platform Compatible: Works with contacts from iPhone, Android, Outlook, Gmail, and more
- No Upload Required: All processing happens locally in your browser
- View All Details: Comprehensive display of contact information in organized cards
- Inline Editing: Edit contacts directly with intuitive form fields
- Add New Contacts: Create contacts from scratch with all standard fields
- Smart Delete: Safe deletion with custom confirmation modal (no popup blockers!)
- Real-time Updates: See changes immediately as you edit
- Names: Full name, given name, family name, middle name, prefix, suffix
- Organization: Company name and job title
- Communication: Multiple phone numbers and email addresses with type labels
- Location: Full address support (street, city, state, zip, country)
- Additional: Website URLs, notes, and birthday information
- Type Support: Different types for phones (CELL, WORK, HOME) and emails
- Responsive Design: Works perfectly on desktop, tablet, and mobile devices
- Beautiful Gradients: Modern CSS with smooth animations and hover effects
- Intuitive Navigation: Easy-to-use interface with clear visual feedback
- Status Messages: Real-time feedback for all operations
- Card-Based Layout: Clean, organized display of contact information
- Download the HTML file from this repository
- Open it in any modern web browser
- Click "Choose VCF File" to import your contacts
- Start managing your contacts immediately!
git clone https://github.com/xsukax/xsukax-VCF-Contacts-Manager.git
cd xsukax-VCF-Contacts-Manager
# Open xsukax-VCF-Contacts-Manager.html in your browser- Click the "📂 Choose VCF File" button
- Select your
.vcfcontact file from your device - All contacts will be automatically parsed and displayed
- Click the "✏️ Edit" button on any contact card
- Modify any field directly in the form
- Click "✓ Save" to confirm changes or "✕ Cancel" to discard
- Click "➕ Add Contact" in the top controls
- A new contact form will appear at the top of the list
- Fill in the contact details and save
- Click the "🗑️ Delete" button on any contact
- Confirm deletion in the modal dialog
- Contact is permanently removed from the list
- Click "💾 Save VCF" to download your modified contacts
- The file will be saved as
contacts.vcfto your downloads folder - Import this file into any contacts application
- Pure HTML5: No frameworks or dependencies
- Modern CSS3: Flexbox, Grid, Gradients, Animations
- Vanilla JavaScript: ES6+ features for optimal performance
- File API: Browser-native file reading capabilities
- ✅ Chrome 60+ (Recommended)
- ✅ Firefox 55+
- ✅ Safari 12+
- ✅ Edge 79+
- ✅ Mobile browsers (iOS Safari, Chrome Mobile)
- 🔒 100% Client-Side: No data is sent to any server
- 🔒 No Tracking: No analytics or external scripts
- 🔒 Local Processing: All file parsing happens in your browser
- 🔒 No Storage: Files are not saved in browser storage
The application supports the following vCard 3.0 properties:
FN- Formatted NameN- Structured Name (Family, Given, Middle, Prefix, Suffix)ORG- OrganizationTITLE- Job TitleTEL- Telephone Numbers (with TYPE parameters)EMAIL- Email Addresses (with TYPE parameters)ADR- Addresses (with TYPE parameters)URL- Website URLsNOTE- NotesBDAY- Birthday
- Backup and edit your phone contacts
- Clean up duplicate or incomplete contact information
- Merge contacts from multiple devices
- Organize contact data before switching phones
- Manage company contact directories
- Import/export contacts between different business applications
- Clean up CRM data exports
- Prepare contact lists for marketing campaigns
- Test contact import/export functionality in applications
- Generate sample contact data for testing
- Convert between different contact formats
- Validate VCF file structures
- Bypasses popup blockers with custom CSS modals
- Smooth animations and professional styling
- Keyboard navigation support (Escape to cancel)
- Click-outside-to-close functionality
- Handles malformed VCF files gracefully
- Supports multiple phone numbers and emails per contact
- Preserves TYPE parameters for proper categorization
- Maintains data integrity during edit operations
- Mobile-first approach with touch-friendly interfaces
- Adaptive layouts for all screen sizes
- Optimized typography and spacing
- High contrast ratios for accessibility
Contributions are welcome! Here are some ways you can help:
- Open an issue with detailed description
- Include browser version and operating system
- Provide sample VCF files that cause issues (if applicable)
- Suggest new contact fields or formats
- Request UI/UX improvements
- Propose performance optimizations
- Fork the repository
- Create a feature branch (
git checkout -b feature/amazing-feature) - Commit your changes (
git commit -m 'Add amazing feature') - Push to the branch (
git push origin feature/amazing-feature) - Open a Pull Request
This project is licensed under the GNU General Public License v3.0 - see the LICENSE file for details.
- File not loading: Ensure the file has a
.vcfextension and contains valid vCard data - Missing contacts: Check if the VCF file uses a supported vCard version (3.0 recommended)
- Export issues: Make sure your browser allows file downloads
- 📧 Open an issue on GitHub
- 💬 Check existing issues for solutions
- 📖 Review the code comments for technical details
- ✨ Initial release
- 📱 Full VCF import/export support
- ✏️ Inline contact editing
- 🗑️ Custom delete confirmation modal
- 📱 Responsive design
- 🎨 Modern UI with animations
- 🔍 Search and filter contacts
- 📊 Bulk operations (delete multiple, import multiple files)
- 🏷️ Contact tagging and categorization
- 📤 Export to different formats (CSV, JSON)
- 🌙 Dark mode support
- ♿ Enhanced accessibility features
If you find this project useful, please consider giving it a star! It helps others discover the project and motivates continued development.
Made with ❤️ for the open source community
xsukax VCF Contacts Manager - Making contact management simple, secure, and accessible to everyone.