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.
Как его запустить?Запустите его с Python 3.11+ на Linux или macOS, затем откройте localhost:3000/app, подключите аккаунт и создайте свой первый пост.
Нужен ли отдельный сервер базы данных или Node.js, чтобы это запустить?Нет, внешняя база данных, сборщик фронтенда или зависимость от ИИ не требуются; Node.js нужен только для проверок при разработке и форматирования кода, а не для работы приложения.
Работает ли это сейчас на всех платформах и со всеми типами медиа?Поддержка TikTok, Pinterest и Google Business Profile ещё в разработке, видео не поддерживаются вовсе, а доставка на разные платформы не выполняется как единое целое и не гарантирует публикацию ровно один раз.
Можно ли запустить это на Windows?Пока нет: в README в качестве требований указаны только Python 3.11+ на Linux или macOS.
Кто может увидеть мои учётные данные и данные постов?Всё хранится на вашем собственном сервере: учётные данные зашифрованы, можно добавить необязательную защиту паролем, а экспорт истории постов не включает учётные данные и файлы изображений.
В какие социальные сети я уже могу публиковать посты?Сейчас поддерживаются Bluesky, Mastodon, X/Twitter, Instagram, Threads, Discord, LinkedIn, Telegram и Facebook Pages; у каждой есть свои ограничения по изображениям и тексту, которые показаны в редакторе.
Нужно ли проходить вход через OAuth, чтобы подключить аккаунты?Встроенного потока согласия OAuth нет; вы используете собственные учётные данные платформы, полученные напрямую в каждом сервисе, и вводите их сами.
Как сделать резервную копию данных?Остановите приложение и скопируйте всю папку с данными вместе с файлом .env, обязательно сохранив ключ шифрования, так как одного только экспорта истории постов недостаточно для полной резервной копии.
Можно ли подключить несколько аккаунтов одной платформы?Да, LightPost поддерживает публикацию в несколько аккаунтов, в том числе в несколько аккаунтов одной платформы, и может публиковать в них одновременно.
Автор
brainstormity
Размер
12.1 MB
Звёзды
376
Обновлён
КоммитOct 31
Возраст
21 д
Коммиты · 90 дней