Welcome!

Welcome to VisualCard!

VisualCard is a library that parses the VCard Files (.vcf), whether it's a single contact or a multiple contact file. It's compatible with both .NET Framework 4.8 and the modern .NET runtime.

Release history

Below is the release history of the library:

February 15, 2026

v4.1.2.3

Updated libraries

December 1, 2025

v4.1.2.2

Fixed logging always writing to log files even if logging is disabled

November 23, 2025

v4.1.2.1

Fixed agent comparison always returning false

October 27, 2025

v4.1.2

General improvements

October 25, 2025

v4.1.1

General improvements

July 3, 2025

v4.1.0

Added localized strings

April 30, 2025

v4.0.0.3

General improvements

April 23, 2025

v4.0.0.2

General improvements

February 21, 2025

v4.0.0.1

General improvements and bug fixes

February 16, 2025

v4.0.0

You can now add, edit, and delete properties and components!

Added social media URI generation

Introducing VisualCard.Common that contains versit-agnostic tools

Added logging support

IANA and X-nonstandard properties are no longer versit-specific

Refactored the codebase

General improvements

January 16, 2025

v3.3.0

Added QUOTED-PRINTABLE support for cards and calendars

General improvements

November 9, 2024

v3.2.0

Merged CalendarValueInfo and CardValueInfo

ValueInfo equality comparison now also compares the values

General improvements

October 12, 2024

v3.1.2

Updated Textify

October 10, 2024

v3.1.1

Updated libraries

October 9, 2024

v3.1.0

Added PropertyInfo

Added part dictionary properties (strings, integers, and parts array instances)

Added support for nested property groups

Better support for whitespace padded properties and their arguments

General improvements and bug fixes

October 3, 2024

v3.0.0

Added more vCard and vCalendar properties (100% of them!)

Added recurrence parser

Added duration, date/time, and UTC offset parsers

Added property grouping support

Added value info, property info, and argument info instances

Added support for more than one string and integer

Moved extra tools to VisualCard.Extras

Massive improvements to vCard and vCalendar parsers

Property names are now case-insensitive

Mass migrated several text-based arrays to strings

General improvements and bug fixes

September 23, 2024

v2.3.0

Added more calendar properties

Added type support for calendars

September 23, 2024

v2.2.0

Improved time zone offset support

September 11, 2024

v2.1.0

Added a lot of vCalendar properties

Added all calendar components

Added full nullable support

Added full calendar saving

Added calendar component comparison

Improved calendar event and component querying

Improved validation code

General improvements and bug fixes

September 3, 2024

v2.0.0

Added very basic vCalendar implementation

Added nested cards support

Added UID support

Improved newline handling

General improvements and bug fixes

August 13, 2024

v1.1.1

Updated libraries

July 2, 2024

v1.1.0

Added getting blob stream from keys, images, sounds, and logos

General improvements

June 22, 2024

v1.0.1

Updated libraries

April 4, 2024

v1.0.0.1

General improvements

April 4, 2024

v1.0.0

Added new types

Added global line folding

Added a dictionary representing values

Added videophone and phonetics to MeCard

Added vCard to MeCard conversion

Added card generator

Overhauled the parser!

Enforced ALTID and types

Enforced cardinality

Fixed bugs and issues

General improvements

February 14, 2024

v0.9.3

Updated libraries

February 6, 2024

v0.9.2

Changed symbol nupkg to snupkg

December 21, 2023

v0.9.1

Facilitated debugging by using Source Link

December 16, 2023

v0.9.0

Added support for vCard 5.0 contacts

Added AGENT for v2.1, 3.0, and 5.0 vCard contacts

General improvements

November 25, 2023

v0.8.4

Improved MeCard conversion

November 14, 2023

v0.8.3

Updated all libraries

October 25, 2023

v0.8.2

Upgraded the SQLite library for Android contacts support

October 11, 2023

v0.8.1

Updated the SQLite support library to 7.0.12

October 1, 2023

v0.8.0

Added LABEL and CLASS properties

Added support for relation, contact event, and identifier to the Android parser

Fixed photo, logo, and sound parsing causing crashes

September 18, 2023

v0.7.1

Fixed crash when parsing some generated VCards

September 18, 2023

v0.7.0

Added signing (strong name)

Added documentation

September 13, 2023

v0.5.1

Signed with the Aptivi signing key

August 12, 2023

v0.6.0.0

Added MeCard parsing support

Improved the VCard parsers

August 10, 2023

v0.5.0.0

Added support for 5 new variables

Improved the card parsing functionality

April 1, 2023

v0.4.0.0

First block of image, sound, or logo should align exactly to 74 characters

Reworked on type and argument value getters

Fixed crashes related to argument parsing

March 28, 2023

v0.3.0.0

Added saving cards to string

Added limited support for Android contacts database support

Added equality for cards

Added organization type

Improved argument parsing for VCard 4.0

Added AltArguments to the rest of the info classes

Improved VCard generation for Alt ID

General improvements

March 2, 2023

v0.2.0.0

Added VCard parsing by file, by stream, or by string

Fixed grammatical error on parse errors

Fixed titles not being parsed

Improved saving

February 20, 2023

v0.1.0.0

Added support for new card values (Timezone, geography, etc.)

Fixed parsing with separate contacts delimited by newlines

Extended ALTID support to more types

February 17, 2023

v0.1.0.0-alpha04

Re-targeted to .NET Standard 2.0

Fixed VCard and photo parsing

Fixed stuck file handle

August 18, 2022

v0.1.0.0-alpha03

Added more types (BDAY, REV, ...)

Improved ALTID parsing

August 17, 2022

v0.1.0.0-alpha02

Added photo

Reduced NuGet download size

June 27, 2022

v0.1.0.0-alpha01

The initial release of the library is now live!