Search by

bangnokia / postslop

bangnokia

Remote account client for Postslop: import browser sessions and manage social accounts

Package info

github.com/bangnokia/postslop

pkg:composer/bangnokia/postslop

Security

Advisories: 0

Aikido package health analysis

Transparency log

Statistics

Installs: 2

Dependents: 0

Suggesters: 0

Stars: 0

Open Issues: 0

v0.1.0 2026-10-27 17:43 UTC

Requires

Requires (Dev)

None

Suggests

None

Provides

None

Conflicts

None

Replaces

None

MIT d10798049e9481baff2c433f2ea860d73dbe929f

threadsclisocialpostslopraycast

Published on Packagist.org on 2026-10-27 18:44 UTC

This package is auto-updated.

Last update: 2026-11-04 08:17:12 UTC

README

Postslop: the free post scheduler for X, Bluesky, LinkedIn, Threads and dev-null.sh. No API keys.

Write once, post everywhere. Postslop is a free, open-source post scheduler for X, Bluesky, LinkedIn, Threads and dev-null.sh. It needs no API keys: it posts with the accounts you are already signed in to in your browser. Run it on your computer or on your own server.

Threads support is experimental, and publishing to it live has not been verified yet. See Threads.

Install

You need PHP 8.4+ with the fileinfo and gd extensions, Composer, and Node 22+. With those installed, setup takes about 5 minutes.

git clone https://github.com/bangnokia/postslop.git
cd postslop
composer deps            # install dependencies
composer setup           # create server/.env, private storage and the database
composer browser:setup   # the private browser Postslop uses to post to X
composer build           # build the web client

Setup

  1. Choose your access token. Open server/.env and replace change-me in POSTSLOP_TOKEN with a password of your own. The web client asks for it once. If you leave it empty, anyone who can reach Postslop can use it.

  2. Connect your accounts. Sign in to your sites in Chrome (macOS) or Firefox, then import them:

    composer accounts:import                        # from Chrome
composer accounts:import -- --browser=firefox   # or from Firefox

    Postslop asks which account is signed in on each site. On macOS, choose Allow when asked about "Chrome Safe Storage".

  3. Check them. composer accounts shows which accounts are ready.

Getting started

composer start

Open http://127.0.0.1:8087 and enter your access token. Press C to write a post, pick the sites and add images or a video, then publish it now, schedule it, or save it as a draft. Scheduled posts go out while Postslop is running; composer stop stops it.

  • Raycast (macOS): write and publish without leaving Raycast. Install it with composer raycast:install and composer raycast:dev. See the Raycast guide.
  • AI agents: connect an MCP client to https://YOUR_SERVER/api/v1/mcp with your access token. Agents save drafts by default; scheduling and publishing are separate, explicit steps. See MCP and the agent guide.
  • Postslop on a server: install it there the same way and put HTTPS in front of it. Then send your accounts from the computer with your browser, without a checkout: with cpx and PHP 8.2+, set POSTSLOP_REMOTE_TOKEN to the server's access token and run cpx bangnokia/postslop setup --to=https://YOUR_SERVER. See the remote account client.

Documentation

License

MIT