RJ Converter - How should it be used?

 

Converter: A Modern Way to Convert Contacts Between Excel and VCF

Working with contact data often means dealing with different file formats. Excel is widely used for storing customer lists, phone numbers, and business contacts, while VCF (vCard) is commonly used for importing contacts into phones, email clients, and contact management applications.

Moving contact information between these formats, however, is not always as simple as it sounds. Different Excel layouts, inconsistent phone number formats, language differences, and unusual XLSX files can make the process frustrating.

Converter is a modern Windows desktop application designed to make this process much easier. It allows users to convert contacts between Excel (.xlsx) and vCard (.vcf) formats in just a few steps, while automatically handling many of the common problems that can appear during conversion.

The application is built with Flutter and Dart and combines practical file-conversion functionality with a modern desktop interface, multilingual support, animations, and intelligent contact processing.

What Is Converter?

Converter is a Windows desktop application focused specifically on contact conversion.

Its primary purpose is simple:

Convert Excel files to VCF files and VCF files back to Excel.

This makes it useful in situations where a user needs to move a large contact list from a spreadsheet into a phone, or export existing phone contacts into a spreadsheet for editing, organization, or further processing.

Instead of manually copying individual contacts, Converter allows users to process the information in bulk.

The application can read .xlsx files, detect relevant columns, clean and standardize telephone numbers, and generate valid VCF contact files. It also supports the reverse process, allowing VCF contacts to be exported into an Excel spreadsheet.

Why Excel and VCF Conversion Matters

Excel and VCF serve very different purposes.

Excel is ideal for managing structured information in rows and columns. Companies and individuals frequently use spreadsheets for customer databases, employee lists, marketing databases, and personal contact lists.

VCF, on the other hand, is designed specifically for contact information. A VCF file can contain details such as a person's name and phone number and can be imported into compatible contact applications.

The problem occurs when information needs to move from one environment to another.

Imagine having hundreds or thousands of contacts stored in an Excel spreadsheet. Adding those contacts individually to a phone would be extremely time-consuming. Converter addresses this problem by providing a dedicated workflow for bulk conversion.

Smart Header Detection

One of the practical features of Converter is its smart header detection.

Excel spreadsheets do not always use the same column names. One file may use Name and Phone, while another may use Customer and Mobile. Depending on the language, the same information may also appear under completely different headings.

Converter is designed to recognize common variations automatically.

The application can detect name and phone columns regardless of their exact position or wording. Its detection logic supports variations such as:

  • name

  • user

  • customer

  • adı soyadı

  • tel

  • mobile

  • telefon

This means users do not have to reorganize their spreadsheet simply to make it compatible with the converter.

International Phone Number Support

Phone numbers are another major source of formatting problems.

Different countries use different country codes and numbering formats, and the same number may appear in several different forms inside an Excel document.

Converter includes international phone number support and recognizes 39 country codes, including countries such as Azerbaijan, Turkey, Russia, the United States, the United Kingdom, Germany, India, and China.

During the conversion process, phone numbers can be recognized and standardized so that the generated contact data is more consistent.

This is particularly useful for users working with international customer databases or contact lists containing numbers from multiple countries.

Support for 34 Languages

Converter is not limited to a single language.

The application includes full interface localization for 34 languages, together with a built-in language switcher. The supported languages include Azerbaijani, English, Turkish, Russian, Arabic, Persian, Hebrew, Urdu, German, French, Spanish, Italian, Portuguese, Dutch, Romanian, Armenian, Georgian, Hindi, Bengali, Punjabi, Tamil, Telugu, Marathi, Chinese, Japanese, Korean, Thai, Vietnamese, Indonesian, Malay, Javanese, Tagalog, Swahili, and Hausa.

The language selector uses native language names, making it easier for users to identify their preferred language without needing to understand another language first.

This multilingual approach makes the application suitable for a wider international audience.

Handling Difficult Excel Files

Not every XLSX file is created in exactly the same way.

Some spreadsheets contain metadata or structures generated by different versions of Excel, Excel Online, different regional settings, or specialized spreadsheet features. These differences can sometimes cause compatibility problems with standard XLSX parsers.

Converter includes a robust Excel sanitizer designed to address certain non-standard Excel metadata.

The project documentation specifically mentions compatibility considerations involving Chinese-locale date formats, dynamic array metadata, and Excel Online output. The sanitizer helps clean problematic metadata before the application processes the spreadsheet.

This is an important part of the application because reliable conversion is not only about reading ordinary spreadsheets—it is also about handling files that may have been created in different environments.

A Modern Desktop Experience

Although Converter is primarily a utility application, the project does not treat its user interface as an afterthought.

The application uses a modern glassmorphism-inspired design with blur effects, gradient backgrounds, SVG icons, Lottie animations, and interactive loading screens.

The application also launches in a frameless fullscreen mode, replacing the standard Windows title bar with custom window controls.

This gives Converter a more modern desktop appearance while allowing the application to maintain a focused interface dedicated to the conversion workflow.

Animations are also used throughout the experience, including dedicated animations for loading, conversion, phone-related actions, file operations, and license states.

Built with Flutter

Converter is built using Flutter and Dart, with Windows desktop support as its target platform.

The project uses several Flutter packages to handle different parts of the application:

  • provider for state management

  • window_manager for desktop window behavior

  • excel and file_picker for file operations

  • archive for XLSX sanitization

  • shared_preferences for storage and caching

  • lottie and flutter_svg for animations and interface elements

  • url_launcher for external links

  • flutter_localizations and intl for localization

This technology stack allows the application to combine native desktop functionality with a flexible modern UI architecture.

Licensing and Trial System

Converter also includes a built-in licensing mechanism.

The application provides a one-time free trial before requiring a license code. License-related states are integrated into the application interface and are supported by dedicated animations and licensing logic.

This gives the project a foundation for distributing the application while still allowing users to test its functionality before obtaining a license.

A Structured and Maintainable Architecture

Behind the visual interface, the project follows a structured Flutter architecture.

The source code separates localization, models, screens, services, UI components, and Windows-specific files.

For example, the project contains dedicated screens for Excel-to-VCF and VCF-to-Excel conversion, services for conversion and settings, shared utilities for file and phone-number processing, and reusable UI widgets for headers, glass cards, loading overlays, license badges, and custom window controls.

This structure makes it easier to maintain the application and expand its functionality in the future.

Getting Started

For users who simply want to use the application, the easiest option is to download the prebuilt Windows installer from the project's Releases page and follow the installation wizard.

For developers, the project can also be built directly from source.

After installing the Flutter SDK with Windows desktop support, the project can be prepared with:

flutter pub get

Localization files can then be generated with:

flutter gen-l10n

The application can be launched in development mode using:

flutter run -d windows

And a release build can be generated with:

flutter build windows --release

The compiled Windows application is produced under the project's Windows release directory.

An Evolution-Focused Project

Converter has already grown beyond the basic idea of simply changing one file extension into another.

Its current feature set combines bidirectional conversion, intelligent column detection, international phone-number handling, Excel sanitization, 34-language localization, custom desktop controls, animations, and an integrated licensing system.

The project also remains open to improvements. Developers can contribute by improving conversion logic, adding languages, refining the interface, fixing bugs, or submitting other useful changes through the project's contribution workflow.

Conclusion

Converter is built around a very specific problem: making contact data easier to move between Excel and VCF.

What makes the project notable is that it does not stop at basic file conversion. It attempts to solve the practical problems users encounter along the way—different spreadsheet layouts, international phone numbers, unusual Excel metadata, multiple languages, and the need for a modern desktop experience.

By combining these features into a focused Windows application, Converter provides a practical workflow for anyone who needs to move contact information between spreadsheets and digital contact systems.

At its core, the idea remains simple:

Take a potentially frustrating contact-conversion task and turn it into a fast, structured, and user-friendly process.

Comments