You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
This is a new client for [Secure Scuttlebutt](http://scuttlebutt.nz) packaged as a Web Extension. This is a new client for [Secure Scuttlebutt](http://scuttlebutt.nz) packaged as a Web Extension for Firefox. It is available on:
*[Firefox Developer Edition](https://www.mozilla.org/en-US/firefox/developer/) or [Firefox Nightly](https://www.mozilla.org/en-US/firefox/nightly/) (needed so that you can sideload unsigned add-ons)
12
+
*[Scuttle Shell](https://github.com/ssbc/scuttle-shell). This is a soft requirement. You can use your own _sbot_ or even have another client such as [Patchwork](http://github.com/ssbc/patchwork) or [Patchbay](http://github.com/ssbc/patchbay) running and providing a running _sbot_.
11
13
12
-
Head over to the [Patchfox website](https://patchfox.org) for the documentation.
13
-
14
-
## Requirements for development
15
-
16
-
*[NodeJS](https://nodejs.org)
17
14
18
15
## Setup & Building
19
16
20
-
Patchfox uses [Mithril](https://mithril.js.org), [Electron](https://electronjs.org) and requires [NodeJS](https://nodejs.org) for development. After you have NodeJS installed, you can install the dependencies with:
17
+
Patchfox uses [Svelte](https://svelte.technology) and requires [NodeJS](https://nodejs.org) for development. After you have NodeJS installed, you can install the dependencies with:
21
18
22
19
```
23
20
$ npm install
24
21
```
25
22
26
-
And run a development version of the app using:
23
+
And build the add-on with:
27
24
28
25
```
29
-
$ npm run start
26
+
$ npm run clean-build
30
27
```
31
28
32
-
To build use:
29
+
If you use:
33
30
34
31
```
35
-
$ npm run build
32
+
$ npm run clean-dev
36
33
```
37
34
35
+
It will build the add-on using sourcemaps which makes debugging easier but can't be submit to AMO because they limit bundles to 4mb.
36
+
37
+
## Running
38
+
39
+
Go to [about:debugging](about:debugging) on Firefox, select `this firefox` and click to add a temporary add-on. Select the `manifest.json` file from the `dist/` folder from this repository.
38
40
39
41
## Setup inside Patchfox
40
42
41
-
Patchfox will use your default SSB data folder if available (the `.ssb` folder inside your home folder). If this is your first time using SSB, Patchfox will create that folder for you and place new keys inside.
43
+
Once patchfox is running, it needs to learn your _remote_ and _secret_, you can just click the "browse" button on the setup screen and select your `.ssb/secret` file. Patchfox will use the data inside your secret file to derive your remote address. Remember to click save.
44
+
45
+
After saving Patchfox will then try loading your public feed. You need to have a running _sbot_ for it to work.
42
46
43
47
# Testing the protocol schemas
44
48
@@ -50,6 +54,9 @@ After installing and configuring patchfox, try browsing to:
50
54
51
55
If you're interested in learning more about the technologies behind this add-on, check out:
52
56
57
+
*[MDN Web Docs - WebExtensions](https://developer.mozilla.org/en-US/Add-ons/WebExtensions/).
@@ -62,9 +69,9 @@ Don't hesitate to reach out to me at:
62
69
63
70
Do you want a decentralized internet too? Are you worried about the loss of net neutrality and realized that radical decentralization is the way to fight back? If you want to make a financial contribution to help me fund development of this and other dex focused software, I would love to receive contributions through these channels:
64
71
65
-
*[Buy Me A Coffee (preferred)](https://ko-fi.com/andreshouldbewriting)
66
72
*[Patchfox Open Collective](https://opencollective.com/patchfox)
67
73
74
+
68
75
# Artwork attribution
69
76
70
77
Patchfox is using artwork by many artists including:
@@ -75,6 +82,12 @@ Patchfox is using artwork by many artists including:
75
82
76
83
* Artwork for the 2020.2.1 release poster was done by: Photo by Krista Stucchio on Unsplash
More like _small trail guide_ than an actual _roadmap_. This document is used to hold stuff that I want to check out for the next version. I have ideas for Patchfox during my daily life, and if I don't write it down, I forget them and they're never implemented or fixed.
4
+
5
+
- Books
6
+
- Bug: `images` might be an `Object` instead of an `Array`. The _details view_ already take that into account but the _list view_ doesn't.
7
+
- Feature: add support for comments to books and reviews.
8
+
- Feature: check if importer from goodreads and the storygraph is possible.
9
+
- Calendar
10
+
- Bug: missing gatherings on _future events_ feature. I guess it is a bug with the validator.
11
+
- Chess
12
+
- Investigate if it is possible to use ssb-chess or even that mithril based client, without using ssb-chess-db.
13
+
- Inbox
14
+
- Create new inbox app to deal with private messages.
15
+
- Documentation
16
+
- Document keyboard shortcuts.
17
+
- Add small user guide.
18
+
- Settings
19
+
- Refactor the _filtering by message type_. Remove the reliance on _core message types_ and instead reuse the info from the package system to extrapolate messages. This is a major refactors, it affects both `ssb.js` and the settings package.
20
+
- General
21
+
- History management has a quirk where going to a package sometimes enter the data twice into history, or going back doesn't actually go back but reloads the same package. This has been a tricky bug since the start of Patchfox. Symptom is requiring you to click back multiple times before you're actually on the previous package/view combo. Might need a major refactoring.
22
+
- Add support for the new `ssb-uri` from Staltz.
23
+
- Licenses report
24
+
- Decide between "license-checker" and "license-report".
25
+
- Use one of them to generate a license report for all direct dependencies, and add them to the documentation.
0 commit comments