Social Media URIs

Adding social media info to cards

Even though we have the URL property in cards, we needed to automatically generate social media URIs from cards that contain a specific property, called X-VISUALCARD-SOCIAL.

You can use the property management functions on cards and/or calendars to add, edit, remove, or fetch social media apps using XNameInfo as the type. Once done, you can use the XNameInfo instance to get the social media URI.

Compatible social media apps

Applications using VisualCard can process the following compatible social media apps to be displayed in the contact info box inside such applications:

App name	Property value (abbreviation)	Property value (handle)
Facebook	FB	username
X/Twitter	TW	username
Mastodon	MD	[e-mail]
		fedi.verse;[e-mail]
Bluesky	BS	[e-mail]
YouTube	YT	@username
Odysee	OD	@username
Instagram	IG	username
Snapchat	SC	username
TikTok	TK	@username
WhatsApp	WA	phoneNumber
Telegram	TG	username

When generating URIs, the following is taken into account:

• Some social media apps, such as Facebook, X/Twitter, and Instagram, don't use the @ (at) symbol for handles in the URIs.

• Some social media apps, such as YouTube, Odysee, and TikTok, use the @ (at) symbol for handles in the URIs.

• You can optionally use the fediverse name, such as fosstodon.org, as the second argument directly after the MD type before the handle. If you omit the fediverse host name and just append your Mastodon handle, the fediverse host defaults to mastodon.social.

• So far, only WhatsApp uses the phone number to generate the URI.

You must use account handles in all cases. For example, if a person has a Mastodon account with the full name of "John Sanders", you'll have to get the handle, which is usually [e-mail].