LightPost README

项目的 README,来自 github.com/brainstormity/LightPost。合并为一个 markdown 文件:README.md。

LightPost

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.

LightPost landing page with its publishing headline and social platform logos

Features

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.

Supported platforms

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
Instagram 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
LinkedIn 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
Pinterest 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.

Run locally or on your server

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.

Configuration and backups

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.

Development

.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.

License

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.

LightPost (brainstormity/LightPost)

正在搜索数据库…

这是什么?LightPost 是一个自托管的控制面板,可以在一处为多个社交媒体账号安排和发布帖子。
这是桌面应用,还是要在浏览器里打开的网页?它以单个 Python 进程运行,内置 SQLite 数据库。使用时,在浏览器中打开 localhost:3000/app 这个网页即可。
怎么让它运行起来?在 Linux 或 macOS 上用 Python 3.11+ 运行它,然后打开 localhost:3000/app,连接账号,并创建你的第一条帖子。
运行它需要单独的数据库服务器或 Node.js 吗?不需要。无需外部数据库、前端打包工具或 AI 依赖;Node.js 仅用于开发时的检查和格式化,运行应用本身不需要它。
现在是否支持所有平台和媒体类型?TikTok、Pinterest 和 Google Business Profile 仍在开发中,完全不支持视频,并且跨平台发布不是原子操作,也不保证恰好送达一次。
我能在 Windows 上运行吗?目前不行;README 只列出了 Linux 或 macOS 上的 Python 3.11+ 作为运行要求。
谁能看到我的凭据和发布数据?所有数据都保存在你自己的服务器上:凭据已加密,你可以选择添加密码保护,导出的发布历史不包含凭据和图片文件。
我现在到底能在哪些社交网络上发帖?目前支持 Bluesky、Mastodon、X/Twitter、Instagram、Threads、Discord、LinkedIn、Telegram 和 Facebook Pages,每个平台的图片和文字限制都会显示在编辑器中。
连接账号需要走 OAuth 登录流程吗?不需要。项目不包含内置的 OAuth 授权流程;你需要自行从各平台直接获取凭据,并手动填入。
如何备份数据?先停止应用,然后将整个数据目录和 .env 文件一起复制,并确保保留加密密钥;仅导出的发布历史不是完整备份。
同一平台能连接多个账号吗?可以。LightPost 支持多账号发布,包括同一平台上的多个账号,并可同时向它们发布。
大小
12.1 MB
星标
376
更新
提交Oct 31
时长
21天
提交 · 90 天