README проекта с github.com/brainstormity/LightPost. Одним файлом markdown: README.md.
A lightweight system to automate posting to all of your socials from one dashboard.
A lightweight, self-hosted social media scheduler. Connect your accounts, write a post, and publish now or schedule it for later—all from one dashboard.

One Python process, SQLite, and plain HTML/CSS/JavaScript. No external database, frontend bundler, or AI dependency. Node.js is only needed for development checks and formatting.
| Platform | Supported posts |
|---|---|
| Bluesky | Text and up to four images |
| Mastodon | Public text and up to four images |
| X (Twitter) | Text and up to four JPEG/PNG images; API cost confirmation before publishing or scheduling |
| One public JPEG with an optional caption; Creator/Business accounts | |
| Threads | Text or one public JPEG |
| Discord | Server webhook messages and up to four public images |
| Public personal-profile posts with text and up to four images | |
| Telegram | Public or private channel posts with text and up to four JPEG/PNG images |
| Facebook Pages | Page feed posts with text and up to four JPEG/PNG images |
| YouTube | One MP4 video with a title, optional description, visibility, audience and disclosure choices |
| TikTok | Under development |
| Under development | |
| Google Business Profile | Under development |
Images are limited to 1 MB each. Use Add Image to import a direct public HTTPS JPEG URL. Keep its URL available until delivery completes for Instagram, Threads, and Discord; your server can remain private. Platform-specific limits appear in the composer and Setup Guide. Video uploads are supported for YouTube only: one local MP4 up to 250 MB per post (H.264/AAC recommended). Create separate posts for YouTube videos and other platforms.
Bring your own authorized platform credentials. API fees, token expiry, permissions, and account eligibility still apply.
Requires Python 3.11+ on Linux or macOS.
git clone https://github.com/brainstormity/LightPost.git
cd LightPost
python3 -m venv .venv
.venv/bin/python -m pip install -r requirements.txt
.venv/bin/python -m lightpost
Open localhost:3000/app, connect an account, and create your first post. New workspaces start empty. Open Setup Guide in the sidebar for platform-specific setup.
Keep the app running for scheduled delivery. For automatic startup on Linux, an optional systemd service is provided in deploy/lightpost.service; it expects the app at /opt/lightpost, a lightpost system user, and a writable data/ directory.
No .env file is required for the default setup. To override settings, copy .env.example to .env. Environment variables take precedence.
| Setting | Default / purpose |
|---|---|
HOST, PORT |
127.0.0.1:3000 |
DATABASE_PATH |
data/lightpost.sqlite; media and the generated key live alongside it |
ADMIN_PASSWORD |
Optional locally; at least 16 characters required when binding beyond loopback |
ENCRYPTION_KEY |
Generated automatically if omitted; custom keys must be 64 hexadecimal characters |
COOKIE_SECURE |
false; enable when serving over HTTPS |
META_GRAPH_VERSION |
v25.0 for Instagram and Facebook Pages |
This is a single-owner application. Use a trusted network or HTTPS for remote access. Run one app process per database and keep SQLite on local storage.
For a full backup, stop the app and copy the entire data directory and .env together. Preserve the encryption key. Post-history exports omit credentials and image files, so they are not full backups. Credentials, databases, and keys are excluded from Git.
An interrupted delivery may need manual review if a platform accepted a post before the connection dropped. Check the destination before retrying; delivery across platforms is not atomic or guaranteed exactly once.
.venv/bin/python -m pip install -r requirements.txt ruff==0.14.2
npm ci
npm test
npm run build
npm run format
.venv/bin/python -m ruff check lightpost tests
Tests use temporary databases and mocked platform requests, never real social accounts. npm run build checks JavaScript syntax and runs frontend tests; there is no generated frontend to deploy. Run checks locally before pushing. No GitHub Actions workflows are included.
MIT. LightPost is an independent project and is not affiliated with Post Bridge or the supported platforms. The Instagram gradient glyph comes from Meta’s official logo pack. Additional logos come from TikTok’s developer asset pack, Pinterest’s brand resources, and Google Business Profile. Platform logos belong to their respective owners and are subject to their brand guidelines.