Skip to content
A decentralized messaging and sharing app built on top of Secure Scuttlebutt (SSB).
Branch: master
Clone or download
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github Use default SSBC stale settings Apr 18, 2019
.vscode some wee fixes Dec 3, 2018
assets
build Use electron-builder on Travis CI Apr 17, 2019
lib Merge branch 'master' of github.com:ssbc/patchwork into extract_sugge… Apr 18, 2019
locales Merge branch 'master' of github.com:ssbc/patchwork into read-only-mode Apr 11, 2019
modules Switch to ssb-suggest for mentions Apr 18, 2019
sbot Resolve issue with untyped private message throwing error Apr 25, 2019
scripts check-locales: include full missing translation Oct 28, 2017
styles fix light styles for profile options (private block, etc) Dec 18, 2018
.dockerignore Use electron-builder on Travis CI Apr 17, 2019
.gitignore Use electron-builder on Travis CI Apr 17, 2019
.travis.yml Unset TRAVIS_CMD environment variable causing problems for CI build Apr 17, 2019
LICENSE change to AGPL-3.0 license (#558) Jun 19, 2017
README.md scuttlebot -> ssb-server Dec 19, 2018
code-of-conduct.md
contributing.md Add info about changing logging levels Jan 13, 2019
index.js Merge branch 'electron-4' of https://github.com/nornagon/patchwork in… Apr 25, 2019
main-window.js Merge branch 'master' of github.com:ssbc/patchwork into support-ssb-uri Mar 12, 2019
package-lock.json Merge branch 'electron-4' of https://github.com/nornagon/patchwork in… Apr 25, 2019
package.json Merge branch 'electron-4' of https://github.com/nornagon/patchwork in… Apr 25, 2019
screenshot.jpg update screenshot Dec 17, 2017
server-process.js Upgrade ssb-server from v13 to v14 Mar 27, 2019

README.md

Patchwork icon
Patchwork

A decentralized messaging and sharing app built on top of Secure Scuttlebutt (SSB).

Patchwork screenshot

Table of Contents
  • Features
  • Pubs
  • Install
  • Docs
  • Features

    It's better than email because:

    • Private messages are end-to-end encrypted, always.
    • You have to follow somebody to get messages from them, so you won't get spammed.
    • Your mail can be public broadcasts or private, and you'll only see replies by people you follow.
    • The datastructure is a global mesh of append-only logs, which can support new types of data (not just "mail").
    • Users are not bound to one server/host (what we call "Pubs") and do not have to trust the servers.
    • It's very easy to setup and maintain your own Pub.

    It's better than Twitter and Facebook because:

    • Private messages are end-to-end encrypted, always.
    • The software runs on your device, so there's nobody tracking your browsing.
    • The application code is FOSS, so you're free to fork or write new applications without a gatekeeper setting terms.
    • Data is saved to your disk, and so the application works offline.
    • You can sync directly with friends over Wi-Fi.

    Pubs

    In order to gossip outside your local network, you'll need to connect to a Pub.

    You can find an invite to an available pub at the Pub servers registry.

    Get an invite, then in patchwork: click "+ Join Pub" and paste the invite code.

    This will cause you to follow the Pub and vice versa. If you haven't synchronized to this social network yet, prepare to wait a few minutes while your local server synchronizes.

    Install

    Download installers for Windows, macOS and Linux

    See patchwork/releases

    Or build from source

    With node (>= 4) and npm (>= 3) installed:

    $ git clone https://github.com/ssbc/patchwork
    $ cd patchwork
    $ npm install
    $ npm start

    You'll need some more dependencies to build.

    On Debian Linux:

    sudo apt-get install g++ m4 libtool automake libgconf-2-4   # build tools
    sudo apt-get install libxext-dev libxtst-dev libxkbfile-dev # spellchecker headers

    On Fedora Linux:

    sudo dnf install libXext-devel libXtst-devel libxkbfile-devel gcc-c++ m4 automake libtool

    On macOS:

    brew install libtool automake # build tools

    Code of conduct

    Please note that this project is released with a Contributor Code of Conduct. By participating in this project you agree to abide by its terms.

    Contributing

    Please read the Patchwork Contribution Guidelines before opening a pull request.

    Docs

    You can’t perform that action at this time.