Postybirb
About
PostyBirb is an application that helps artists post art and other multimedia to
multiple websites more quickly. The overall goal of PostyBirb is to cut down on
the time it takes to post submissions to multiple websites.
Features
PostyBirb supports a wide range of websites, see the full list here.
- 🌐 Submission templates – Configure default values for each website once, reuse across submissions.
- 🏷️ Tag groups – Save and apply multiple tags at once.
- 🔄 Tag converters – Automatically rewrite tags per website.
- 🔗 Username shortcuts – Tag people on socials easily.
- ♻️ Username converters – Automatically rewrite usernames per website.
- ⚡ Custom shortcuts – Create your own text snippets for descriptions.
- ✍️ Description formatting – Apply bold, italics, color, etc. PostyBirb converts formatting to match each website's capabilities.
- 🚀 Description preview – See how any of the features above with look with website specific formatting applied.
- 📐 Autoscaling – Scales images automatically.
- 📄 File & notification posts – Supports both media uploads and text‑only posts.
- 📅 Scheduling – Post at exact dates or repeating intervals. Login credentials stay on your device, and PostyBirb must be running for scheduled posts to go out - your credentials remain private and under your control.
- 🐳 Docker self‑host / remote – Advanced users can run PostyBirb on their own server with Docker. Scheduled posts work even when your main device is off, and you can access the same instance from multiple devices (e.g., start a draft on desktop, finish and schedule it from a laptop). Detailed documentation on remote, Docker, and headless setup
- 👁️ Directory watcher – Automatically creates a submission when a new file appears in a watched directory.
V4 Initiative
v4 sets out to be more flexible for adding new features and updates not easily
supported on v3. It also aims to be more contributor friendly and ease the
implementation of websites where possible.
Looking for v3 (PostyBirb+)?
You can find v3 here.
Translation
PostyBirb uses Weblate as transltion service
Learn more: Translation guide
Contributing
Please write clean code.
Follow conventional commits
Project Setup
- Ensure your NodeJS version is 24.6.0 or higher
- Clone project using git
- Ensure corepack is installed:
npm --global install corepack (This is tool used for managing package manager's versions)
corepack enable Makes NodeJS use the yarn version specific to the project (from package.json)yarn install Installs dependencies- If it fails with
➤ YN0009: │ better-sqlite3@npm:11.8.0 couldn't be built successfully:
winget install -e --id Microsoft.VisualStudio.2022.BuildTools --override "--passive --wait --add Microsoft.VisualStudio.Workload.VCTools;includeRecommended"
If you're on linux or other OS please create an issue with log from the unsucessfull build. It will have instructions on which packages are required and we will add them there. But generally it should work out of box if you have C++ compiler installed
yarn run setup Installs hooks/huskyyarn start Starts app
Common commands
- Run tests/format/lint:
yarn test/yarn format/yarn lint
- Build & Package app:
yarn dist
Native module mismatch after packaging
Running yarn dist (or any dist:* variant) calls electron-builder install-app-deps as part of the packaging step. This rebuilds native modules (e.g. better-sqlite3) for Electron's embedded Node.js, which has a different NODE_MODULE_VERSION than your system Node.
After packaging, if you run yarn test and get an error like:
The module '...better_sqlite3.node' was compiled against a different Node.js version using NODE_MODULE_VERSION 133. This version of Node.js requires NODE_MODULE_VERSION 137.
the fix is to reinstall dependencies, which restores the system-Node-compatible binary:
rm -rf node_modules && yarn install
This is expected behaviour — the packaging step intentionally overwrites the binary for Electron. Tests always need the system-Node binary, so a fresh install after packaging is required before running tests again.
Recommended Plugins (VSCode)
- Nx Console
- Jest Runner
- Prettier
Add website
To add a new website see this guide
Primary Modules (/apps)
Client-Server
The "Back end" of the application. This houses all website implementations, data models, user settings,
posting logic, etc.
Primary Technologies Used
Postybirb
The Electron part of the application that contains initialization logic and
app setup.
Primary Technologies Used
PostyBirb-UI
The user interface for the application that talks with Client-Server through
web-socket and https.
Primary Technologies Used
- React
- TipTap (Text editor)
- Mantine (UI Framework)
PostyBirb-Cloud-Server
Used for functions that are impossible to implement without having a dedicated server (e.g. hosting images for Instagram uploads)
