Metadata-Version: 2.4
Name: mdsend
Version: 0.2.0
Summary: File-based social media publisher. Write markdown, post to LinkedIn, Bluesky, and Mastodon.
Author: Vlad Shurupov
License: BSD-3-Clause
Project-URL: Homepage, https://github.com/algodesigner/mdsend
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: BSD License
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: requests
Requires-Dist: python-dotenv
Requires-Dist: atproto
Requires-Dist: Pillow
Requires-Dist: Mastodon.py
Dynamic: license-file

# mdsend — File-based social media publisher

![mdsend](msend-image.jpeg)

Write markdown posts, run `mdsend`, and it cross-posts to your social media platforms.

The main purpose is simple: set up a git repo with a simple directory structure and publish from it to various destinations. Your posts are in a single unified format that works across different social media platforms. You get a version-controlled archive that can be queried and managed by AI should the need arise.

Want to know what you've been focusing on, what your next posts should be, how to improve your writing, or which tags to use? Just ask your AI tool — it can read the repo and answer and provide you with a perspective.

This approach keeps you disconnected from the destination network so you don't get pulled into everyone else's feeds.

## Supported platforms

| Platform        | Max chars | Max media | API auth            |
|-----------------|-----------|-----------|---------------------|
| LinkedIn        | 3,000     | 1 image   | OAuth 2.0 (Bearer)  |
| Bluesky         | 300       | 4 images  | AT Protocol (App Password) |
| Mastodon        | 500       | 4 images  | OAuth (Access Token) |

## How it works

Each post is a directory named `YYYY-MM-DD_HH-MM_slug/` containing:

- `post.md` — the post text (markdown or plain text)
- Optional media files (jpg, png, gif, mp4, mov)

```
posts/
├── 2026-05-03_15-30_my-thoughts/
│   ├── post.md
│   └── image.jpg
└── 2026-05-04_18-00_hello-world/
    └── post.md
```

## Per-post platform targeting

By default every post goes to all platforms.  To control this per post,
add an optional front matter block at the top of `post.md`:

```
---
platforms: [bluesky]
---

This post will only appear on Bluesky.
```

```
---
platforms: []
---

This post is a draft — it will never be published.
```

## Installation

```bash
pip install mdsend
```

Or from source:

```bash
git clone https://github.com/algodesigner/mdsend
cd mdsend
pip install -e .
```

## Setup

Create a `.env` file with your API credentials:

```bash
cp .env.example .env
```

Fill in the credentials for the platforms you want to use.  See `.env.example`
for the full list of required fields.

## Usage

```bash
# Preview what would be posted (default — no API calls made)
cd /path/to/your/posts
mdsend

# Actually post live
mdsend --publish

# Post to specific platforms
mdsend --platforms bluesky
mdsend --platforms bluesky --publish
```

### Creating a new post

```bash
# Create a post directory and open the editor
mdsend --new "my-post-slug"
```

This creates a directory like `2026-05-04_21-30_my-post-slug/` with
a `post.md` file containing a front matter template, then opens it in
your `$EDITOR` (or `vi` by default).

### Dry run

`mdsend` runs in dry-run mode by default — it prints what would be posted
without calling any API.  Use `--publish` to post live.

### Multi-post threading (Bluesky)

Posts longer than 300 characters are automatically split into a threaded
thread on Bluesky.  Each chunk is prefixed with `🧵 (n/N) ` so readers
know it's part of a multi-part post.

### Idempotent publishing

Each platform gets its own sentinel file under `posts/.published/`.
Re-running is safe — already-published platforms are skipped.

## License

BSD 3-Clause. See LICENSE.

Happy microblogging! ☕
