presence

Presence

Star Fork Watch Issue Discuss

Presence is a set of .NET libraries, command line tools, and GitHub Actions to formatting and share content as threads to social networks.

You can:

• Format threads for multiple social networks, from a single source
• Post threads, messages, and images to multiple social networks

Just want to use the GitHub Actions?

• Format and post a thread with GitHub Actions
• How to prepare content (in a markdown-like format)
• Network specific configuration

Just want to use the CLI tools?

• How to install the CLI tools
• How to prepare content (in a markdown-like format)
• How to post to social networks
• Network specific configuration

Network support

Network	Notes	Thread composition	Thread posting	Image posting
Console	Used for testing	✅	✅	✔️
AT	AT networks, eg. BlueSky	✅	✅	✅
SlackWebhook	Simple Slack posting	✅	⏳	⏳

⏳ Clarifications...

• The Console network does not really post images.
  • It indicates the source of the image that would have been posted. This is the intended behaviour.
• SlackWebhook does not yet support posting of threads.
  • In practice this is almost irrelevant - Slack permits posts of up to 40,000 characters, which is significantly larger than many other social networks. If a post exceeds this limit, it will be continued in a subsequent top-level post.
  • The intended behavior, however, is to send subsequent posts as replies to the original message.
• SlackWebhook permits posting images by URL, but does not support upload of local images.
  • Images that cannot be included in a post to slack will result in a warning.
  • A good solution for this will need a little investigation.

Status

NB. This project is currently under development. Libraries are not production-ready yet.

Artefact	Type	Location	Status
Latest source	GitHub workflow	Latest build and test
CLI binaries	Homebrew tap	presence-cli formula
CLI binaries	GitHub release	Latest release
Formatting library	Nuget package	Presence.SocialFormat.Lib
Posting library	Nuget package	Presence.Posting.Lib

All documentation

GitHub Actions

• Format and post a thread with GitHub Actions

CLI tools

• Install the Presence CLI tools
• Using Presence.SocialFormat.Console
• Using Presence.Posting.Console

.NET library and user guides

• Install packages from Nuget
• Create a thread with Presence.SocialFormat.Lib
• Create posts with images
• Create threads with markdown
• Post to a social network with Presence.Posting.Lib

Configuration

• Network specific constraints
• Network specific configuration
  • Set up a Console network
  • Set up an AT network
  • Set up a Slack network

Developer notes

• Presence project
• Contributing guidelines
• Package versioning
• Testing

Source code

All code in this project is distributed under the MIT license. Source code is available at: instantiator/presence

Project	Purpose	Project README
Presence.SocialFormat.Lib	A library for composing threads, formatted to the requirements of social networks.	README
Presence.SocialFormat.Tests	Unit tests for the composition and formatting library.	README
Presence.SocialFormat.Console	A command line tool to reformat messages for social networks.	README
Presence.Posting.Lib	A library for posting to social networks.	README
Presence.Posting.Tests	Unit and integration tests for the posting library.	README
Presence.Posting.Console	A command line tool to post formatted threads to social networks.	README

Dependencies for each project are listed in each project’s README.

Acknowledgements

• Post / envelope icon from icons8.com
• Huge thanks to Gérald Barré (meziantou) for this excellent article: Publishing a Nuget Package

This site is open source. Improve this page.