|
1 | | -<h1 align="center"> |
2 | | - <img |
3 | | - alt="Patchwork icon" |
4 | | - src="https://github.com/ssbc/patchwork/blob/0465f406357cec9cdb8d821f68758d7ab8ef41cf/assets/icon.png" |
5 | | - width="256" |
6 | | - height="256" |
7 | | - /> |
8 | | - <br /> |
9 | | - Patchwork |
10 | | -</h1> |
| 1 | +# Patchwork |
11 | 2 |
|
12 | | -<h4 align="center"> |
13 | | - A decentralized messaging and sharing app built on top of Secure Scuttlebutt (SSB). |
14 | | -</h4> |
| 3 | +> A decentralized messaging and sharing app built on top of Secure Scuttlebutt (SSB). |
15 | 4 |
|
16 | | - |
| 5 | +- Connect with friends without depending on any central servers. |
| 6 | +- Don't worry about spam, you only get messages from people you follow. |
| 7 | +- Use Patchwork online or offline, the data you need is stored on your device. |
| 8 | +- Sync messages with friends when you're on the same Wi-Fi network. |
| 9 | +- Keep secrets with private messages, which are *always* end-to-end encrypted. |
| 10 | +- Change and improve Patchwork however you'd like, it's free and open source. |
17 | 11 |
|
18 | | -<details> |
19 | | - <summary>Table of Contents</summary> |
20 | | - <li><a href="#features">Features</a></li> |
21 | | - <li><a href="#pubs">Pubs</a></li> |
22 | | - <li><a href="#install">Install</a></li> |
23 | | - <li><a href="#docs">Docs</a></li> |
24 | | -</details> |
| 12 | +## Usage |
25 | 13 |
|
26 | | -## Features |
| 14 | +![Screenshot of Patchwork][screenshot] |
27 | 15 |
|
28 | | -It's better than email because: |
| 16 | +New to Scuttlebutt? Join the network by connecting to a [pub][pub]. |
29 | 17 |
|
30 | | - - Private messages are end-to-end encrypted, always. |
31 | | - - You have to follow somebody to get messages from them, so you won't get spammed. |
32 | | - - Your mail can be public broadcasts or private, and you'll only see replies by people you follow. |
33 | | - - The datastructure is a global mesh of append-only logs, which can support new types of data (not just "mail"). |
34 | | - - Users are not bound to one server/host (what we call "Pubs") and do not have to trust the servers. |
35 | | - - It's very easy to setup and maintain your own Pub. |
| 18 | +1. Choose a pub from the [pub list][pub-list] and copy an invite code. |
| 19 | +2. Open Patchwork and select *Join Pub*. |
| 20 | +3. Paste the invite code and select *Redeem Invite*. |
36 | 21 |
|
37 | | -It's better than Twitter and Facebook because: |
| 22 | +You're done! Check out `#new-people` to see who else has recently joined. |
38 | 23 |
|
39 | | - - Private messages are end-to-end encrypted, always. |
40 | | - - The software runs on your device, so there's nobody tracking your browsing. |
41 | | - - The application code is FOSS, so you're free to fork or write new applications without a gatekeeper setting terms. |
42 | | - - Data is saved to your disk, and so the application works offline. |
43 | | - - You can sync directly with friends over Wi-Fi. |
| 24 | +## Installation |
44 | 25 |
|
45 | | -## Pubs |
| 26 | +Most people should **[download Patchwork for Windows, macOS, or Linux][gh-dl]**. |
46 | 27 |
|
47 | | -In order to gossip outside your local network, you'll need to connect to a [Pub](https://www.scuttlebutt.nz/concepts/pub.html). |
| 28 | +Alternatively, you can install Patchwork with your favorite package manager. |
48 | 29 |
|
49 | | -You can find an invite to an available pub at the [Pub servers registry](https://github.com/ssbc/ssb-server/wiki/Pub-Servers). |
| 30 | +- **[npm][npm]:** `npm install --global ssb-patchwork` |
| 31 | +- **[yarn][yarn]:** `yarn global add ssb-patchwork` |
| 32 | +- **[yay][yay]:** `yay -S ssb-patchwork` |
50 | 33 |
|
51 | | -Get an invite, then in `patchwork`: click "+ Join Pub" and paste the invite code. |
52 | | - |
53 | | -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. |
54 | | - |
55 | | -## Install |
56 | | - |
57 | | -### Download installers for Windows, macOS and Linux |
58 | | - |
59 | | -See [patchwork/releases](https://github.com/ssbc/patchwork/releases) |
60 | | - |
61 | | -### Or build from source |
62 | | - |
63 | | -With node (>= 4) and npm (>= 3) installed: |
64 | | - |
65 | | -```shell |
66 | | -$ git clone https://github.com/ssbc/patchwork |
67 | | -$ cd patchwork |
68 | | -$ npm install |
69 | | -$ npm start |
70 | | -``` |
71 | | - |
72 | | -You'll need some more dependencies to build. |
73 | | - |
74 | | -On Debian Linux: |
75 | | - |
76 | | -```shell |
77 | | -sudo apt-get install g++ m4 libtool automake libgconf-2-4 # build tools |
78 | | -sudo apt-get install libxext-dev libxtst-dev libxkbfile-dev # spellchecker headers |
79 | | -``` |
80 | | - |
81 | | -On Fedora Linux: |
82 | | - |
83 | | -```shell |
84 | | -sudo dnf install libXext-devel libXtst-devel libxkbfile-devel gcc-c++ m4 automake libtool |
85 | | -``` |
86 | | - |
87 | | -On macOS: |
88 | | - |
89 | | -```shell |
90 | | -brew install libtool automake # build tools |
91 | | -``` |
92 | | - |
93 | | -## Code of conduct |
94 | | - |
95 | | -Please note that this project is released with a [Contributor Code of Conduct](code-of-conduct.md). By participating in this project you agree to abide by its terms. |
| 34 | +Building from source? Check out [`INSTALL.md`][install] for more information. |
96 | 35 |
|
97 | 36 | ## Contributing |
98 | 37 |
|
99 | | -Please read the [Patchwork Contribution Guidelines](contributing.md) before opening a pull request. |
100 | | - |
101 | | -## Docs |
102 | | - |
103 | | -- [scuttlebutt.nz](https://www.scuttlebutt.nz) |
| 38 | +Create a [new issue][new-issue] to report problems or request features. See |
| 39 | +[`CONTRIBUTING.md`][contributing] for more information on how to get involved. |
| 40 | + |
| 41 | +Please note that this project is released with a [Contributor Code of |
| 42 | +Conduct][conduct]. By participating in this project you agree to abide by its |
| 43 | +terms. |
| 44 | + |
| 45 | +## See Also |
| 46 | + |
| 47 | +- [patchbay][patchbay] |
| 48 | +- [ssb-server][ssb-server] |
| 49 | +- [manyverse][manyverse] |
| 50 | + |
| 51 | +## License |
| 52 | + |
| 53 | +[AGPL-3.0][license] |
| 54 | + |
| 55 | +[conduct]: docs/CODE_OF_CONDUCT.md |
| 56 | +[contributing]: docs/CONTRIBUTING.md |
| 57 | +[gh-dl]: https://github.com/ssbc/patchwork/releases/latest |
| 58 | +[install]: docs/INSTALL.md |
| 59 | +[license]: LICENSE |
| 60 | +[manyverse]: https://gitlab.com/staltz/manyverse |
| 61 | +[new-issue]: https://github.com/fraction/readme-boilerplate/issues/new |
| 62 | +[npm]: https://npmjs.org/ |
| 63 | +[patchbay]: https://github.com/ssbc/patchbay |
| 64 | +[pub-list]: https://github.com/ssbc/ssb-server/wiki/Pub-Servers |
| 65 | +[pub]: https://www.scuttlebutt.nz/concepts/pub.html |
| 66 | +[screenshot]: assets/screenshot.jpg |
| 67 | +[ssb-server]: https://github.com/ssbc/ssb-server |
| 68 | +[yarn]: https://yarnpkg.com/en/ |
| 69 | +[yay]: https://github.com/Jguer/yay |
0 commit comments